用途:把 shinkoku 计算出的确定申告数据,通过 Claude in Chrome 等浏览器自动化,录入并提出于確定申告書等作成コーナー(https://www.keisan.nta.go.jp/)。
前提条件:需先用 /income-tax 完成所得税计算、/settlement 完成决算书(PL/BS)、/consumption-tax 完成消费税(仅该当者),并已配置 shinkoku.config.yaml,且可用任一浏览器自动化方式。
浏览器自动化方式(按判定顺序):A:Claude in Chrome(推荐,需扩展,Windows/macOS 原生 Chrome);B:Antigravity Browser Sub-Agent(需 browser_subagent,Windows/macOS/Linux);C:Playwright CLI(回退,需 @playwright/cli 与 etax-stealth.js,headed 模式必须)。三者均不可用时提示错误并参照 README 的「浏览器自动化」章节。
主要能力:读取配置与 .shinkoku/progress 下的进度及计算引继书;执行步骤0 数据校验(税计算完成、资料齐全、sanity-check);按画面流程录入決算書、所得税、消費税(2割特例/简易课税/一般课税);支持中断与 .data 文件保存再开协议;QR 码认证时暂停等待用户物理认证。
使用方式:先以 Read 读取 shinkoku.config.yaml 与进度文件,确认 status 后再执行;按各画面 name 字段录入;方式 C 需设置 PLAYWRIGHT_MCP_INIT_SCRIPT 并用 playwright-cli -s=etax open <url> --headed --browser=chrome 启动。
限制:需用户本人使用マイナポータル应用与マイナンバーカード完成认证,代理不得代办;Playwright 方式需 headed;进入 QR 认证画面后必须暂停,不得自动推进。部分字段/URL(如年末调整未济表单)标记为「要确认」;费用、平台、效果等资料未提供。