● Community
kazukinagata
⚡ Instant
Shinkoku
by kazukinagata · kazukinagata/shinkoku
Japanese tax-return automation AI agent plugin — bookkeeping to e-Tax submission.
Shinkoku is a Claude skill / skill pack maintained by kazukinagata. Japanese tax-return automation AI agent plugin — bookkeeping to e-Tax submission. See README for installation and configuration: https://github.com/kazukinagata/shinkoku
Why use it
Key features
- Japanese tax-return automation AI agent plugin — bookkeeping to e-Tax submission.
- Language: Python
- 340+ GitHub stars at verification time
- Community project
Live Demo
What it looks like in practice
Use Cases
Real-world ways to use Shinkoku
When to use: See repo README for canonical use cases.
Prerequisites
- Repo cloned or package installed — See https://github.com/kazukinagata/shinkoku
Flow
-
Install
Install Shinkoku per README.✓ Copied
→ Tool/skill registered with client
-
Configure
Provide credentials/config as instructed.✓ Copied
→ Successful auth/init
-
Use
Run a sample task with Shinkoku.✓ Copied
→ Expected output
Outcome: You can drive the documented workflow end-to-end.
Pitfalls
- Skipping README — Read the repo README and CHANGELOG before shipping to prod.
Cost & Limits
What this costs to run
- API quota
- None of its own; bounded by upstream provider quotas if any
- Tokens per call
- Depends on usage
- Monetary
- Open source — check repo LICENSE
- Tip
- Review upstream API costs (if any) before automating.
Security
Permissions, secrets, blast radius
Minimum scopes: Whatever the upstream provider requires
Credential storage: Env vars or local config — never commit secrets
Data egress: Forwards data per its README
Never grant: Full admin to untrusted prompts
- Project moves fast — pin a version in production.
Troubleshooting
Common errors and fixes
Auth fails
Verify credentials and required scopes match README.
Verify: Re-read repo README auth section.
Tool not found by client
Ensure MCP client config points to correct command/path.
Verify: Restart the client after editing config.