API / MCP

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

REST API

/v1/* で機械可読 JSON

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

https://hojindb.jp/mcp

Claude / ChatGPT その他 MCP クライアントから法人番号ベースで直接呼び出せます（JSON-RPC over HTTP POST）。

認証

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

REST API エンドポイント

GET/v1/corp/{corporate_number}

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

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必須）

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

API キーの発行

フォームからメールアドレスと用途を送るだけ。確認のうえメールでキーをお送りします（無料・商用利用可）。

API キーの発行をリクエスト

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

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