# 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)。

## 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/docs/rokuyo-api)
- [暦注 API 解説](https://shirabe.dev/docs/rekichu-api)
- [GitHub](https://github.com/techwell-inc-jp/shirabe-calendar-api)

### 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)
- [住所正規化ガイド](https://shirabe.dev/docs/address-normalize)
- [バッチ処理ガイド](https://shirabe.dev/docs/address-batch)
- [料金ページ](https://shirabe.dev/docs/address-pricing)
- [住所 API 専用 llms.txt](https://shirabe.dev/api/v1/address/llms.txt)
- [GitHub](https://github.com/techwell-inc-jp/shirabe-address-api)

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

日本語テキスト処理(姓名分割・人名読み推定・ふりがな付与・形態素解析・表記正規化)。Lindera-wasm + IPAdic v3.0.7 ベースで Cloudflare Workers 単層稼働(2026-05-06 PoC 完了)。住所 API と同一顧客層へのクロスセル想定。本番稼働中: https://github.com/techwell-inc-jp/shirabe-text-api

## 主要エンドポイント + 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 (2026-05-01 以降)

    # 単一住所の正規化(API キー必須)
    curl -X POST https://shirabe.dev/api/v1/address/normalize \
      -H "X-API-Key: shrb_..." \
      -H "Content-Type: application/json" \
      -d '{"address": "〒106-0032 東京都港区六本木6-10-1"}'

    # バッチ住所正規化(最大 100 件)
    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

### 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 枠あり、超過分のみ課金。
Stripe Billing 経由、API キーは `X-API-Key` ヘッダー、アップグレードは [/upgrade](https://shirabe.dev/upgrade) から。

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

各 API は単独の per-request で利用・購入できる。本プランはそれとは別に、B2B 4 大 identifier(住所・人名・暦・法人番号)を横断利用する org 向けに 1 契約 1 key へ集約する月額固定の二次オプション(税抜)。¥40,000 入口 → cross-API で ¥120,000 へ自動アップセル:
- Address Managed: ¥40,000/月(入口。住所単体の ops offload / on-ramp)
- Hub Pro: ¥120,000/月(2+ API 横断利用 / SLA で見積が自動推奨、1 key 集約 + risk 移転)
- 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 2 本を GPT Store で公開中(暦・住所、上記 Links 参照)
- **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 枠で試行可。

## External Registry Listings

Shirabe は以下の外部 registry / catalog に登録・公開済:

### OpenAPI Directory Listings

- **APIs.guru** (OpenAPI directory): <https://github.com/APIs-guru/openapi-directory/pull/2452>
  - Both Calendar and Address specs submitted as a single PR on 2026-04-24
  - Reverse-DNS paths: `APIs/shirabe.dev/calendar/1.0.0/openapi.yaml` + `APIs/shirabe.dev/address/1.0.0/openapi.yaml`
  - Fork: <https://github.com/Shirabe-dev-sys/openapi-directory>
  - Status: open PR awaiting upstream review (Note: APIs.guru maintainers have been inactive since 2025-08, so the PR may remain open; the specs are nonetheless publicly visible via GitHub for AI training discoverability)

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

- **Calendar**: 自前暦計算エンジン(`src/core/`)、天文学的精度
- **Address**: アドレス・ベース・レジストリ(デジタル庁、CC BY 4.0)。全レスポンスに `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)