API / MCP

法人番号で法人プロファイルを取得・検索できます。代表者氏名はレスポンスに含まれません（会社詳細ページの閲覧表示のみ）。ベータ提供中（無料）。

REST API

/v1/* で機械可読 JSON。現在3件の/v1エンドポイント

/v1/corp/{法人番号} 法人プロファイル取得
/v1/corp?q=… 商号・地域・業種で検索

MCP Server

https://hojindb.jp/mcp

現在5種類のMCPツールを、Claude / ChatGPT その他 MCP クライアントから直接呼び出せます（JSON-RPC over HTTP POST）。

認証

全 /v1 と /mcp リクエストに X-API-Key ヘッダが必要です。Web 閲覧は認証不要です。

REST API エンドポイント

GET/v1/corp/{corporate_number}

法人番号（13桁）で法人プロファイルを取得。商号・所在地・業種・資本金・従業員数・事業概要・出典など（代表者氏名は含まれません）。

employees は公表従業員数（gBizINFO）。公表値が無い企業では insured_count（厚生年金被保険者数にもとづく推定従業員規模。公表従業員数ではなく、短時間労働者等の厚生年金適用外は含まれません。insured_count_note/insured_count_source を併記）を返します。

curl -H "X-API-Key: $KEY" https://hojindb.jp/v1/corp/1180301018771

GET/v1/corp

商号 q / 都道府県 pref / 業種 industry で検索（いずれか必須）。limit（最大100）/offset。人物名逆引きは非対応。

curl -H "X-API-Key: $KEY" "https://hojindb.jp/v1/corp?q=トヨタ&pref=愛知県"

MCP Server 接続

URL

https://hojindb.jp/mcp

Protocol

JSON-RPC 2.0 over HTTP POST

認証

X-API-Key ヘッダ

課金

1 tools/call = 1。initialize / tools/list は対象外

提供ツール

tool	用途
`get_corporate_profile`	法人番号で法人プロファイル取得（代表者氏名なし）
`report_data_issue`	データ誤りの報告（原典URL必須）
`search_corporations`	商号・都道府県・業種で法人を検索
`get_building_cluster`	同一ビル・同一番地の公開法人を確認
`get_discovery_facets`	業種・都道府県の件数を取得

Claude Desktop / Claude.ai のカスタムコネクタに上記 URL と API キーを設定すると、対話の中から法人番号で参照できます。

利用プラン

プラン	月額	日次上限	分次上限
β版無償	¥0	100件/日	10件/分

ベータ期間中は全ユーザーが同一プランです。上限超過は 429 + Retry-After を返します。詳細は料金・プランをご覧ください。

API キーの発行

メールアドレスを入力するだけで、その場でAPIキーが発行されます（無料・商用利用可）。

無料でAPIキーを発行

大量・特別な用途は hojindb@cabocia.jp までご相談ください。

課金単位: 1 REST リクエスト = 1 / 1 MCP tools/call = 1。initialize・tools/list・4xx/5xx は対象外。レスポンスに代表者氏名は含まれません（個人情報保護のため、詳細ページの閲覧表示のみ）。