e-tax▌
kazukinagata/shinkoku · updated Apr 8, 2026
MDX-style export adds YAML metadata + attribution linking explainx.ai and this canonical listing URL.
shinkoku で計算した確定申告データを、確定申告書等作成コーナー（https://www.keisan.nta.go.jp/）に
- ›Claude in Chrome を使ってブラウザ上で入力・提出するためのスキル。
e-Tax 電子申告 — ブラウザ自動化による確定申告書等作成コーナー入力
shinkoku で計算した確定申告データを、確定申告書等作成コーナー（https://www.keisan.nta.go.jp/）に Claude in Chrome を使ってブラウザ上で入力・提出するためのスキル。
前提条件
/income-taxスキルで所得税の計算が完了していること/settlementスキルで決算書（PL/BS）の作成が完了していること/consumption-taxスキルで消費税の計算が完了していること（該当者のみ）shinkoku.config.yamlが設定済みであること- ブラウザ自動化ツールがいずれか利用可能であること（下記「ブラウザ自動化方式の選択」参照）
ブラウザ自動化方式の選択
確定申告書等作成コーナーへの入力には、以下の3つの方式がある。
方式 A: Claude in Chrome（推奨）
| 項目 | 内容 |
|---|---|
| 対象環境 | Windows / macOS のネイティブ Chrome |
| 前提 | Claude in Chrome 拡張機能がインストール済み |
| 利点 | OS 検出の問題なし。追加設定不要 |
方式 B: Antigravity Browser Sub-Agent
| 項目 | 内容 |
|---|---|
| 対象環境 | Windows / macOS / Linux（Antigravity IDE） |
| 前提 | Antigravity IDE がインストール済みで browser_subagent ツールが利用可能 |
| 利点 | ネイティブ Chrome を使用するため OS 偽装不要。Linux でも動作 |
方式 C: Playwright CLI（フォールバック）
| 項目 | 内容 |
|---|---|
| 対象環境 | WSL / Linux、または Claude in Chrome・Antigravity が利用できない環境 |
| 前提 | @playwright/cli + Playwright CLI スキル + etax-stealth.js（OS 偽装スクリプト） |
| 制限 | headed モード必須（QR コード認証に物理操作が必要） |
判定ロジック
1. Claude in Chrome のツール（browser_navigate 等）が利用可能か？
→ はい: 方式 A を使用
→ いいえ: 次へ
2. Antigravity の browser_subagent ツールが利用可能か？
→ はい: 方式 B を使用
→ いいえ: 次へ
3. Bash ツールで `playwright-cli` コマンドが利用可能か？
→ はい: 方式 C を使用（headed モードで起動）
→ いいえ: エラー表示
エラーメッセージ:
「確定申告書等作成コーナーへの入力には、Claude in Chrome、
Antigravity Browser Sub-Agent、または Playwright CLI が必要です。
セットアップ方法は README.md の『ブラウザ自動化』セクションを参照してください。」
方式 B 使用時の操作方法
Antigravity の browser_subagent は高レベルなタスク記述で操作する。
各ステップの入力操作を自然言語で記述し、browser_subagent に委任する。
例:
- 「https://www.keisan.nta.go.jp/kyoutu/ky/sm/top_web#bsctrl を開く」
- 「『マイナンバーカードをお持ちですか』で『はい』のラジオボタンをクリック」
- 「name='sonekiKeisansyoFromMonth' の入力欄に '1' を入力」
※ Antigravity はネイティブ Chrome を使用するため、etax-stealth.js による OS 偽装は不要。
方式 C 使用時のセッション開始手順
Playwright CLI でブラウザを開く際の手順:
- 環境変数を設定:
PLAYWRIGHT_MCP_INIT_SCRIPT=skills/e-tax/scripts/etax-stealth.js - ブラウザ起動:
playwright-cli -s=etax open <url> --headed --browser=chrome - 以降のコマンドは
-s=etaxセッション指定で実行
設定の読み込み（最初に実行）
shinkoku.config.yamlを Read ツールで読み込む- ファイルが存在しない場合は
/setupスキルの実行を案内して終了する - 設定値を把握する:
- 納税者プロファイル（氏名・住所・マイナンバー等）
- 事業情報（屋号・業種等）
- 申告方法（e-Tax/郵送/窓口）
進捗情報の読み込み
.shinkoku/progress/progress-summary.mdを Read ツールで読み込む（存在する場合）- 以下の引継書を Read ツールで読み込む（存在する場合）:
.shinkoku/progress/06-settlement.md— 決算結果（PL/BS データ）.shinkoku/progress/07-income-tax.md— 所得税計算結果.shinkoku/progress/08-consumption-tax.md— 消費税計算結果.shinkoku/progress/02-assess.md— 課税判定結果
.shinkoku/progress/10-etax.mdのstatusを確認する:status: interruptedの場合 → 下記「中断・再開プロトコル」の 再開手順 に従うstatus: completedの場合 → ユーザーに完了済みである旨を伝え、再実行の意図を確認する
- 計算結果がまだ存在しない場合は、先に
/income-taxや/settlementの実行を案内する
中断・再開プロトコル
全ステップ共通のルール。ユーザーが中断を要求した場合（「中断したい」「今日はここまで」「また続きから」等）、以下の手順に従う。
中断手順
- 現在のステップの入力内容を確認する — 未保存の入力がないか確認
- .data ファイルのダウンロードを案内する — AskUserQuestion で以下を表示:
作成コーナーの入力データを .data ファイルとして保存することを推奨します。
画面上部の「入力データの一時保存」ボタン（またはページ下部の「ここまでの入力データを保存する」リンク）
をクリックし、ファイルをダウンロードしてください。
ダウンロードが完了したら「ダウンロード済み」を選択してください。
- 選択肢: 「ダウンロード済み」 / 「スキップ（保存しない）」
- 「スキップ」が選ばれた場合は、次回は最初からやり直しになる可能性がある旨を警告する
- 進捗ファイルを記録する —
.shinkoku/progress/10-etax.mdに以下の形式で Write ツールで出力:
---
step: 10
skill: e-tax
status: interrupted
last_completed_step: "{最後に完了したステップ番号（例: 3）}"
last_url: "{中断時のブラウザURL}"
data_file_saved: {true/false}
interrupted_at: "{当日日付 YYYY-MM-DD}"
fiscal_year: {tax_year}
---
# e-Tax 電子申告（中断）
## 中断時点の状況
- 最後に完了したステップ: ステップ{N}
- 中断時のURL: {URL}
- .data ファイル保存: {済/未}
## 次回の再開方法
1. `/e-tax` スキルを再実行する
2. .data ファイルがある場合は「保存データを利用して作成」から再開する
3. .data ファイルがない場合はステップ0からやり直す
- ユーザーに中断完了を報告 — 次回の再開方法を案内して終了する
再開手順
.shinkoku/progress/10-etax.md で status: interrupted を検出した場合:
- 中断時の情報（
last_completed_step,data_file_saved）を読み取る - AskUserQuestion で以下を表示:
前回の e-Tax 入力はステップ{N}で中断されています。
再開方法を選択してください。
- 選択肢:
- 「.data ファイルから再開する」（
data_file_saved: trueの場合のみ表示） - 「最初からやり直す」
- 「中断記録を破棄して終了する」
- 「.data ファイルから再開する」（
-
.data ファイルから再開する場合:
- 確定申告書等作成コーナーのトップページにアクセス
- 「保存データを利用して作成」→「作成再開」を選択
.dataファイルのアップロードを案内- 読み込み完了後、
last_completed_stepの次のステップから再開する
-
最初からやり直す場合:
- ステップ0 から通常通り開始する
ステップ0: 必須データの検証
確定申告書等作成コーナーへの入力に必要なデータが揃っているか検証する。
検証項目
[1] 税額計算済み
- .shinkoku/progress/07-income-tax.md が存在し、status: completed であること
[2] プロファイル完備
- 氏名（姓・名）が登録されているか
- 住所が登録されているか
- 所轄税務署名が登録されているか
[3] 決算書データ
- PL/BS の計算結果が取得可能であること
[4] 消費税（該当者のみ）
- .shinkoku/progress/08-consumption-tax.md が存在し、status: completed であること
[5] サニティチェック
- `tax_calc.py sanity-check` を実行する
- error > 0 の場合: 入力を中止し、`/income-tax` スキルで修正を促す
- warning > 0 の場合: ユーザーに確認してから続行する
画面遷移フロー全体像
┌─────────────────────────────────────────────────────┐
│ CC-AA-010 税務署への提出方法の選択 │
│ マイナンバーカード: はい → スマホ: はい │
│ → 「スマートフォンを使用する」 │
└──────────────┬──────────────────────────────────────┘
▼
┌─────────────────────────────────────────────────────┐
│ CC-AE-090 作成する申告書等の選択 │
│ 「決算書・収支内訳書（＋所得税）」を選択 │
│ → doSubmitCMW0900(2,'25') │
│ │
│ ※ 消費税のみ別途作成する場合: │
│ → doSubmitCMW0900(3,'25') │
└──────────────┬──────────────────────────────────────┘
▼
┌─────────────────────────────────────────────────────┐
│ CC-AE-600 マイナポータル連携の選択 │
│ → 「マイナポータル連携を利用しない」 │
└──────────────┬──────────────────────────────────────┘
▼
┌─────────────────────────────────────────────────────┐
│ CC-AA-024 e-Taxを行う前の確認 │
│ → 「利用規約に同意して次へ」 │
└──────────────┬──────────────────────────────────────┘
▼
┌─────────────────────────────────────────────────────┐
│ CC-AA-440 QRコード認証 │
│ ★ ユーザーの物理的認証が必要 │
│ スマートフォンでQRコード読み取り │
│ → マイナンバーカード認証完了後、自動遷移 │
└──────────────┬──────────────────────────────────────┘
▼
┌───────┴───────┐
▼ ▼
決算書コーナー 所得税コーナー
(事業所得あり) (給与のみ等)
決算書コーナーのフロー
/kessan/ac/r7/top → ac0300（種類選択）→ aa0200（P/L入力）
→ aa0100（青色特別控除）→ preAoiroCalc（B/S入力）
→ aa0700（所得確認）→ ac0500（住所氏名）→ 印刷/保存
→ 所得税コーナーへ遷移
所得税コーナーのフロー
SS-AA-010a（所得選択）→ SS-AA-050（収入入力ハブ）
→ SS-CA-010（給与入力） / SS-CB-xxx（事業所得） / 雑所得
→ SS-AA-070a（控除1/2）→ SS-AA-080（控除2/2）
→ SS-AA-090（計算結果確認）
→ SS-AC-010a（納付方法）→ SS-AC-020a（住民税等）
→ SS-AC-030（基本情報）→ SS-AC-040（マイナンバー）
→ ステップ5.5（意思決定ゲート）→ ステップ6（電子署名・送信プロトコル）
消費税コーナーのフロー（所得税完了後）
所得税完了 → 「消費税の申告書作成はこちら」
2割特例:
ac0100(条件判定) → ac0250(所得区分選択) → 売上入力hub → 売上入力detail
→ 売上入力hub → 中間納付 → ac0300(計算結果) → 納税地等
→ ステップ6.5（電子署名・送信プロトコル）
簡易課税:
ac0100(条件判定) → ac0250(所得区分・事業区分選択) → 売上入力hub → 売上入力detail
→ 売上入力hub → ak2140(仕入税額控除方式選択)※ → 中間納付 → ac0300(計算結果)
→ 納税地等 → ステップ6.5（電子署名・送信プロトコル）
※ 2種以上の事業がある場合のみ
一般課税:
ac0100(条件判定) → ac0250(所得区分選択) → 売上・仕入入力hub → 売上入力detail
→ ai3610(決算額テーブル)※ → 売上・仕入入力hub → 中間納付 → ac0300(計算結果)
→ 納税地等 → ステップ6.5（電子署名・送信プロトコル）
※ 積上げ計算選択時のみ
ステップ1: 確定申告書等作成コーナーへのアクセス
開始URL
https://www.keisan.nta.go.jp/kyoutu/ky/sm/top_web#bsctrl
CC-AA-010: 税務署への提出方法の選択
画面番号: CC-AA-010
- 「マイナンバーカードをお持ちですか」→ 「はい」 ラジオボタンをクリック
- 「マイナンバーカード読み取りに対応したスマートフォン又はICカードリーダライタをお持ちですか」→ 「はい」 をクリック
- 「スマートフォンを使用する」 をクリック
- JS:
doSubmitCSW0100('1','3','/ky/sm/csw0100_myno_qr')
- JS:
CC-AE-090: 作成する申告書等の選択
画面番号: CC-AE-090
選択肢（令和7年分）:
- 所得税 →
doSubmitCMW0900(1,'25') - 決算書・収支内訳書（＋所得税） →
doSubmitCMW0900(2,'25')← 事業所得ありの場合 - 消費税 →
doSubmitCMW0900(3,'25') - 贈与税 →
doSubmitCMW0900(4,'25')
判断基準:
- 事業所得あり → 「決算書・収支内訳書（＋所得税）」
- 事業所得なし（給与のみ等）→ 「所得税」
- 消費税は所得税完了後に別途作成
CC-AE-600: マイナポータル連携の選択
→ 「マイナポータル連携を利用しない」 をクリック
CC-AA-024: e-Taxを行う前の確認
→ 「利用規約に同意して次へ」 をクリック
※ 環境チェック termnalInfomationCheckOS_myNumberLinkage() が実行される。
Windows/macOS の Chrome/Edge であれば問題なし。
CC-AA-440: QRコード認証
★ ユーザー操作待ち — ブラウザ操作を一時停止
この画面ではエージェントがブラウザを操作してはならない。 AskUserQuestion ツールで一時停止し、ユーザーが認証完了を報告するまで絶対に次のステップに進まないこと。
AskUserQuestion で以下を表示する:
QRコード認証画面が表示されました。
スマートフォンのマイナポータルアプリでQRコードを読み取り、
マイナンバーカードで認証してください。
認証が完了したら「認証完了」を選択してください。
- 選択肢: 「認証完了」 / 「QRコードが表示されない」
- 「QRコードが表示されない」が選ばれた場合は下記の ⚠️ Playwright CLI 使用時の注意 を参照して対処する
- ユーザーが「認証完了」を選択するまで、一切のブラウザ操作・画面遷移を行わない
認証完了後、自動的に次の画面に遷移する。
⚠️ Playwright CLI 使用時の注意: PLAYWRIGHT_MCP_INIT_SCRIPT 環境変数で etax-stealth.js を指定することで
サーバーベイク関数パッチが自動適用されるが、QR コードが表示されない場合はコンソールで getClientOS() の
戻り値を確認し、'Windows' でなければ以下を手動実行する:
window.getClientOS = function() { return 'Windows'; };
displayQrcode();
ステップ2: 青色申告決算書の入力（事業所得がある場合）
⚠️ ネイティブダイアログ注意: 「次へ」クリック後に画面が遷移しない場合、ネイティブダイアログ（alert/confirm）が表示されている可能性がある。技術的な知見の「ネイティブダイアログの検知と対処」を参照。
/kessan/ac/pre/ac0300: 決算書の種類選択
ラジオボタン:
- 青色申告決算書 ← 青色申告の場合
- 収支内訳書（白色申告の場合）
- 青色申告決算書（現金主義用）
/kessan/ac/aa0200: 損益計算書（P/L）の入力
URL: https://www.keisan.nta.go.jp/kessan/ac/aa0200#bsctrl
期間の入力
| フィールド | name | デフォルト |
|---|---|---|
| 開始月 | sonekiKeisansyoFromMonth |
1 |
| 開始日 | sonekiKeisansyoFromDay |
1 |
| 終了月 | sonekiKeisansyoToMonth |
12 |
| 終了日 | sonekiKeisansyoToDay |
31 |
売上（収入）金額
「入力」ボタン → /kessan/ac/aa0201 売上仕入月別入力サブページに遷移。
aa0201 のフィールド:
uriageKingaku1〜uriageKingaku12: 月別売上siireKingaku1〜siireKingaku12: 月別仕入kajisyohi: 家事消費等zatusyunyu: 雑収入
合計: uriageKingakuGokei, siireKingakuGokei
経費（行8〜31）
| 行 | 科目 | name（直接入力） | 備考 |
|---|---|---|---|
| 8 | 租税公課 | sozeiKoka |
|
| 9 | 荷造運賃 | nidukuriUntin |
|
| 10 | 水道光熱費 | suidoKonetuhi |
|
| 11 | 旅費交通費 | ryohiKotuhi |
|
| 12 | 通信費 | tusinhi |
|
| 13 | 広告宣伝費 | kokokuSendenhi |
|
| 14 | 接待交際費 | settaiKosaihi |
|
| 15 | 損害保険料 | songaiHokenryo |
|
| 16 | 修繕費 | syuzenhi |
|
| 17 | 消耗品費 | syomohinhi |
|
| 18 | 減価償却費 | — | 「入力」→ /kessan/ac/init/aa0203 |
| 19 | 福利厚生費 | fukuriKoseihi |
|
| 20 | 給料賃金 | — | 「入力」→ /kessan/ac/aa0205 |
| 21 | 外注工賃 | gaichukotin |
|
| 22 | 利子割引料 | — | 「入力」→ /kessan/ac/aa0206 |
| 23 | 地代家賃 | — | 「入力」→ /kessan/ac/aa0207 |
| 24 | 貸倒金 | kasidaorekin |
|
| 25 | 税理士等の報酬 | keihiNiniKingaku1 |
科目名: keihiNiniKamoku1 |
| 26 | 震災関連経費 | keihiNiniKingaku2 |
科目名: keihiNiniKamoku2 |
| 27-30 | 任意科目 | keihiNiniKingaku3〜6 |
科目名: keihiNiniKamoku3〜6 |
| 31 | 雑費 | zappi |
集計 hidden フィールド: keihiSannyugakuGokei, kyuryoTinginTotalGokei, risiWaribikiryoGokei, tidaiYatinGokei
繰戻額等
kurimodosiNiniKamoku1/kurimodosiNiniKingaku1kurimodosiNiniKamoku2/kurimodosiNiniKingaku2
専従者給与
senjusyaKyuyoTotalGokei(hidden、「入力」ボタンで別画面)kasidaoreKuriireGokei(hidden)
計算結果（自動）
disp_aoiroKojomaeSyotokuKingaku= 売上 - 売上原価 - 経費 + 繰戻額 - 専従者給与等
/kessan/ac/submit/aa0100: 青色申告特別控除
Q&A形式で控除額を選択:
| 選択肢 | value | 条件 |
|---|---|---|
| 10万円 | 2 | |
| 55万円 | 3 | |
| 65万円 | 1 | e-Tax送信が必須。書面提出ではエラー KS-E10089 |
フィールド: aoiroTokubetuKojoSentakugaku
65万円を選択する場合、電子帳簿保存または e-Tax 送信が条件。
⚠️ ネイティブダイアログ注意: 65万円を選択して次へ進むと、書面提出の場合は KS-E10089（e-Tax送信が必要）のネイティブダイアログが表示される。画面が遷移しない場合はダイアログの有無をユーザーに確認すること。
貸借対照表（B/S）の入力
URL: /kessan/ac/preAoiroCalc
資産の部
配列形式: sisannobuTaisyohyoDetailDataList[N].kisyuKingaku / .kimatuKingaku
| index | 勘定科目 |
|---|---|
| 0 | 現金 |
| 1 | 当座預金 |
| 2 | 定期預金 |
| 3 | その他の預金 |
| 4 | 受取手形 |
| 5 | 売掛金 |
| 6 | 有価証券 |
| 7 | 棚卸資産 |
| 8 | 前払金 |
| 9 | 貸付金 |
| 10 | 建物 |
| 11 | 建物附属設備 |
| 12 | 機械装置 |
| 13 | 車両運搬具 |
| 14 | 工具器具備品 |
| 15 | 土地 |
| 16-23 | 任意科目 |
負債・資本の部
配列形式: fusainobuTaisyohyoDetailDataList[N].kisyuKingaku / .kimatuKingaku
| index | 勘定科目 |
|---|---|
| 0 | 支払手形 |
| 1 | 買掛金 |
| 2 | 借入金 |
| 3 | 未払金 |
| 4 | 前受金 |
| 5 | 預り金 |
| 6 | 貸倒引当金 |
| 7-15 | 任意科目 |
| 16 | 元入金 |
| 17 | 事業主借 |
| 18 | 事業主貸 |
| 19 | 青色申告特別控除前の所得金額（P/Lから自動） |
重要: 資産期末合計 = 負債期末合計 が必須（KS-E40003）
⚠️ ネイティブダイアログ注意: 資産期末合計と負債期末合計が一致しない状態で「次へ」を押すと、KS-E40003 のネイティブダイアログが表示される。画面が遷移しない場合はダイアログの有無をユーザーに確認すること。
/kessan/ac/ac0500: 住所・氏名等の入力
| フィールド | name |
|---|---|
| 郵便番号 | jitakuZip |
| 都道府県 | jitakuPrefectureId |
| 市区町村以下 | jitakuAddresshow to use e-tax How to use e-tax on CursorAI-first code editor with Composer 1 PrerequisitesBefore installing skills in Cursor, ensure your development environment meets these requirements:
2 Execute installation commandExecute the skills CLI command in your project's root directory to begin installation: $npx skills add https://github.com/kazukinagata/shinkoku --skill e-tax The skills CLI fetches 3 Select Cursor when promptedThe CLI will show a list of available agents. Use arrow keys to navigate and space to select Cursor: ◆ Which agents do you want to install to? │ │ ── Universal (.agents/skills) ── always included ──── │ • Amp │ • Antigravity │ • Cline │ • Codex │ ●Cursor(selected) │ • Cursor │ • Windsurf 4 Verify installationConfirm successful installation by checking the skill directory location: .cursor/skills/e-tax Reload or restart Cursor to activate e-tax. Access the skill through slash commands (e.g., ⚠ Security & Verification NoticeWe perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use. Skills execute code in your development environment. Always verify the publisher's identity, review recent commits, and test in isolated environments before production deployment. List & Monetize Your SkillSubmit your Claude Code skill and start earning Use Cases▌User Story & Requirements GenerationCreate detailed user stories, acceptance criteria, and feature specs Example Generate user stories for 'password reset feature' with acceptance criteria, edge cases, and test scenarios ✓ Reduce spec writing time by 50%, ensure comprehensive coverage Competitive AnalysisResearch competitors, compare features, identify gaps Example Analyze 5 competitor products, create feature comparison matrix, suggest differentiation opportunities ✓ Complete competitive research in 2 hours instead of 2 days Roadmap PrioritizationEvaluate features using frameworks (RICE, ICE, Kano) and create prioritized backlogs Example Score 20 feature ideas using RICE framework, generate prioritized roadmap with rationale ✓ Make data-driven prioritization decisions faster Stakeholder CommunicationDraft PRDs, status updates, and stakeholder presentations Example Create executive summary of Q3 roadmap, monthly progress report, feature launch announcement ✓ Save 3-5 hours/week on communication overhead Implementation Guide▌Prerequisites
Time Estimate30-60 minutes to see productivity improvements Installation Steps
Common Pitfalls
Best Practices▌✓ Do
✗ Don't
💡 Pro Tips
When to Use This▌✓ Use WhenUse for user story writing, competitive research, roadmap prioritization, stakeholder communication, and PRD drafting. Best for reducing repetitive documentation and research work. ✗ Avoid WhenAvoid for strategic product vision (requires deep customer empathy), pricing decisions (needs market and financial expertise), or when face-to-face customer discovery is more valuable than speed. Learning Path▌
DiscussionProduct Hunt–style comments (not star reviews)
general reviews Ratings4.6★★★★★64 reviews
showing 1-10 of 64 1 / 7 |