Gbizinfo

@pipeworx/gbizinfo

日本の法人登録情報 — 13 桁の法人番号をキーとして、企業プロフィール、政府調達の落札情報、補助金、特許、認証、財務情報、職場に関する公開情報を取得します。データソース：gBizINFO、経済産業省（METI）。

Pipeworx の一部です。AI エージェントを 1879 件以上のリアルタイムデータソースに接続する MCP ゲートウェイです。これは独立した非公式の統合であり、上流のプロバイダーとは提携関係になく、承認も受けておらず、公開もされていません。

ツール

• gbiz_company_search(name?, prefecture?, city?, corporate_type?, has?, capital_min?, capital_max?, employees_min?, employees_max?, founded_year?, limit?, page?, _apiKey) — 企業とその法人番号を検索します。

• gbiz_company_profile(corporate_number, _apiKey) — 登録プロフィール：法人名、カナ表記とローマ字表記、住所、代表取締役、資本金、従業員数、設立日、事業概要、ウェブサイト、解散情報。

• gbiz_company_procurement(corporate_number, limit?, _apiKey) — 日本政府からの落札契約：発注日、件名、金額（円）、発注省庁。

• gbiz_company_subsidies(corporate_number, limit?, _apiKey) — 受給した補助金・助成金：承認日、制度名、金額、交付省庁。

• gbiz_company_records(corporate_number, kind, limit?, _apiKey) — patent、certification、commendation、finance、workplace のいずれか。

  5 種類のレスポンス形式は共通ではありません。 patent、certification、commendation は、種類に一致するキーの下にあるリストとして返され、returned と total_on_record の件数を含みます。finance と workplace は会社ごとに 1 件のレコードであるため、オブジェクトとして返されます。finance は finance の下に返されます（会計基準、会計年度の表紙、management_index の期間別データ、major_shareholders）。職場の統計情報は workplace_info の下に返されます。このキーが workplace という種類名と一致しないのは、上流の API がそのように返すためです。オブジェクト形式の種類では、limit は内部にネストされた配列の件数を制限し、total_on_record は単一の数値ではなく、配列ごとのマップになります。

認証

2026-09-13 よりプラットフォームキーを利用可能（fleet #1940）。 ゲートウェイが PLATFORM_GBIZINFO_KEY を保持して注入するため、呼び出し元が独自のキーを用意する必要はありません。独自のトークンとクォータを使いたい場合は、引き続き _apiKey も利用できます。

最初のリリースは BYOK のみで、意図的に platformKeyEnv を設定していませんでした。そのため、キーが存在しない間はゲートウェイの keyBlockedTools() によって、これらのツールはルーティング対象から除外されていました。日本企業に関する質問を、拒否することしかできないツールに送るより、正直に no_match を返すほうがよいためです。シークレットと platformKeyEnv は同じ変更で追加されました。この順序を徹底するためのルールは、fda-inspections の先例（fleet #617）に基づいています。

独自のトークンを使うには、https://info.gbiz.go.jp/hojin/various_registration/form で無料登録してください。**日本在住でない申請者も登録できます。**フォームの利用者区分ラジオボタンには、法人担当者（法人向け。13 桁の法人番号、日本の会社名、部署、郵便番号、住所、電話番号が必要）と、個人利用者があります。個人利用者に必要なのは、メールアドレス、パスワード、利用目的、2 つの同意チェックボックスだけです。この違いにより、gBizINFO は、個人向けの選択肢がなく日本の法人番号を使った申請が必須の NTA 法人番号 API とは異なり、利用できます。トークンはメールで届きます。

公開 OpenAPI ドキュメント https://api.info.gbiz.go.jp/hojin/v3/api-docs?group=v2 の info.description にはトークンが埋め込まれています。同じ文には、日本語で、Swagger ページ上での動作確認のみに使用する旨が記載されています。構築時にレスポンス形式を確認するのには便利です。ただし、配布するための認証情報ではなく、このパックにも含まれていません。

把握しておきたい上流の挙動

• トークンがない場合、HTTP 401 ではなく 500 になります。 ヘッダーを省略すると、gBizINFO は 500 - Internal Server Error. を返します。誤ったトークンの場合は、正常に 401 が返ります。そのまま受け渡すと、認証情報の欠落が上流の障害として扱われます。ここでは認証拒否に変換しています。
• ホストは api.info.gbiz.go.jp、バージョンは v2 です。 info.gbiz.go.jp に直接アクセスすると、/hojin/v1/... は同じ 500／401 の挙動を返すため、v2 にアクセスして HTML の 404 が返るまでは、正しいベース URL のように見えます。
• 結果がない場合は HTTP 404 です — 存在しない法人番号や形式が不正な法人番号の場合と同じステータス、同じ本文です。検索ではこれは該当なしを意味し、通常の応答です。見つからないと報告できるのは、番号による検索だけです。
• 応答に合計件数は含まれません。 エンベロープは {id, errors, message, hojin-infos} だけで、件数も次ページのマーカーもありません。limit の上限は 5000、page の上限は 10 です。ここでは与えられていない合計件数を示すことはせず、検索では代わりに more_pages_possible を返します。
• 配列が空の 200 は、実在する企業にその種類の記録がないことを示す通常の応答です。 トヨタの /subsidy は空です。このような企業をスモークテストに使わないでください。何も証明しないテストが成功してしまいます。苫小牧市（1000020012131）には61件の補助金があります。

法人番号の代わりに企業名を指定できます

gbiz_company_profile、gbiz_company_procurement、gbiz_company_subsidies、gbiz_company_records は、13桁の法人番号または企業名を受け付け、名前から解決された場合は resolved_from として返します。これは単なる利便性ではありません。プラットフォームキーが使えるようになった日に確認したところ、ルーターは呼び出し元がたまたま持っている引数ではなく、質問に一致する説明を基準にツールを選ぶため、ask_pipeworx は "what Japanese government procurement contracts has Toyota Motor received?" という質問を、数値以外の引数のまま gbiz_company_procurement に直接渡していました。先に gbiz_company_search を呼び出すよう文章で指示しても、状況は変わりません。

一致判定では、比較前に法人格の語句を取り除きます — 登記上の名称はトヨタ自動車株式会社です。この正規化を導入するまでは、トヨタ自動車 だけを指定すると、ちょうど10件の申請者に一致していました。また、株式会社は企業によって名称の前に付く場合も後ろに付く場合もあります。複数の申請者に一致する名前の場合は、最初の候補を採用せず、候補を列挙して処理を拒否します。誤った企業について自信ありげに回答することこそ、このパッケージが特に防ごうとしている問題です。

呼び出し側が陥りやすい落とし穴

ラテン文字での名前検索では、探している企業が見つかりません。 name=Toyota はローマ字表記の名前フィールドに一致します。このフィールドは多くの日本企業で空欄で、市区町村などの団体が大部分を占めています。そのため、正常な 200 とともにトヨタ自動車株式会社ではなく豊田市稲橋財産区（"Toyota City Inahashi property ward"）が返されます。ツールの説明にもその旨があり、ラテン文字のクエリには実際に一致したフィールドを示す match_note が含まれます。特定の企業を指定する場合は、法人番号が確実です。

データソース

• REST API v2：https://api.info.gbiz.go.jp/hojin/v2/ — 仕様書は https://api.info.gbiz.go.jp/hojin/v3/api-docs?group=v2、Swagger UI は https://api.info.gbiz.go.jp/hojin/swagger-ui/index.html?urls.primaryName=v2
• 公開元：経済産業省 / METI（法人番号 4000012090001）、https://info.gbiz.go.jp/

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

{
  "mcpServers": {
    "gbizinfo": {
      "url": "https://gateway.pipeworx.io/gbizinfo/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/gbizinfo/mcp の tools/list は、上の表にあるツールに加えて、共有の Pipeworx メタツールである ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で利用できるツール一式を返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック固有のツールに加えて、共有ツールが約30個表示されます。接続の initialize レスポンスに正確な対象範囲が記載されており、その日の状況を知るための正式な情報源です。

これは意図的な設計であり、偶然に多重化されているわけではありません。メタツールを使うことで、このパックが対応していない質問にも、カタログ全体を横断してルーティングする ask_pipeworx を通じて回答できます。そのため、MCP サーバーをもう1つ追加する必要はありません。現時点では、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによって得られるコンテキストよりもルーティングのメリットが小さい場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度接続してください。

または、Pipeworx のフルゲートウェイに接続すると、このパックだけではなく、すべてのパックのツールが直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も同じゲートウェイと同じ1879以上のデータソースにアクセスします。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントがない場合：HTTP 経由で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/gbiz_company_search \
  -H 'Content-Type: application/json' \
  -d '{"name":"トヨタ自動車","limit":3}'

最初の呼び出しにアカウントは不要です。ツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/gbiz_company_search を実行します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても動作します。Pipeworx アカウントも、ゲートウェイへの往復通信も不要です。

{
  "mcpServers": {
    "gbizinfo": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-gbizinfo"]
    }
  }
}

または、直接実行して起動を確認できます。

npx -y @pipeworx/mcp-gbizinfo

stdin/stdout 経由で MCP を使用し、このパック固有のツールのみに対して initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使用する

ツールを直接呼び出す代わりに、平易な英語で質問できます。これは上記のパックエンドポイントでも、フルゲートウェイでも利用できます。

ask_pipeworx({ question: "your question about Gbizinfo data" })

ゲートウェイが適切なツールを選び、引数を自動で入力します。

詳細情報

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT