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ステップ

  1. 無料キー登録でアカウントを作る(ログインしなくても月100回まで使えます/キーの管理は /dashboard/)
  2. 下のコマンドで MCP サーバーを追加する(接続先URL: https://jp-corporate.plugrail.dev/mcp)
  3. 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 は設けていません。

質問

よくある質問

エラーが出たとき

よくあるエラーと対処

返ってくる内容 原因 対処
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 エージェントに聞いてみてください。キー登録は後からでもできます。