Skip to content
Back to search

shinkoku

MarketplaceWorks with Claude CodeGitHub

確定申告自動化 AI エージェントプラグイン — 帳簿管理から e-Tax 入力代行まで

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/kazukinagata-shinkoku/badge.svg)](/listings/kazukinagata-shinkoku)

HTML

<a href="/listings/kazukinagata-shinkoku"><img src="/api/listings/kazukinagata-shinkoku/badge.svg" alt="findsafeskills safety rating" /></a>

Install

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 18 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  3. "name": "shinkoku",
  4. "owner": {
  5. "name": "Kazuki Nagata"
  6. },
  7. "metadata": {
  8. "description": "確定申告自動化 Claude Code Plugin"
  9. },
  10. "plugins": [
  11. {
  12. "name": "shinkoku",
  13. "source": "./",
  14. "description": "確定申告自動化 Claude Code Plugin。帳簿管理から e-Tax 入力代行まで。",
  15. "license": "MIT"
  16. }
  17. ]
  18. }
README.md · README · 359 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # shinkoku
  2. 確定申告を自動化する AI コーディングエージェント向けプラグイン。個人事業主・会社員の所得税・消費税の確定申告を、帳簿の記帳から確定申告書等作成コーナーへの入力代行までエンドツーエンドで支援します。
  3. **Claude Code Plugin** として動作するほか、**SKILL.md オープン標準** に準拠した Agent Skills パッケージとして、Claude Code / Cursor / Windsurf / GitHub Copilot / Gemini CLI / Codex / Cline / Roo Code / Antigravity など 40 以上の AI コーディングエージェントで利用できます。
  4. ## 想定ユーザー
  5. | 対象 | 対応レベル | 備考 |
  6. |------|-----------|------|
  7. | 個人事業主(青色申告・一般用) | Full | メインターゲット。帳簿 → 決算書 → 税額計算 → 作成コーナー入力 |
  8. | 会社員 + 副業(事業所得) | Full | 源泉徴収票 + 事業所得の税額計算 → 作成コーナー入力 |
  9. | 給与所得のみ(会社員) | Full | 還付申告・医療費控除等 → 作成コーナー入力 |
  10. | 消費税課税事業者 | Full | 2割特例・簡易課税・本則課税すべて対応 |
  11. | ふるさと納税利用者 | Full | 寄附金 CRUD + 控除計算 + 限度額推定 |
  12. | 住宅ローン控除(初年度) | Full | 控除額計算(添付書類は別途必要) |
  13. | 医療費控除 | Full | 明細集計+控除額計算 |
  14. | 仮想通貨トレーダー | Full | 雑所得(総合課税)として申告書に自動反映 |
  15. ## 非対応
  16. 以下のケースには対応していません。
  17. | 対象 | 理由 |
  18. |------|------|
  19. | 株式投資家(分離課税) | 株式譲渡所得・配当の分離課税 |
  20. | FX トレーダー | 先物取引に係る雑所得等 |
  21. | 不動産所得 | 不動産所得用の決算書・申告 |
  22. | 退職所得 | 退職所得控除の計算 |
  23. | 譲渡所得(不動産売却) | 長期/短期税率、3,000万円特別控除 |
  24. | 外国税額控除 | 外国税支払額の追跡・控除計算 |
  25. | 農業所得・山林所得 | 専用所得区分 |
  26. | 白色申告 | 青色申告のみ対応 |
  27. | 非居住者 | 日本居住者専用 |
  28. ---
  29. ## ⚠️ 免責事項
  30. **確定申告は自己責任で行ってください。**
  31. - 本ツールが生成した申告書・計算結果は、提出前に**必ずご自身で内容を確認**してください
  32. - 税法の解釈や申告内容に不安がある場合は、**税理士等の専門家に相談**することを強く推奨します
  33. - 本ツールの利用によって生じた**いかなる損害についても、開発者は責任を負いません**
  34. - 税制は毎年改正されます。本ツールは令和7年分(2025年)と令和8年分(2026年、令和8年度税制改正反映)の所得税・消費税計算に対応しています
  35. - 令和9年分以後について計算に反映済みのもの: 消費税の3割特例(令和9・10年分)、ふるさと納税 特例控除額の193万円上限(令和9年中以後の寄附)、住宅ローン控除の借入限度額(令和12年入居まで)、基礎控除・給与所得控除の令和10年分以後の本則値
  36. - 令和9年分以後について定数・注記のみで計算に未反映のもの: 防衛特別所得税と復興特別所得税1.1%への分割(合計2.1%で税額は不変)、青色申告特別控除の65万/75万への見直し、ひとり親控除38万、公的年金等控除の280万円上限、暗号資産の申告分離課税、基礎控除等の物価連動改定値
  37. ---
  38. ## インストール
  39. ### 前提条件
  40. - Python 3.11 以上
  41. - [uv](https://docs.astral.sh/uv/) パッケージマネージャ
  42. ### CLI のインストール
  43. スキルが内部で `shinkoku` コマンドを呼び出します。通常は `/setup` スキルが自動でインストールしますが、手動で行う場合は以下を実行してください。
  44. ```bash
  45. # インストール
  46. uv tool install git+https://github.com/kazukinagata/shinkoku
  47. # 更新
  48. uv tool upgrade shinkoku
  49. ```
  50. > Cowork の場合は、チャットで Claude にインストールを依頼してください。
  51. ### 方法 1: Claude Code プラグイン(フル機能)
  52. プラグイン機能を使い、OCR 画像読取を含む全機能を利用できます。
  53. ```bash
  54. # マーケットプレイスを追加
  55. /plugin marketplace add kazukinagata/shinkoku
  56. # プラグインをインストール
  57. /plugin install shinkoku@shinkoku
  58. ```
  59. ### 方法 2: スキルのみインストール(40+ エージェント対応)
  60. [skills](https://github.com/vercel-labs/skills) CLI でスキルをインストールできます。
  61. ```bash
  62. # スキルのインストール(インストール先エージェントを対話的に選択)
  63. npx skills add kazukinagata/shinkoku
  64. # 特定のエージェントにグローバルインストール
  65. npx skills add kazukinagata/shinkoku -g -a claude-code -a cursor
  66. # インストール可能なスキル一覧を確認
  67. npx skills add kazukinagata/shinkoku --list
  68. ```
  69. ### 環境別の補足
  70. | 環境 | 設定方法 |
  71. |------|---------|
  72. | Claude Code | `/plugin marketplace add kazukinagata/shinkoku` → `/plugin install shinkoku@shinkoku` |
  73. | Cowork | プラグイン > 個人用 > GitHub からマーケットプレイスを追加 > `kazukinagata/shinkoku` を入力してマーケットプレイスを追加し、その後表示される shinkoku プラグインをインストール |
  74. | その他 | `npx skills add kazukinagata/shinkoku` でインストール(方法 2 を参照) |
  75. ### ブラウザ自動化(e-Tax に必要)
  76. `/e-tax` スキルでは、確定申告書等作成コーナーへの入力にブラウザ自動化が必要です。以下の3方式に対応しています。
  77. | 方式 | 対象環境 | 備考 |
  78. |------|---------|------|
  79. | Claude in Chrome(推奨) | Windows / macOS のネイティブ Chrome | Claude in Chrome 拡張機能が必要 |
  80. | Antigravity Browser Sub-Agent | Windows / macOS / Linux | Antigravity IDE のブラウザ操作機能を利用 |
  81. | Playwright CLI(β版) | WSL / Linux 等 | `@playwright/cli` のインストールが必要 |
  82. #### Claude in Chrome の有効化(Claude Code)
  83. Claude in Chrome を利用するには、Claude Code 起動時にフラグを付けるか、セッション内でコマンドを実行します。
  84. ```bash
  85. # 起動時に有効化
  86. claude --chrome
  87. # セッション内で有効化
  88. /chrome
  89. ```
  90. #### Playwright CLI のインストール
  91. Claude in Chrome, Antigravity を利用する場合このステップは不要です。
  92. ```bash
  93. # パッケージインストール
  94. npm install -g @playwright/cli@latest
  95. # スキルインストール(エージェントがコマンドを認識するために必要)
  96. playwright-cli install --skills
  97. # Chromium インストール
  98. npx playwright install chromium
  99. ```
  100. WSL の場合、GUI 表示が必要です(headed モードで Chrome を操作するため)。Windows 11 では WSLg が標準搭載されており追加設定は不要です。Windows 10 では X Server(VcXsrv 等)が必要です。
  101. ## 使い方
  102. ### 作業ディレクトリの準備
  103. shinkoku はプラグイン(またはスキル)としてインストールして使います。**このリポジトリを clone する必要はありません。**
  104. お好きなディレクトリを作業フォルダとして使ってください。確定申告に関するデータはすべてこのフォルダ内に保存されます。
  105. ```bash
  106. # 例: 確定申告用のフォルダを作成
  107. mkdir ~/kakuteishinkoku && cd ~/kakuteishinkoku
  108. # git で管理する場合(推奨)
  109. git init
  110. ```
  111. ### セットアップ
  112. 作業ディレクトリで `/setup` と入力すると、対話形式で初期設定が始まります。
  113. ```
  114. /setup
  115. ```
  116. セットアップでは以下が行われます:
  117. 1. 設定ファイル(`shinkoku.config.yaml`)の生成
  118. 2. `.gitignore` の自動設定(git リポジトリの場合)
  119. 3. データベース(`shinkoku.db`)の初期化
  120. ### 個人データの保護
  121. shinkoku は作業ディレクトリに以下のファイルを生成します。これらにはマイナンバー・住所・財務データ等の**個人情報が含まれます**。
  122. | ファイル | 内容 |
  123. |---------|------|
  124. | `shinkoku.config.yaml` | マイナンバー・電話番号・住所等の個人情報 |
  125. | `shinkoku.db` / `shinkoku.db-wal` / `shinkoku.db-shm` | 帳簿・仕訳の財務データ |
  126. | `.shinkoku/` | 進捗ファイル(納税者情報のサマリー) |
  127. | `output/` | 生成レポート |
  128. `/setup` を git リポジトリ内で実行すると、これらのファイルが `.gitignore` に自動追加されます。ユーザーが設定した書類ディレクトリ(請求書・レシート等)も同様に追加されます。
  129. > **注意**: `.gitignore` に登録されていても、`git add -f` で強制追加するとコミットされてしまいます。個人情報を含むファイルを絶対にリモートリポジトリにプッシュしないよう注意してください。
  130. ## スキル一覧
  131. ### メインワークフロー
  132. | スキル | 説明 |
  133. |-------|------|
  134. | `/setup` | 初回セットアップ。設定ファイル(`shinkoku.config.yaml`)の生成とデータベースの初期化 |
  135. | `/assess` | 確定申告が必要かどうか、所得税・消費税の申告要否を判定 |
  136. | `/gather` | 必要書類のチェックリストと取得先を案内 |
  137. | `/journal` | CSV・レシート・請求書・源泉徴収票を取り込み、複式簿記の仕訳を登録 |
  138. | `/settlement` | 減価償却・決算整理仕訳の登録、残高試算表・損益計算書・貸借対照表の生成 |
  139. | `/income-tax` | 所得税額を計算(所得控除・税額控除・復興特別所得税) |
  140. | `/consumption-tax` | 消費税額を計算(2割特例・簡易課税・本則課税) |
  141. | `/submit` | 最終確認チェックリストと提出方法(e-Tax / 郵送 / 持参)の案内 |
  142. | `/e-tax` | 確定申告書等作成コーナーへの入力代行(Claude in Chrome / Playwright / Antigravity) |
  143. ### 補助スキル
  144. | スキル | 説明 |
  145. |-------|------|
  146. | `/tax-advisor` | 控除・節税・税制についての質問に回答する税務アドバイザー |
  147. | `/furusato` | ふるさと納税の寄附金登録・一覧・削除・集計と控除限度額推定 |
  148. | `/invoice-system` | インボイス制度関連の参照情報 |
  149. | `/capabilities` | shinkoku の対応範囲・対応ペルソナ・既知の制限事項を表示 |
  150. | `/incorporation` | 法人成り(個人事業主から法人への移行)の税額比較・設立手続き相談 |
  151. ### OCR 読取スキル
  152. | スキル | 読取対象 |
  153. |-------|---------|
  154. | `/reading-receipt` | レシート・領収書・ふるさと納税受領証明書 |
  155. | `/reading-withholding` | 源泉徴収票 |
  156. | `/reading-invoice` | 請求書 |
  157. | `/reading-deduction-cert` | 控除証明書(生命保険料・地震保険料等) |
  158. | `/reading-payment-statement` | 支払調書 |
  159. ## 対応エージェント
  160. ### OCR 画像読取
  161. レシート・源泉徴収票等の画像読取(`/reading-*` スキル)は、利用する LLM がマルチモーダル(画像認識)に対応している必要があります。これはエージェントプラットフォームではなく、接続先の LLM の能力に依存します。
  162. - **マルチモーダル LLM**(Claude Opus 4.6, GPT-5.2, Gemini 3.1 等): OCR 読取可能
  163. - **テキスト専用 LLM**: 手動入力が必要
  164. ### OCR デュアル検証(サブエージェント利用)
  165. 2つのサブエージェントが独立に画像を読み取り、結果をクロスチェックする機能です。サブエージェントの並列実行に対応したプラットフォームで利用できます。非対応のプラットフォームでは、単一読取 + ユーザー確認にフォールバックします。
  166. | エージェント | デュアル検証 |
  167. |-------------|:---:|
  168. | Claude Code | ✓ |
  169. | Cowork | ✓ |
  170. | Cursor 2.5+ | ✓ |
  171. | GitHub Copilot | ✓ |
  172. | Cline | ✓ |
  173. | Antigravity | ✓ |
  174. | Windsurf | — |
  175. | Gemini CLI | △ |
  176. | Roo Code | △ |
  177. - **△**: サブエージェント機能はあるが並列実行が制限的
  178. ## 開発者向け情報
  179. ### テスト
  180. ```bash
  181. make test # 全テスト実行
  182. uv run pytest tests/unit/ -v # ユニットテスト
  183. uv run pytest tests/scripts/ -v # CLI テスト
  184. uv run pytest tests/integration/ -v # 統合テスト
  185. ```
  186. ### Lint / 型チェック
  187. ```bash
  188. make lint # Ruff lint + format + mypy
  189. uv run ruff format --check src/ tests/ # フォーマットチェック
  190. uv run mypy src/shinkoku/ --ignore-missing-imports # 型チェック
  191. ```
  192. ### プロジェクト構成
  193. ```
  194. shinkoku/
  195. ├── .claude-plugin/
  196. │ └── plugin.json # Claude Code プラグインマニフェスト
  197. ├── .github/
  198. │ └── workflows/
  199. │ └── test.yml # CI パイプライン
  200. ├── skills/ # Agent Skills(SKILL.md オープン標準)
  201. │ ├── setup/SKILL.md # 初回セットアップ
  202. │ ├── assess/SKILL.md # 申告要否判定
  203. │ ├── gather/SKILL.md # 書類収集
  204. │ ├── journal/SKILL.md # 仕訳入力・帳簿管理
  205. │ ├── settlement/SKILL.md # 決算整理・決算書作成
  206. │ ├── income-tax/SKILL.md # 所得税計算
  207. │ ├── consumption-tax/SKILL.md # 消費税計算
  208. │ ├── submit/SKILL.md # 提出準備
  209. │ ├── tax-advisor/SKILL.md # 税務アドバイザー
  210. │ ├── furusato/SKILL.md # ふるさと納税
  211. │ ├── e-tax/SKILL.md # e-Tax 電子申告(Claude in Chrome)
  212. │ ├── capabilities/SKILL.md # 機能確認
  213. │ ├── incorporation/SKILL.md # 法人成り相談
  214. │ ├── reading-receipt/SKILL.md # OCR: レシート
  215. │ ├── reading-withholding/SKILL.md # OCR: 源泉徴収票
  216. │ ├── reading-invoice/SKILL.md # OCR: 請求書
  217. │ ├── reading-deduction-cert/SKILL.md # OCR: 控除証明書
  218. │ └── reading-payment-statement/SKILL.md # OCR: 支払調書
  219. ├── src/shinkoku/
  220. │ ├── cli/ # CLI エントリーポイント(shinkoku コマンド)
  221. │ │ ├── __init__.py # main() + サブコマンド登録
  222. │ │ ├── ledger.py # 帳簿管理 CLI
  223. │ │ ├── tax_calc.py # 税額計算 CLI
  224. │ │ ├── import_data.py # データ取込 CLI
  225. │ │ ├── pdf.py # PDF ユーティリティ CLI
  226. │ │ ├── furusato.py # ふるさと納税 CLI
  227. │ │ └── profile.py # プロファイル CLI
  228. │ ├── tools/ # ビジネスロジック(純粋関数)
  229. │ │ ├── ledger.py # 帳簿管理
  230. │ │ ├── tax_calc.py # 税額計算
  231. │ │ ├── import_data.py # データ取り込み
  232. │ │ ├── pdf.py # PDF ユーティリティ
  233. │ │ ├── furusato.py # ふるさと納税
  234. │ │ └── profile.py # プロファイル取得
  235. │ ├── models.py # Pydantic モデル定義
  236. │ ├── db.py # SQLite DB 管理
  237. │ ├── master_accounts.py # 勘定科目マスタ
  238. │ ├── tax_constants.py # 税制定数
  239. │ ├── config.py # 設定ファイル読み込み
  240. │ ├── hashing.py # ハッシュユーティリティ
  241. │ └── duplicate_detection.py # 重複検出ロジック
  242. ├── tests/
  243. │ ├── unit/ # ユニットテスト
  244. │ ├── scripts/ # CLI テスト
  245. │ ├── integration/ # 統合テスト
  246. │ ├── fixtures/ # テストフィクスチャ
  247. │ └── helpers/ # テストヘルパー
  248. ├── shinkoku.config.example.yaml # 設定ファイルテンプレート
  249. ├── pyproject.toml
  250. ├── Makefile
  251. └── uv.lock
  252. ```
  253. ### 技術スタック
  254. - Python 3.11+
  255. - SQLite(WAL モード)
  256. - Pydantic(モデル定義・バリデーション)
  257. - pdfplumber(PDF 読取)
  258. - Playwright(ブラウザ自動化フォールバック — Python `playwright` + npm `@playwright/cli`)
  259. - PyYAML(設定ファイル読み込み)
  260. - Ruff(lint / format)
  261. - mypy(型チェック)
  262. - pytest(テスト)
  263. ## ライセンス
  264. MIT License -- 詳細は [LICENSE](./LICENSE) を参照してください。
  265. ## コントリビュート
  266. Issue や Pull Request を歓迎します。日本語での報告・提案で構いません。
  267. - バグ報告: Issue を作成してください。再現手順があると助かります
  268. - 機能提案: Issue で議論した上で PR を作成してください
  269. - PR: `main` ブランチに対して作成してください。CI(lint + テスト)が通ることを確認してください

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.