税理士事務所の月次顧問先一括レビュー¶

想定 user¶

所員 3-10 名・顧問先 50-300 社 (法人 7 割 / 個人事業 3 割) の中堅税理士事務所。月初の巡回監査前に、各顧問先について「直近 30 日の補助金採択公表」「適格事業者番号の有効性」「行政処分 / 公表事案の有無」「未申請の合致補助金 top3」を一括で取得し、面談時の話題と提案ネタを揃えたい所長・科目担当者を主たる対象とする。所要時間や業務成果は顧問先数・確認項目・社内確認フローで変わるため、本 recipe では固定の短縮値を公開 claim にしない。

必要な前提¶

jpcite API key (標準従量料金、初回 3 req/IP/日無料、JST 翌日 00:00 リセット)
X-Client-Tag ヘッダ (顧問先別計上、api_keys 親子発行で子キー fan-out 可)
顧問先の法人番号リスト (CSV / Excel / 弥生・PCA・freee・MF 等の会計 SW export)
(任意) client_profiles テーブルへ事前登録 (JSIC 業種 + 設立年 + 都道府県) すると subsidy_matches の fit_score が +0.1-0.2 改善

入力例¶

{
  "corp_numbers": ["7010001234567", "8010001234568"],
  "months_back": 1,
  "client_tag": "kojin-001",
  "include": ["adoption", "invoice", "enforcement", "subsidy_match"],
  "subsidy_top_n": 3,
  "language": "ja"
}

- corp_numbers: 13 桁法人番号 (国税庁付番)。1 req あたり最大 200 件、超過時は自動 chunk。 - months_back: 採択 / 処分を遡る月数 (1-12)。月次運用は 1。 - client_tag: 課金行に付与される識別子。顧問先別請求書発行に使う。 - subsidy_top_n: 1 法人あたりの推奨補助金件数 (1-10、既定 3)。

実行 (curl / Python / TypeScript)¶

curl¶

# 1 社単位の 360 view
curl -H "X-API-Key: $JPCITE_API_KEY" \
     -H "X-Client-Tag: kojin-001" \
     "https://api.jpcite.com/v1/houjin/{houjin_bangou}/360"

# 100 社 bulk
curl -X POST -H "X-API-Key: $JPCITE_API_KEY" \
     -H "X-Client-Tag: kojin-001" \
     -H "Content-Type: application/json" \
     -d @clients.json \
     "https://api.jpcite.com/v1/houjin/{houjin_bangou}/360"

Python¶

import os, json
# MCP tool calls via: claude mcp add jpcite -- uvx autonomath-mcp
mcp = connect_mcp('jpcite')  # uvx autonomath-mcp
clients = json.load(open("clients.json"))
review_rows = []
for cn in clients["corp_numbers"]:
    snap = mcp.call_tool("get_houjin_360_am",
        houjin_bangou=cn,
        include=["adoption", "invoice", "enforcement", "subsidy_match"],
        months_back=1,
        client_tag=cn,
    )
    review_rows.append({
        "corp": cn,
        "invoice_ok": snap.invoice_registered,
        "new_adoption": len(snap.adoptions_30d),
        "top_subsidy": (snap.subsidy_matches_top3[:1] or [{}])[0].get("program_id"),
        "enforcement": bool(snap.enforcement_30d),
    })
import pandas as pd
pd.DataFrame(review_rows).to_excel("monthly_review_2026-05.xlsx", index=False)

TypeScript¶

// MCP tool calls via: npx @bookyou/jpcite (MCP server)
import fs from "node:fs";
const clients = JSON.parse(fs.readFileSync("clients.json", "utf8"));
const rows: any[] = [];
for (const cn of clients.corp_numbers) {
  const s = await mcp.call_tool("get_houjin_360_am", {
    corp_number: cn,
    include: ["adoption", "invoice", "enforcement", "subsidy_match"],
    months_back: 1,
    client_tag: cn,
  });
  rows.push({ corp: cn, invoice: s.invoice_registered, top: s.subsidy_matches_top3?.[0]?.program_id });
}
fs.writeFileSync("monthly_review.json", JSON.stringify(rows, null, 2));

出力例 (artifact)¶

{
  "corp_number": "7010001234567",
  "fetched_at": "2026-05-11T09:00:00Z",
  "source_url": "https://api.jpcite.com/v1/houjin/{houjin_bangou}/360",
  "invoice_registrant": {"registered": true, "registered_date": "2023-10-01"},
  "adoptions_30d": [],
  "enforcements_30d": [],
  "subsidy_matches_top3": [
    {"program_id": "UNI-XXXXXXXXXX", "name": "ものづくり補助金 第18次", "fit_score": 0.82, "tier": "S", "source_url": "https://portal.monodukuri-hojo.jp/..."}
  ],
  "client_tag": "kojin-001",
  "known_gaps": ["municipal lag 7-14d"]
}

known gaps¶

市町村独自補助金は ingest 周期で 7-14 日遅延、S/A tier は当日反映
過去採択履歴は顧問先自己申告依存、jPubs API で完全捕捉できないケースあり
subsidy_top_n=10 超の一括評価は /v1/me/clients/bulk_evaluate で分割実行、本 recipe は top3 想定
enforcement の 公表 → 取込 は 24-72 時間ラグ

billable_units 試算¶

外部 model/search API fee との比較は、同一 query / model / token / web_search_rounds / cache_state / fx_rate / run_at を含む benchmark artifact が揃うまで公開しない。
1 顧問先 1 unit (get_houjin_360_am) × ¥3 = ¥3 / 顧問先 / 月
顧問先 100 社 = ¥300 / 月、税込 ¥330
年 12 ヶ月 = ¥3,600 / 年、税込 ¥3,960

商業利用条件¶

PDL v1.0 + CC-BY-4.0、出典明記必須
月次レポート / 顧問先伴走資料への組込・印刷頒布 OK
第三者配布は別途要相談

業法 fence¶

税理士法 §52 (税務代理 / 税務書類作成 / 税務相談は税理士独占)
中小企業診断士登録規則 — 経営助言 / 補助金申請伴走は診断士領域
行政書士法 §1の2・§19 — 申請書面作成は行政書士、本 recipe は項目整理 + 一次 URL まで
景表法 §5 — fit_score / max_amount_jpy は推定値、保証ではない旨を末尾注記推奨