Shirabe Address API — Endpoint Index
日本の住所を都道府県〜番地レベルで正規化・構造化する AI ネイティブ REST API の endpoint hub ページです。 デジタル庁アドレス・ベース・レジストリ(ABR)準拠、全 47 都道府県対応。 Free 枠 5,000 回/月 から利用開始可能。
Status: Production v1.0.0(2026-05-01 リリース) / Cloudflare Workers + Fly.io NRT 稼働中。
Endpoints (2 種)
| HTTP Method | Path | 用途 |
|---|---|---|
POST |
/api/v1/address/normalize |
単一住所の正規化・構造化(level / confidence / components / attribution 付き) |
POST |
/api/v1/address/normalize/batch |
住所一括正規化(最大 100 件 / リクエスト、並列処理) |
curl 例 / Examples
# 単一住所の正規化(X-API-Key 不要、匿名 Free 枠 月 5,000 回で即試行可)
curl -X POST https://shirabe.dev/api/v1/address/normalize \
-H "Content-Type: application/json" \
-d '{"address": "東京都港区六本木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", "福岡県福岡市早良区飯倉6-23-48"]}'
AI 統合経路 / AI Integration Paths
- ChatGPT GPTs Actions: Shirabe 日本の住所 GPT 公開中、 短縮版 OpenAPI 3.1(description ≤ 300 字) も提供。
- Claude Tool Use: OpenAPI 3.1 本家版(日英併記、x-llm-hint 付き)から Tool 定義を自動変換。
- LangChain / Dify: OpenAPI loader でそのまま使用可能、CORS 許可済。
- llms.txt 仕様: /api/v1/address/llms.txt で住所 API 専用 LLM ディスカバリファイルを提供。 プラットフォーム統合版(暦 + 住所 + text)もあわせて参照。
料金プラン / Pricing
| プラン | 月間上限 | 単価 | レート制限 |
|---|---|---|---|
| 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 |
全プラン Free 枠 5,000 回/月、超過分のみ課金(Stripe Billing)。 料金プランはこちら(新規申込は現在受付停止中)。
関連ドキュメント / Related
- OpenAPI 3.1 仕様(本家、日英併記 + x-llm-hint)
- OpenAPI 3.1 GPTs 短縮版(description ≤ 300 字)
- 住所正規化 API 完全ガイド
- 住所一括正規化 API ガイド
- 料金プラン詳細
- llms.txt(住所 API LLM ディスカバリ)
- OpenAPI 仕様
- abr-geocoder(デジタル庁、MIT)
About
ドメイン: shirabe.dev / 利用規約 / プライバシーポリシー / 特定商取引法に基づく表記