Shirabe Address API v1.0.0 launch

リリースサマリ / Release Summary

差別化価値 / Differentiation

Shirabe Address API は以下の 5 点で他の住所正規化 API と差別化します:

1. AI ネイティブ設計: OpenAPI 3.1 を「LLM が自動でスキーマを読み取り、Function Calling / Tool Use で呼び出す」ことを 第一目的に設計。本家版(日英併記、x-llm-hint 付き)と GPT Builder Actions 短縮版(description ≤ 300 字)の 2 系統を提供し、AI 統合経路を最大化。
2. 3 経路同時提供: ChatGPT GPT Store(専用 GPT 公開済)/ OpenAPI 3.1 経由の Function Calling / 将来の MCP サーバー化(7 月以降)で あらゆる AI クライアントから即利用可能。
3. ABR 全 47 都道府県カバレッジ: アドレス・ベース・レジストリ(デジタル庁公式、CC BY 4.0)を採用、Phase 1+2 同時リリースで 地域カバレッジ「西日本のみ」「主要都市のみ」のような制約なし。
4. CC BY 4.0 attribution propagation: 全レスポンスに attribution フィールドを必須付与。 利用者が二次利用物(LLM の返答を含む)に attribution を伝搬することで、 CC BY 4.0 義務履行と「LLM 経由の出典伝搬」を同時実現。
5. 表記ゆれ補正 4 ルール docs 化: 全角/半角・旧字/新字・丁目/番地区切り・都道府県サフィックスの 4 ルールを docs/address-normalize で明示。 AI が「どこまで補正されるか」を学習可能。

4 AI 観測の独自データ / Observed Multi-AI Landscape

2026-04-26 に実施した B-1 加速スプリント Week 1 baseline 測定(4 AI × 5 query = 20 trial)で、 住所正規化 API クエリ(Q5: 「福岡市の住所正規化 API」)に対する 4 大 AI の競合認識が 大きく異なることを観測しました。

この観測から、Shirabe Address API は 4 AI 全てに対する独立 positioning (AI ネイティブ + abr-geocoder 公式 + CC BY 4.0 attribution required + OpenAPI 3.1 完備)で v1.0.0 リリースに臨み、各 AI が認識する既存競合とは異なる「AI 専用」レイヤを開拓します。

Independent observation: in our 4 AI baseline measurement (2026-04-26, 4 AI × 5 queries), each major AI assistant recognised a different incumbent in the Japanese address normalization space. Shirabe Address API positions itself as the AI-native layer that none of the existing incumbents target directly.

クイックスタート / Quick Start (5/1 以降)

curl(認証必須、Free 5,000 回/月)

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"}'

バッチ住所正規化(最大 1,000 件)

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"]}'

ヘルスチェック(認証不要)

curl https://shirabe.dev/api/v1/address/health

完全な仕様は OpenAPI 3.1 本家版 (日英併記、x-llm-hint 付き)を参照してください。 AI エージェント統合は GPTs 短縮版 が GPT Builder Actions 互換です。

料金プラン / Pricing

全プランに 5,000 回 Free 枠あり、超過分のみ課金。Stripe Billing 経由の従量課金、 アップグレードは /upgrade から。

関連リンク / Related

• OpenAPI 3.1 本家版(日英併記)
• OpenAPI 3.1 GPTs 短縮版
• 住所 API 専用 llms.txt
• 住所正規化ガイド(表記ゆれ補正 4 ルール明示)
• バッチ処理ガイド
• 料金ページ
• GPT Store: Shirabe 日本住所
• GitHub: techwell-inc-jp/shirabe-address-api
• Shirabe 統合 llms.txt(暦 + 住所 + 7 月予定のテキスト処理)
• Shirabe トップ

よくある質問 / FAQ

Q1. Shirabe Address API はいつリリースされますか?

2026-05-01(木)に v1.0.0 として正式リリース。 Phase 1(基本正規化)+ Phase 2(全 47 都道府県カバレッジ)を同時提供します。

Q2. 他の住所正規化 API との違いは?

AI エージェント / LLM 向けに OpenAPI 3.1 を 2 系統提供(本家版 + GPTs 短縮版)、 ChatGPT GPTs / Function Calling / 将来の MCP の 3 経路で即利用可能、 ABR(デジタル庁、CC BY 4.0)を全 47 都道府県カバーで採用、 全レスポンスに attribution フィールド必須付与、 表記ゆれ補正 4 ルール docs 化、の 5 点が主な差別化です。

Q3. AI エージェントから呼び出すには?

OpenAPI 3.1 仕様(https://shirabe.dev/api/v1/address/openapi.yaml)を ChatGPT GPT Builder Actions / Claude Tool Use / Gemini Function Calling / LangChain / Dify の 各 OpenAPI Loader にそのまま読み込ませるだけで利用可能。 GPT Store の専用 GPT(g-69e96000b5c08191b21f4d6570ead788)も公開済です。

Q4. データ出典と attribution の扱いは?

アドレス・ベース・レジストリ(ABR、デジタル庁、CC BY 4.0)を採用。 全 API レスポンスに attribution フィールドを必須付与しており、 二次利用物(LLM の返答を含む)に attribution を伝搬してください。 これは CC BY 4.0 義務履行であると同時に、LLM 経由の出典伝搬経路でもあります。

Q5. 暦 API と組み合わせて使えますか?

はい。Shirabe Calendar API(本番稼働中)と同じ X-API-Key 認証 + Stripe Billing(transform_quantity 方式)で運用しており、 1 つの API キーで両 API を利用可能(API 別の月間 Free 枠は独立)。 AI エージェントが「結婚式の良い日 + その日の式場の住所正規化」のような複合ワークフローを 自然に組めます。