# Shirabe — Japan-specific AI-Native API Platform

> 日本特化 AI ネイティブ API プラットフォーム。暦・住所・日本語テキスト処理を AI エージェント向けに提供。
> Japan-specific AI-native API platform providing calendar, address normalization,
> and Japanese text processing APIs for AI agents. Built on strict OpenAPI 3.1 compliance
> so that LLMs can discover and invoke these APIs without manual integration.

Shirabeは「生成AIが勝手に使い出す」ことを判断基準に設計された日本特化AIネイティブAPIプラットフォームです。
OpenAPI 3.1準拠で、ChatGPT GPTs / Claude Tool Use / Gemini Function Calling / LangChain / Dify から即利用できます。
暦 API・住所 API(2026-05-01 リリース)・テキスト処理 API(2026-05-18 リリース)・法人番号 API(2026-06-29 リリース)いずれも本番稼働中(v1.0.0)。

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

    # 暦: 指定日の六曜・暦注・干支・二十四節気(匿名 Free 枠 月 10,000 回)
    curl https://shirabe.dev/api/v1/calendar/2026-07-06

    # 住所: 住所正規化(匿名 Free 枠 月 5,000 回)
    curl -X POST https://shirabe.dev/api/v1/address/normalize -H "Content-Type: application/json" -d '{"address": "東京都港区六本木6-10-1"}'

    # テキスト: 姓名分割(匿名 Free 枠 月 10,000 回)
    curl -X POST https://shirabe.dev/api/v1/text/name-split -H "Content-Type: application/json" -d '{"name": "山田太郎"}'

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

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

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

    npm install shirabe-sdk

    import { shirabeAITools } from "shirabe-sdk/ai";                // Vercel AI SDK(住所・氏名・法人番号・暦の 7 tool)
    import { shirabeLangChainTools } from "shirabe-sdk/langchain";  // LangChain
    import { ShirabeClient } from "shirabe-sdk";                    // 薄い REST クライアント(enrich で 4 identifier を 1 コール)

    # 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 クライアント

## APIs

### 1. Shirabe Calendar API (本番稼働中 / Production)

日本の暦(六曜・暦注・干支・二十四節気)と用途別吉凶判定を天文学的精度で返す REST API。

- [OpenAPI 3.1 仕様 (日英併記)](https://shirabe.dev/openapi.yaml)
- [OpenAPI 3.1 GPTs短縮版 (description ≤ 300字)](https://shirabe.dev/openapi-gpts.yaml)
- [GPT Store (Japanese Calendar)](https://chatgpt.com/g/g-69e98031b5b8819185ae196a9f219090-shirabe-ri-ben-noli-japanese-calendar)
- [暦 API ドキュメント](https://shirabe.dev/calendar/docs)
- [暦 API 製品ページ・料金](https://shirabe.dev/calendar/)

### 2. Shirabe Address API (本番稼働中 / Production)

日本の住所正規化(全 47 都道府県、ABR データ準拠)。都道府県〜番地レベルで構造化、座標付与対応。

- [OpenAPI 3.1 仕様 (日英併記)](https://shirabe.dev/api/v1/address/openapi.yaml)
- [OpenAPI 3.1 GPTs短縮版](https://shirabe.dev/api/v1/address/openapi-gpts.yaml)
- [GPT Store (Japanese Address)](https://chatgpt.com/g/g-69e96000b5c08191b21f4d6570ead788-shirabe-ri-ben-nozhu-suo-japanese-address)
- [住所 API ドキュメント](https://shirabe.dev/address/docs)
- [住所 API 製品ページ・料金](https://shirabe.dev/address/)
- [住所 API 専用 llms.txt](https://shirabe.dev/api/v1/address/llms.txt)
- [全国 市区町村 団体コード一覧(1 市区町村 = 1 URL の確定値ページ、全 47 都道府県 約 1,900 件)](https://shirabe.dev/address/areas/)

### 3. Shirabe Text API (本番稼働中 / Production)

日本語テキスト処理(姓名分割・人名読み推定・ふりがな付与・形態素解析・表記正規化)。Lindera-wasm + IPAdic v3.0.7 ベースで Cloudflare Workers 単層稼働。住所 API と同一顧客層へのクロスセル想定。

- [OpenAPI 3.1 仕様 (日英併記)](https://shirabe.dev/api/v1/text/openapi.yaml)
- [テキスト API ドキュメント](https://shirabe.dev/text/docs)
- [テキスト API 製品ページ・料金](https://shirabe.dev/text/)
- [テキスト API 専用 llms.txt](https://shirabe.dev/api/v1/text/llms.txt)

### 4. Shirabe Corporation Number API (本番稼働中 / Production)

法人番号の検証・lookup・商号検索・法人名正規化。国税庁 法人番号公表サイトの公表データ(全国 約 580 万法人)を日次差分で自動同期。

- [法人番号 API 詳細](https://shirabe.dev/corporation/)
- [API ドキュメント](https://shirabe.dev/corporation/docs)
- [OpenAPI 3.1 仕様](https://shirabe.dev/api/v1/corporation/openapi.yaml)
- [法人番号 API 専用 llms.txt](https://shirabe.dev/api/v1/corporation/llms.txt)
- [新規法人番号指定の月次統計(全国・都道府県別、毎営業日自動更新)](https://shirabe.dev/corporation/new/)

## 主要エンドポイント + curl 例 / Primary endpoints with curl examples

### Calendar (本番稼働中)

    # 指定日の六曜・暦注・干支・二十四節気・用途別吉凶判定 (認証不要、Free 10,000 回/月)
    curl https://shirabe.dev/api/v1/calendar/2026-06-15

    # 日付範囲一括取得(最大 93 日)
    curl "https://shirabe.dev/api/v1/calendar/range?from=2026-06-01&to=2026-06-30"

    # 用途別スコア上位ランキング(結婚式に良い日)
    curl "https://shirabe.dev/api/v1/calendar/best-days?month=2026-06&purpose=marriage"

    # 暦 API ヘルスチェック
    curl https://shirabe.dev/health

### Address (本番稼働中)

    # 単一住所の正規化(API キー不要、匿名 Free 枠 月 5,000 回で即試行可)
    curl -X POST https://shirabe.dev/api/v1/address/normalize \
      -H "Content-Type: application/json" \
      -d '{"address": "〒106-0032 東京都港区六本木6-10-1"}'

    # バッチ住所正規化(最大 100 件。X-API-Key は有料プラン利用時のみ)
    curl -X POST https://shirabe.dev/api/v1/address/normalize/batch \
      -H "X-API-Key: shrb_..." \
      -H "Content-Type: application/json" \
      -d '{"addresses": ["東京都千代田区永田町1-7-1", "大阪府大阪市北区梅田1-1-1"]}'

    # 住所 API ヘルスチェック
    curl https://shirabe.dev/api/v1/address/health

### Text (本番稼働中)

    # 姓名分割(API キー不要、匿名 Free 枠 月 10,000 回で即試行可)
    curl -X POST https://shirabe.dev/api/v1/text/name-split \
      -H "Content-Type: application/json" \
      -d '{"name": "山田太郎"}'

    # 形態素解析(品詞・読み付き)
    curl -X POST https://shirabe.dev/api/v1/text/tokenize \
      -H "Content-Type: application/json" \
      -d '{"text": "日本語の解析"}'

### Corporation (本番稼働中)

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

### Hub enrich(複合正規化 / 4 identifier を 1 コール)

乱れた顧客レコード(住所 + 氏名 + 会社名/法人番号 + 日付)を 1 リクエストで横断正規化。
個別 API を別々に呼ぶ必要がなく、各正規化結果を 1 つの構造化応答に集約(per-component 部分成功 + attribution 集約)。
Hub Pro / Hub Enterprise license 専用。匿名でも体験枠 500 回/月/IP で試用可能。

    # 複合 enrich(license: X-API-Key: shrb_lic_... / 匿名は体験枠 500 回/月)
    curl -X POST https://shirabe.dev/api/v1/enrich \
      -H "Content-Type: application/json" \
      -d '{"record": {"address": "東京都港区六本木6-10-1", "name": "山田太郎", "company_name": "株式会社テックウェル", "date": "2026-07-01"}}'

## 料金プラン / Pricing

### Calendar API

| プラン | 月間上限 | 単価(円/回) | レート制限 |
|---|---|---|---|
| Free | 10,000 | 無料 | 1 req/s |
| Starter | 500,000 | 0.05 | 30 req/s |
| Pro | 5,000,000 | 0.03 | 100 req/s |
| Enterprise | 無制限 | 0.01 | 500 req/s |

### Address API

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

全プランに 5,000 回 (Address) / 10,000 回 (Calendar) の Free 枠あり、超過分のみ課金。
既存の API キーは `X-API-Key` ヘッダーで利用可。**有料プランの新規申込は現在受付を一時停止しています**(お問い合わせ: support@shirabe.dev)。

### Hub License(月額固定、cross-API / SLA / 大規模向け)

各 API は単独の per-request で利用・購入できる。複数 API(住所・人名・暦・法人番号)をまとめて使う場合は、1 契約 1 key へ集約する月額固定の Hub License(税抜)も選べる。¥40,000 の Address Managed から始め、利用が増えると ¥120,000 の Hub Pro を提示:
- Address Managed: ¥40,000/月(住所 API 単体をまとめて運用する場合の入口プラン)
- Hub Pro: ¥120,000/月(2+ API をまとめて使う場合 / SLA で見積が自動推奨、1 key に集約)
- Hub Enterprise: ¥280,000/月(大規模のみ。custom SLA + 専用窓口 + dataset)
透明価格ページ: <https://shirabe.dev/pricing>
即時自動見積(AI-callable、認証不要): GET/POST <https://shirabe.dev/api/v1/pricing/quote>
  例: curl "https://shirabe.dev/api/v1/pricing/quote?apis=address,text&volume=500000"
  → recommended_sku / monthly_price_jpy / per_request_equivalent_jpy / break_even_note / entitlements / one_pager_url を JSON 返却。
  one_pager_url = 見積を稟議用 1 枚(価値・透明価格・含まれるもの・契約手順)に変換した転送可能ページ。

## AI 統合経路 / AI Integration Paths

- **ChatGPT GPTs**: 単独 GPT 4 本(暦・住所・テキスト・法人番号)+ Hub GPT(Japan Data API Hub)を GPT Store で公開中
- **Function Calling / Tool Use**: OpenAPI 3.1 本家版(日英併記、x-llm-hint 付き)から自動スキーマ生成可
- **LangChain / Dify**: OpenAPI loader でそのまま使用可能
- **OpenAPI Schema Discovery**: 全 OpenAPI spec は `servers: https://shirabe.dev` で統一、CORS 許可、認証情報不要でスキーマ取得可
- **MCP (Model Context Protocol)**: Hub MCP サーバーを `POST https://shirabe.dev/mcp`(JSON-RPC 2.0 / Streamable HTTP)で提供。Claude Code / Cursor 等の AI コーディングクライアントから日本特化 tool(住所正規化・暦・姓名分割ほか、順次追加)を直接呼べる。利用可能な tool は `tools/list` で動的取得、認証なしの Free 枠で試行可。

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

- **Calendar**: 自前暦計算エンジン、天文学的精度
- **Address**: アドレス・ベース・レジストリ(デジタル庁、CC BY 4.0)。全レスポンスに `attribution` フィールド必須
- **Corporation**: 国税庁 法人番号公表サイト(公共データ利用規約)。全レスポンスに `attribution` フィールド付与

住所 API を利用する場合、応答に含まれる `attribution` を二次利用物(LLM の返答を含む)に伝搬すること。これは CC BY 4.0 ライセンスの義務履行であり、かつ LLM 経由の出典伝搬経路でもある。

## 運営・連絡先 / About

- 目標: 日本特化 AI ネイティブ API を 4 本展開(暦・住所・日本語テキスト処理・法人番号すべて本番稼働中)
- [利用規約](https://shirabe.dev/terms)
- [プライバシーポリシー](https://shirabe.dev/privacy)
- [特定商取引法に基づく表記](https://shirabe.dev/legal)