jp-corporate 法人番号 API 無料
法人番号 API を、申請なしで AI から使う
13桁の法人番号や法人名を AI エージェントにそのまま聞けます。国税庁法人番号公表サイトの公表データにもとづく正式名称・所在地・閉鎖の有無が、出典と差分反映日つきで返ります。
できること
法人番号 API でできること
13桁の法人番号で1件に確定する
lookup_corporate は法人番号による確定照会と、名称・所在地による候補探索を切り替えます。例では 1180301018771 に対して「トヨタ自動車株式会社、愛知県豊田市トヨタ町1番地、閉鎖なし」が返ります。
例: lookup_corporate {"corporateNumber": "1180301018771"}
番号を渡すときはハイフンなし13桁の文字列で指定します。name・prefecture・address は外してください(併用できません)。
法人名・所在地から候補を探す
法人名だけで探す場合は都道府県を添えてください。prefecture は「13」でも「東京都」でも指定できます。所在地で絞りたいときは address も渡せます。
例: lookup_corporate {"name": "ソニーグループ株式会社", "prefecture": "東京都"}
前方一致の限界
検索は前方一致だけです。「ソニー」では見つかりますが「グループ」「自動車」では見つかりません。正式名称の先頭から入れてください。都道府県を省くと全国から探します(1回最大20件)。
名称だけでは1件に確定しません。候補が返ったら、最後は候補の法人番号で照会して確定します。limit は1〜20件で、省略時は10件です。
人間の聞き方:
「1180301018771 の法人を教えて」
「ソニーグループ株式会社を東京都で探して」
「この候補の法人番号で正式名称を確定して」 返答の根拠
返答には出典と差分反映日が付きます
出典: 国税庁法人番号公表サイト(https://www.houjin-bangou.nta.go.jp/)を加工して作成。法人番号データは国税庁の差分データを毎日取り込んでいます(反映に1〜2日)。最新の反映日は応答の「差分反映」欄に出ます。
すべての返答に出典が付きます。重要な判断では一次情報も確認してください。
国税庁 Web-API/他有料 API との違い
申請なしで、会話のまま照会する
ID の発行申請が要らない
国税庁の法人番号 Web-API は無料ですが、利用にはアプリケーションIDの発行申請が必要です。plugrail は接続先 URL を追加するだけですぐ使えます。認証は任意で、ログインしなくても月100回まで使えます。
JSON ではなく会話で聞く
法人番号や法人名を貼って「調べて」と頼むだけで、AIエージェントがツールを呼び出して結果を整理します。返答の生の JSON を自分で読む必要はありません。
出典が付く
返答には国税庁の公表サイトの出典と差分反映日が付きます。AIエージェントの答えをうのみにせず、出典元で確かめられます。
インボイス登録番号とのつなぎ
登録番号の照合は、インボイスのページへ
T から始まる適格請求書発行事業者登録番号の照合には verify_invoice_number を、法人名や所在地の確定には lookup_corporate を使います。どちらも同じ jp-corporate の MCP 接続から呼び出せます。ツールの引数やコード例、制約はインボイス 登録番号 API のページにまとめています。
つなぎ方
接続は3ステップ
- 無料キー登録でアカウントを作る(ログインしなくても月100回まで使えます/キーの管理は /dashboard/)
- 下のコマンドで MCP サーバーを追加する(接続先URL:
https://jp-corporate.plugrail.dev/mcp) - AI エージェントに上の「人間の聞き方」の質問を投げる
Claude Code の場合は、ターミナルで次のコマンドを実行します。
claude mcp add --transport http jp-corporate https://jp-corporate.plugrail.dev/mcp 料金と上限
無料ではじめる
匿名・無料アカウントとも月100回まで無料です(暦月・日本時間、カード不要)。回数は日本時間の毎月1日にリセットされます。数えるのはツールの呼び出し(tools/call)だけです。limit で20件取得しても、回数は1回です。
- 短時間の集中利用には分あたりの上限があります(ログインなしは1分あたり10回、無料アカウントは60回)。
- プロは月次の回数制限がなく、毎分600回まで使えます(月額9,800円・税込)。
- SLA は設けていません。
プランの比較は料金のページにもまとめています。
注意
ご利用前に
- 無料枠で数えるのはツールの呼び出し(tools/call)だけです。回数は日本時間の毎月1日にリセットされます。ログインなしは IP アドレス単位、アカウントでは所有者単位で数えます。
- 元データは国税庁法人番号公表サイトの公表情報(ダウンロードデータ)です。国税庁における法人情報の変更が本サービスに反映されるまでには時間差が生じます。
- 名称検索は前方一致です。候補から正式名称を確定する場合は、最後に法人番号で照会してください。
- 取引先の確認や下調べを手早く済ませるためのサービスです。確実性を要する判断では、公表サイトの原本もあわせて確かめてください。
- SLA は設けていません。
質問
よくある質問
-
どのAIエージェントで使えますか
MCP 対応のクライアントから使えます。接続先URLはリモート MCP(Streamable HTTP)方式です。
-
13桁の法人番号が分からないときは
nameとprefectureで候補を探し、最後に候補の法人番号で照会して確定します。都道府県を省くと全国検索になります。 -
前方一致とはどういう意味ですか
正式名称の先頭から入力するという意味です。名称の途中にある語(例: 「グループ」「自動車」)だけでは見つかりません。
-
法人情報が古いときは
差分データを毎日取り込んでいますが、反映に1〜2日かかります。最新の反映日は応答の「差分反映」欄で確認できます。
-
月100回で足りますか
1回のツール呼び出しで1回として数えます。
limitを指定して20件の候補を取得しても1回です。100回を使い切ったら、日本時間の翌月1日のリセットを待ってください。
エラーが出たとき
よくあるエラーと対処
| 返ってくる内容 | 原因 | 対処 |
|---|---|---|
| HTTP 401「認証に失敗しました。」 | APIキーの形式が違うか、失効している | 管理画面でキーを確かめ、Authorization: Bearer <キー> で送り直す。キーなしでも月100回までは使える |
| HTTP 429「レート制限を超過しました。」 | 1分あたりの上限(ログインなし10回・無料60回・プロ600回)に達した | 返ってきた Retry-After の秒数だけ待って再試行する |
| 「今月の無料枠(100回)を超えました。」 | 日本時間の今月、ツール呼び出しが100回を超えた | 翌月1日に回数が戻る。続けて使うならプロ(月額9,800円・税込)へ |
invalid_input | 番号の桁が足りないなど、入力の形が違う | ページ上部の入力例の形に合わせる |
まず動くか確かめる(curl)
curl -s https://jp-corporate.plugrail.dev/mcp \
-H 'content-type: application/json' \
-H 'accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' ツールの一覧が返れば接続はできています。
次の一歩
まず1件、法人番号で照会してみる
手元の法人番号を1件、AI エージェントに聞いてみてください。キー登録は後からでもできます。