Clawhub-skills misoca-agent
Misoca請求書・見積書管理エージェント — 弥生グループのクラウド請求書サービスMisocaをClaude Codeから完全操作。請求書作成・送付、見積書、納品書、入金管理、インボイス制度対応、弥生会計連携をワンコマンドで実現する日本特化の帳票自動化スキル。
git clone https://github.com/traygerbig/clawhub-skills
T=$(mktemp -d) && git clone --depth=1 https://github.com/traygerbig/clawhub-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/finance-accounting-pack/misoca-agent" ~/.claude/skills/traygerbig-clawhub-skills-misoca-agent && rm -rf "$T"
finance-accounting-pack/misoca-agent/SKILL.md┌─────────────────────────────────────────────────────┐ │ ╔╦╗╦╔═╗╔═╗╔═╗╔═╗ │ │ ║║║║╚═╗║ ║║ ╠═╣ │ │ ╩ ╩╩╚═╝╚═╝╚═╝╩ ╩ Agent │ │ │ │ ┌───────┐ ┌───────┐ ┌───────┐ ┌───────┐ │ │ │請求書 │──│見積書 │──│納品書 │──│入金 │ │ │ │Invoice│ │Quote │ │Deliver│ │Payment│ │ │ └───┬───┘ └───┬───┘ └───┬───┘ └───┬───┘ │ │ └──────────┴──────────┴──────────┘ │ │ 弥生グループ Misoca API │ │ Claude Code × 日本の帳票管理 │ └─────────────────────────────────────────────────────┘
claude-code misoca invoice billing japan
Misoca請求書・見積書管理エージェント — 弥生グループのクラウド帳票サービスMisocaをClaude Codeから完全操作。請求書の作成から送付、入金確認、弥生会計連携まで、日本の商慣習とインボイス制度に完全対応した帳票自動化スキル。
Overview
Misoca Agentは、弥生グループが提供するクラウド請求書作成サービス「Misoca」のAPIをClaude Codeから直接操作するためのスキルです。日本の商慣習に根ざした請求書・見積書・納品書の作成、送付、入金管理をコマンドラインから一括で行えます。2023年10月から施行された適格請求書等保存方式(インボイス制度)にも完全対応し、登録番号の自動付与、税率ごとの区分記載、端数処理まで自動で行います。
アーキテクチャ概要
┌──────────────────────────────────────────────────────────────┐ │ Claude Code Terminal │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ misoca invoice create / quote / delivery / payment │ │ │ └───────────────────────┬─────────────────────────────────┘ │ │ │ │ │ ┌───────────────────────▼─────────────────────────────────┐ │ │ │ Misoca Agent Core │ │ │ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌───────────┐ │ │ │ │ │Auth │ │Document │ │Payment │ │Export │ │ │ │ │ │Manager │ │Builder │ │Tracker │ │Engine │ │ │ │ │ │(OAuth2) │ │(帳票生成)│ │(入金管理)│ │(CSV/PDF) │ │ │ │ │ └────┬─────┘ └────┬─────┘ └────┬─────┘ └─────┬─────┘ │ │ │ │ └─────────────┴────────────┴─────────────┘ │ │ │ └───────────────────────┬─────────────────────────────────┘ │ │ │ HTTPS / REST API │ │ ┌───────────────────────▼─────────────────────────────────┐ │ │ │ Misoca API (api.misoca.jp) │ │ │ │ invoices / quotes / delivery_slips / contacts │ │ │ └───────────────────────┬─────────────────────────────────┘ │ │ │ 弥生ID連携 │ │ ┌───────────────────────▼─────────────────────────────────┐ │ │ │ 弥生会計オンライン / やよいの青色申告 │ │ │ │ (仕訳データ自動連携) │ │ │ └─────────────────────────────────────────────────────────┘ │ └──────────────────────────────────────────────────────────────┘
処理フロー
見積書作成 ──→ 受注確定 ──→ 納品書発行 ──→ 請求書発行 ──→ 入金確認 │ │ │ │ │ ▼ ▼ ▼ ▼ ▼ PDF生成 ステータス 発送記録 メール送付 消込処理 メール送信 更新 在庫連動 郵送代行 弥生連携
System Prompt(行動指針)
Misoca Agentとして動作する際、以下のガイドラインに厳密に従うこと。
- すべての金額は日本円(JPY)を基本単位とする。 小数点以下は切り捨てを標準とし、端数処理方法はユーザー設定に従う。
- インボイス制度(適格請求書等保存方式)に完全準拠する。 登録番号(T+13桁数字)は必ず記載し、税率ごとの区分経理を行う。
- 消費税率は標準税率10%と軽減税率8%を正確に区分する。 混在する場合は税率ごとに小計と消費税額を個別計算する。
- 請求書番号は年度ベースの連番を自動採番する。 形式は「INV-2026-0001」とし、見積書は「QUO-」、納品書は「DLV-」を接頭辞とする。
- 取引先マスタを常に最新に保つ。 新規取引先の登録時は、登録番号・住所・担当者・メールアドレスを必須項目とする。
- PDFテンプレートはMisocaの標準テンプレートを使用する。 カスタムテンプレートが登録されている場合はそちらを優先する。
- メール送信時は必ず送信先と件名をユーザーに確認する。 自動送信モードが有効な場合を除き、確認なしの送信は禁止する。
- 入金消込は銀行口座のCSVインポートまたは手動入力で行う。 部分入金にも対応し、残高を自動計算する。
- 弥生会計との連携データは仕訳日記帳形式で出力する。 勘定科目は弥生会計の標準科目コードに準拠する。
- 月次・年次の売上レポートは自動集計する。 取引先別、品目別、月別の3軸で集計可能とする。
- 見積書から請求書への変換時は、すべての明細行を引き継ぐ。 数量・単価の変更がある場合はユーザーに確認する。
- 支払期限は発行日から30日後をデフォルトとする。 取引先ごとにカスタム期限を設定可能とする。
- 源泉徴収税の自動計算に対応する。 報酬区分に応じて10.21%または20.42%を自動適用する。
- エラー発生時はMisoca APIのエラーコードと日本語の説明を同時に表示する。 リトライ可能なエラーは自動リトライする。
- すべての操作ログを保持する。 請求書の作成・編集・送付・削除の履歴を監査証跡として記録する。
- 電子帳簿保存法の要件を満たすデータ保存を行う。 タイムスタンプ、改ざん防止、検索要件に対応する。
- 複数事業所の管理に対応する。 事業所ごとに請求書テンプレート、振込先、ロゴを切り替え可能とする。
Environment Variables
| 変数名 | 必須 | 説明 | 例 |
|---|---|---|---|
| Yes | MisocaアプリケーションのクライアントID | |
| Yes | Misocaアプリケーションのクライアントシークレット | |
| Yes | OAuth2コールバックURI | |
| No | 取得済みアクセストークン(自動更新) | |
| No | リフレッシュトークン(自動保存) | |
| No | デフォルトの請求書テンプレートID | |
| No | 差出人名(会社名) | |
| No | 差出人メールアドレス | |
| No | 請求書番号の接頭辞 | |
| No | 適格請求書発行事業者登録番号 | |
| No | 振込先銀行名 | |
| No | 振込先口座番号 | |
| No | ローカルデータ保存先 | |
Commands
1. misoca invoice create
— 請求書作成
misoca invoice create新規請求書を作成し、PDFを生成します。
misoca invoice create --client "株式会社サンプル商事" \ --items "Webサイト制作:1:550000:10" "ロゴデザイン:1:110000:10" \ --due-date 2026-03-31 \ --note "お振込手数料はご負担ください"
出力例:
╔══════════════════════════════════════════════════════════╗ ║ 請求書作成完了 ║ ╠══════════════════════════════════════════════════════════╣ ║ 請求書番号: INV-2026-0042 ║ ║ 取引先: 株式会社サンプル商事 ║ ║ 発行日: 2026-03-01 ║ ║ 支払期限: 2026-03-31 ║ ║ ║ ║ ┌──────────────────┬────┬──────────┬────┬──────────┐ ║ ║ │ 品目 │数量│ 単価 │税率│ 金額 │ ║ ║ ├──────────────────┼────┼──────────┼────┼──────────┤ ║ ║ │ Webサイト制作 │ 1│ 550,000│ 10%│ 550,000│ ║ ║ │ ロゴデザイン │ 1│ 110,000│ 10%│ 110,000│ ║ ║ ├──────────────────┼────┼──────────┼────┼──────────┤ ║ ║ │ 小計 │ │ │ │ 660,000│ ║ ║ │ 消費税(10%) │ │ │ │ 66,000│ ║ ║ │ 合計 │ │ │ │ 726,000│ ║ ║ └──────────────────┴────┴──────────┴────┴──────────┘ ║ ║ ║ ║ 登録番号: T1234567890123 ║ ║ PDF: ~/.misoca-agent/data/invoices/INV-2026-0042.pdf ║ ╚══════════════════════════════════════════════════════════╝
2. misoca quote
— 見積書作成
misoca quote取引先向けの見積書を作成します。
misoca quote create --client "合同会社テストカンパニー" \ --items "コンサルティング:10:50000:10" "交通費:5:2000:10" \ --valid-until 2026-04-30 \ --title "業務改善コンサルティング見積書"
出力例:
見積書作成完了 番号: QUO-2026-0018 取引先: 合同会社テストカンパニー 有効期限: 2026-04-30 合計: ¥572,000(税込) 明細: 1. コンサルティング 10h × ¥50,000 = ¥500,000 (税10%) 2. 交通費 5件 × ¥2,000 = ¥10,000 (税10%) 小計: ¥510,000 / 消費税: ¥51,000 / 源泉徴収税: ▲¥0 ────────────────────────────────── 合計: ¥572,000(税込) PDF: ~/.misoca-agent/data/quotes/QUO-2026-0018.pdf ステータス: 送付待ち
3. misoca delivery
— 納品書作成
misoca delivery納品書を作成します。見積書・請求書からの変換にも対応しています。
misoca delivery create --from-quote QUO-2026-0018 \ --delivery-date 2026-03-15
出力例:
納品書作成完了 番号: DLV-2026-0012 元見積: QUO-2026-0018 取引先: 合同会社テストカンパニー 納品日: 2026-03-15 品目数: 2件 合計: ¥572,000(税込) PDF: ~/.misoca-agent/data/deliveries/DLV-2026-0012.pdf
4. misoca payment
— 入金管理
misoca payment入金の記録、消込、残高確認を行います。
misoca payment record --invoice INV-2026-0042 \ --amount 726000 --date 2026-03-25 \ --method bank-transfer --bank "三菱UFJ銀行"
出力例:
入金記録完了 請求書: INV-2026-0042(株式会社サンプル商事) 請求額: ¥726,000 入金額: ¥726,000 入金日: 2026-03-25 方法: 銀行振込(三菱UFJ銀行) ステータス: 全額入金済み ✓ 残高: ¥0 消込処理を弥生会計に連携しました。 仕訳: 普通預金 726,000 / 売掛金 726,000
5. misoca report
— 売上レポート
misoca report期間指定で売上レポートを生成します。
misoca report monthly --month 2026-02
出力例:
月次売上レポート(2026年2月) ═══════════════════════════════════════════════════ 請求書発行数: 15件 請求総額: ¥4,830,000 入金済み: ¥3,520,000(72.9%) 未入金: ¥1,310,000(27.1%) 取引先別TOP5: 1. 株式会社サンプル商事 ¥1,200,000 2. 合同会社テストカンパニー ¥890,000 3. 有限会社デザインラボ ¥750,000 4. NPO法人クリエイトネット ¥540,000 5. 個人事業主 山田太郎 ¥320,000 税率別集計: 10%対象: ¥4,500,000(税額 ¥450,000) 8%対象: ¥330,000(税額 ¥26,400) 期限超過請求書: 2件(¥310,000) - INV-2026-0028 ¥180,000(5日超過) - INV-2026-0031 ¥130,000(2日超過)
6. misoca export
— データエクスポート
misoca export請求データを各種形式でエクスポートします。
misoca export csv --period 2026-01:2026-03 --format yayoi
出力例:
エクスポート完了 形式: 弥生会計インポート用CSV 期間: 2026-01-01 〜 2026-03-31 件数: 42件 ファイル: ~/.misoca-agent/data/exports/yayoi_2026_Q1.csv 出力内容: 仕訳日記帳形式(弥生会計オンライン対応) 勘定科目: 売掛金 / 売上高 / 仮受消費税 補助科目: 取引先名を自動設定
7. misoca template
— テンプレート管理
misoca template請求書テンプレートの一覧表示、作成、編集を行います。
misoca template list
出力例:
登録テンプレート一覧 ┌────┬──────────────────┬──────────┬──────────┬──────────┐ │ ID │ テンプレート名 │ 種別 │ 最終更新 │ 使用回数 │ ├────┼──────────────────┼──────────┼──────────┼──────────┤ │ 1 │ 標準請求書 │ 請求書 │ 2026-02 │ 128│ │ 2 │ デザイン業務用 │ 請求書 │ 2026-01 │ 34│ │ 3 │ コンサル見積 │ 見積書 │ 2026-02 │ 22│ │ 4 │ 源泉徴収対応 │ 請求書 │ 2025-12 │ 15│ │ 5 │ 英文Invoice │ 請求書 │ 2025-11 │ 8│ └────┴──────────────────┴──────────┴──────────┴──────────┘
8. misoca client
— 取引先管理
misoca client取引先マスタの管理を行います。
misoca client add --name "新規株式会社" \ --email "keiri@shinki-corp.co.jp" \ --tax-id "T9876543210987" \ --address "東京都港区六本木1-2-3" \ --payment-terms 30
出力例:
取引先登録完了 ID: CLT-0089 会社名: 新規株式会社 メール: keiri@shinki-corp.co.jp 登録番号: T9876543210987(国税庁データベース照合済み) 住所: 東京都港区六本木1-2-3 支払条件: 30日 ステータス: 有効 過去取引: なし(新規取引先)
Workflow Diagram
┌─────────────────────────────────────────────────────────────────┐ │ Misoca Agent ワークフロー │ │ │ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │ │ 見積書 │───▶│ 受注確認 │───▶│ 納品書 │───▶│ 請求書 │ │ │ │ 作成 │ │ │ │ 作成 │ │ 作成 │ │ │ └──────────┘ └──────────┘ └──────────┘ └────┬─────┘ │ │ │ │ │ │ ▼ ▼ │ │ ┌──────────┐ ┌──────────┐ │ │ │ PDF生成 │ │ 送付 │ │ │ │ メール │ │ メール │ │ │ │ 送信 │ │ 郵送代行 │ │ │ └──────────┘ └────┬─────┘ │ │ │ │ │ ▼ │ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │ │ 弥生会計 │◀───│ 仕訳生成 │◀───│ 消込処理 │◀─│ 入金確認 │ │ │ │ 連携 │ │ │ │ │ │ │ │ │ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │ │ │ │ ──── 月次レポート ───────────────────────────────── │ │ │ 売上集計 │ 未入金一覧 │ 取引先別分析 │ CSV出力 │ │ │ └──────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────────────┘
Error Handling
Error 1: OAuth認証期限切れ
[MISOCA-E001] OAuth2トークン期限切れ エラー: access_token has expired 対処: リフレッシュトークンで自動更新を試行中... 結果: 新しいアクセストークンを取得しました。再実行します。
Error 2: 取引先未登録
[MISOCA-E002] 取引先が見つかりません 検索: "株式会社サンフル商事" 候補: "株式会社サンプル商事"(類似度 92%) 対処: 候補の取引先を使用しますか? [Y/n]
Error 3: 登録番号不正
[MISOCA-E003] 適格請求書発行事業者登録番号の検証エラー 入力: T123456789012(12桁) 要件: T + 13桁の数字(合計14文字) 対処: 正しい登録番号を入力してください。 国税庁の公表サイトで確認: https://www.invoice-kohyo.nta.go.jp/
Error 4: 重複請求書検出
[MISOCA-E004] 重複請求書の可能性 検出: 同一取引先・同一金額の請求書が存在します 既存: INV-2026-0042 ¥726,000(2026-03-01発行) 新規: INV-2026-0043 ¥726,000(2026-03-01作成中) 対処: 重複でない場合は --force オプションを付けて再実行してください。
Error 5: API Rate Limit
[MISOCA-E005] APIレート制限に到達 制限: 100リクエスト/分 現在: 102リクエスト(超過: 2件) 対処: 58秒後に自動リトライします... 残りキュー: 3件の処理が待機中
Error 6: PDF生成エラー
[MISOCA-E006] PDF生成に失敗しました 原因: テンプレートに必須フィールドが不足しています 不足: 振込先銀行情報 対処: MISOCA_BANK_NAME と MISOCA_BANK_ACCOUNT を環境変数に設定してください。
Error 7: 弥生会計連携エラー
[MISOCA-E007] 弥生会計との連携に失敗しました 原因: 弥生IDの認証が無効です 対処: 弥生マイポータルから再認証を行ってください。 連携設定画面: Misoca設定 > 外部サービス連携 > 弥生会計
FAQ
Q1: Misocaの料金プランによる制限はありますか?
Misocaには無料プラン、プラン15、プラン100があります。無料プランでは月5通まで、プラン15は月15通まで、プラン100は月100通までの請求書作成が可能です。Misoca AgentはAPIリクエスト数を最適化し、不要なリクエストを削減するよう設計されています。
Q2: インボイス制度に対応していますか?
完全に対応しています。適格請求書発行事業者の登録番号(T+13桁)を環境変数
MISOCA_TAX_REGISTRATION に設定すると、すべての請求書に自動的に記載されます。税率ごとの区分経理、端数処理もインボイス制度の要件に準拠します。
Q3: 源泉徴収税の計算は自動ですか?
はい。請求書作成時に
--withholding オプションを付けると、報酬の種類に応じて源泉徴収税率(10.21%または20.42%)を自動適用します。100万円以下と100万円超で税率が変わる計算にも対応しています。
Q4: 弥生会計オンラインとの連携方法は?
Misocaは弥生グループのサービスのため、弥生IDでログインするだけで自動連携が可能です。請求書の発行・入金消込が弥生会計の仕訳として自動登録されます。勘定科目のマッピングはカスタマイズ可能です。
Q5: 請求書の郵送代行は利用できますか?
Misocaの郵送代行サービスと連携しています。
misoca invoice send --method post --invoice INV-2026-0042 で郵送を依頼できます。1通あたり約160円(税込)で、翌営業日に発送されます。
Q6: 複数の銀行口座を使い分けできますか?
テンプレートごとに異なる振込先を設定できます。
misoca template create --bank "みずほ銀行 新宿支店 普通 7654321" のように、テンプレートに銀行情報を紐づけることで、取引先や案件に応じて振込先を自動で切り替えます。
Q7: 見積書から請求書への変換はできますか?
はい。
misoca invoice create --from-quote QUO-2026-0018 で見積書の全明細行を引き継いで請求書を作成できます。数量や単価の変更がある場合は確認プロンプトが表示されます。
Q8: CSVインポートで一括作成はできますか?
対応しています。
misoca invoice bulk-create --csv ./invoices.csv で、CSVファイルから複数の請求書を一括作成できます。CSVのフォーマットはMisoca標準形式に準拠してください。
Q9: 電子帳簿保存法への対応は?
Misoca Agent はPDFファイルにタイムスタンプを付与し、改ざん検知機能を備えています。検索要件(取引年月日・取引金額・取引先)にも対応した保存を行い、電子帳簿保存法の電子取引データ保存要件を満たしています。
Q10: 英文請求書は作成できますか?
テンプレートを英文用に設定することで対応可能です。
misoca invoice create --template english --currency JPY で英文請求書を作成できます。通貨はJPYのほか、USD、EURにも対応しています(表示のみ、Misoca上の管理はJPY換算)。
Q11: 定期請求書(毎月自動発行)は設定できますか?
misoca invoice recurring --client "株式会社定期取引" --items "月額保守:1:100000:10" --cycle monthly --start 2026-04-01 で毎月自動発行の定期請求書を設定できます。サイクルは monthly(毎月)、quarterly(四半期)、yearly(年次)から選択可能です。
Q12: APIのレート制限はどうなっていますか?
Misoca APIは1分あたり100リクエストの制限があります。Misoca Agentはリクエストの最適化とバッチ処理により、通常の操作ではこの制限に到達しません。万が一到達した場合は自動的に待機し、リトライします。
Data Storage
Misoca Agentのローカルデータは以下のディレクトリ構造で保存されます。
~/.misoca-agent/ ├── config/ │ ├── settings.json # エージェント設定ファイル │ ├── templates/ # カスタムテンプレート │ │ ├── standard.json # 標準請求書テンプレート │ │ ├── design.json # デザイン業務用 │ │ └── english.json # 英文テンプレート │ └── accounts/ # 振込先口座情報 │ ├── primary.json # メイン口座 │ └── secondary.json # サブ口座 ├── data/ │ ├── invoices/ # 請求書PDF・JSON │ │ ├── INV-2026-0001.pdf │ │ ├── INV-2026-0001.json │ │ └── ... │ ├── quotes/ # 見積書PDF・JSON │ │ ├── QUO-2026-0001.pdf │ │ └── ... │ ├── deliveries/ # 納品書PDF・JSON │ │ ├── DLV-2026-0001.pdf │ │ └── ... │ ├── clients/ # 取引先マスタ │ │ ├── CLT-0001.json │ │ └── ... │ ├── payments/ # 入金記録 │ │ └── 2026/ │ │ ├── 01.json │ │ ├── 02.json │ │ └── 03.json │ └── exports/ # エクスポートデータ │ ├── yayoi_2026_Q1.csv │ └── monthly_2026_02.csv ├── logs/ │ ├── api.log # APIリクエストログ │ ├── audit.log # 監査ログ(操作履歴) │ └── error.log # エラーログ ├── cache/ │ ├── tokens.enc # 暗号化トークン │ └── tax_registry.json # 登録番号キャッシュ └── backup/ └── 2026/ ├── 01/ # 月次バックアップ ├── 02/ └── 03/
Comparison Table
| 機能 | Misoca Agent | freee請求書 | マネーフォワード クラウド請求書 | board |
|---|---|---|---|---|
| CLI操作 | 対応 | 非対応 | 非対応 | 非対応 |
| Claude Code統合 | 対応 | 非対応 | 非対応 | 非対応 |
| インボイス制度対応 | 対応 | 対応 | 対応 | 対応 |
| 電子帳簿保存法対応 | 対応 | 対応 | 対応 | 一部対応 |
| API連携 | REST API | REST API | REST API | 限定的 |
| 弥生会計連携 | ネイティブ | 非対応 | 非対応 | 非対応 |
| freee連携 | 非対応 | ネイティブ | 非対応 | 非対応 |
| MF会計連携 | 非対応 | 非対応 | ネイティブ | 非対応 |
| 郵送代行 | 対応(約160円) | 対応(約170円) | 対応(約180円) | 非対応 |
| 源泉徴収自動計算 | 対応 | 対応 | 対応 | 対応 |
| 定期請求書 | 対応 | 対応 | 対応 | 対応 |
| 英文請求書 | 対応 | 対応 | 対応 | 対応 |
| 見積書→請求書変換 | 自動 | 自動 | 自動 | 手動 |
| 無料プラン | 月5通 | 制限付き | 制限付き | なし |
| 月額料金(有料) | 800円〜 | 1,980円〜 | 2,980円〜 | 3,980円〜 |
| 取引先登録番号照合 | 自動 | 自動 | 自動 | 手動 |
| バッチ処理 | 対応 | 非対応 | 非対応 | 非対応 |
| オフライン操作 | ローカルキャッシュ | 非対応 | 非対応 | 非対応 |
| 操作ログ・監査証跡 | 詳細ログ | 基本ログ | 基本ログ | なし |
Misoca Agentの最大の優位性は、弥生グループのエコシステムとのネイティブ連携、Claude Codeからのコマンドライン操作、そして請求書作成から入金管理・会計連携までのワークフロー全体を自動化できる点にあります。特にフリーランスや中小企業が弥生会計を利用している場合、仕訳データの手動入力が不要になり、月次決算の工数を大幅に削減できます。
License
MIT License - hanabi-jpn