# Shirabe Corporation Number API — Japan Corporate Number (法人番号) Lookup & Validation

> 日本の法人番号(13 桁)の lookup・商号検索・checksum 検証・商号正規化・一括 lookup を提供する AI ネイティブ REST API。
> 国税庁法人番号公表サイトの公表データ(全国 約 580 万法人)を日次差分で自動同期。
> Japan corporate number (houjin bangou) lookup, search, validation, and normalization REST API,
> backed by the National Tax Agency's public corporate number registry, synced daily.
> Designed for LLMs and AI agents via OpenAPI 3.1 and GPT Function Calling.

Shirabe Corporation Number API は「生成 AI が勝手に使い出す」ことを判断基準に設計された法人番号 API です。
リリース: 2026-06-29(v1.0.0)。

統合プラットフォーム版の [llms.txt](https://shirabe.dev/llms.txt) もあわせて参照してください(暦 / 住所 / テキスト処理 API の情報も記載)。

## 今すぐ試す / Try it now(API キー不要・登録不要)

    # 法人番号 1 件の lookup(匿名 Free 枠 月 5,000 回)
    curl -X POST https://shirabe.dev/api/v1/corporation/lookup \
      -H "Content-Type: application/json" \
      -d '{"law_id": "7000012050002"}'

    # 商号の前方一致検索(prefecture_code = 2 桁都道府県コードで絞り込み可)
    curl -X POST https://shirabe.dev/api/v1/corporation/search \
      -H "Content-Type: application/json" \
      -d '{"name": "トヨタ自動車", "prefecture_code": "23"}'

    # 法人番号の形式・checksum・実在の 3 段判定
    curl -X POST https://shirabe.dev/api/v1/corporation/validate \
      -H "Content-Type: application/json" \
      -d '{"law_id": "7000012050002"}'

## SDK / エージェント統合 / SDK & agent frameworks

公式 SDK `shirabe-sdk`(npm / PyPI、core 依存ゼロ)で Vercel AI SDK / LangChain / OpenAI Agents SDK の tool として直接呼べます。

    npm install shirabe-sdk

    import { shirabeAITools } from "shirabe-sdk/ai";                // Vercel AI SDK(shirabe_lookup_corporation ほか 7 tool)
    import { shirabeLangChainTools } from "shirabe-sdk/langchain";  // LangChain
    import { ShirabeClient } from "shirabe-sdk";                    // 薄い REST クライアント(lookupCorporation / validateCorporation ほか)

    # Python(PyPI も `shirabe-sdk`、import 名は shirabe)
    pip install "shirabe-sdk[langchain]"   # または "shirabe-sdk[openai-agents]"

    from shirabe.langchain import shirabe_langchain_tools          # LangChain(同じ 7 tool)
    from shirabe.openai_agents import shirabe_openai_agents_tools  # OpenAI Agents SDK
    from shirabe import ShirabeClient                               # 薄い REST クライアント

## API 仕様 / API spec

- [OpenAPI 3.1 仕様 (日英併記)](https://shirabe.dev/api/v1/corporation/openapi.yaml)
- [OpenAPI 3.1 GPTs 短縮版 (GPT Builder Actions 互換)](https://shirabe.dev/api/v1/corporation/openapi-gpts.yaml)
- [ヘルスチェック](https://shirabe.dev/api/v1/corporation/health)

## エンドポイント / Endpoints

- `POST /api/v1/corporation/lookup` — 法人番号 → 法人情報(商号・所在地・法人種別・閉鎖情報)
- `POST /api/v1/corporation/search` — 商号の前方一致検索(prefecture_code / city_code で絞り込み可)
- `POST /api/v1/corporation/validate` — 法人番号の形式・checksum(mod 9)・実在の 3 段判定
- `POST /api/v1/corporation/normalize` — 商号表記の正規化 + 法人種別の分離
- `POST /api/v1/corporation/batch` — 複数法人番号の一括 lookup
- `GET /api/v1/corporation/health` — ヘルスチェック(認証不要・カウント対象外)

## ドキュメント / Documentation

- [法人番号 API ドキュメント](https://shirabe.dev/corporation/docs): 全 5 endpoint の仕様・実レスポンス・エラー・上限
- [製品ページ・料金](https://shirabe.dev/corporation/): Free / Starter / Pro / Enterprise の詳細
- [新規法人番号指定の月次統計](https://shirabe.dev/corporation/new/): 全国・都道府県別の確定値ページ(毎営業日自動更新)

## 料金プラン / Pricing

| プラン | 月間上限 | 単価(円/回) | Free 枠 | レート制限 |
|---|---|---|---|---|
| Free | 5,000 | 無料 | 5,000 | 1 req/s |
| Starter | 200,000 | 0.5 | 5,000 | 30 req/s |
| Pro | 2,000,000 | 0.3 | 5,000 | 100 req/s |
| Enterprise | 無制限 | 0.1 | 5,000 | 500 req/s |

全プランに 5,000 回/月の Free 枠(API キー不要)。
**有料プランの新規申込は現在受付を一時停止しています**(お問い合わせ: support@shirabe.dev)。

## AI 統合経路 / AI Integration Paths

- **Function Calling / Tool Use**: OpenAPI 3.1 仕様(日英併記)から自動スキーマ生成可
- **ChatGPT GPTs**: GPTs 短縮版 spec(上記)を GPT Builder Actions に読込可
- **リモート MCP サーバー**: `https://shirabe.dev/mcp`(法人番号 tool を含む)
- **LangChain / Dify**: OpenAPI loader でそのまま使用可能

## データ出典・attribution / Data Attribution

本 API のレスポンスは国税庁法人番号公表サイトの公表データを基盤とし、全レスポンスに `attribution` フィールドを付与します(公共データ利用規約 第 1.0 版 第 6 条 + LLM 経由の出典伝搬)。Shirabe 側で正規化・加工した場合は `attribution.modified=true` と `modification_notice` を返します。

- **元データ**: 国税庁法人番号公表サイト(公共データ利用規約 第 1.0 版)
- **API 運営**: 株式会社テックウェル(福岡)

## 運営・連絡先 / About

- OpenAPI 仕様: <https://shirabe.dev/api/v1/corporation/openapi.yaml>
- プラットフォーム全体の [llms.txt](https://shirabe.dev/llms.txt)(暦 / 住所 / テキスト処理 API の情報含む)
