developer docs

Mawarimichi Search API

自治体オープンデータ・公的データ・許諾済み民間データを、出典・ライセンス・更新日を保持したまま統合した検索 API。 Web サイト・MCP・ChatGPT App・サイネージから、同じ検索エンドポイントで地域データを利用できます。

解決する課題

同じ場所・イベントが市公式・観光協会・投稿に重複している → canonical 化して 1 件で返す
Web 検索・MCP 検索・外部 API 検索で結果がズレる → 同一 index でズレなし
大量・期限切れ・重複ページが Google に出る → index_policy で分離
Claude / Cursor / ChatGPT App から地域データを引ける口がない → 統一 API で提供

エンドポイント

GET

/api/search?q=<query>

地域データを横断検索。場所・イベント・投稿を 1 つの結果セットで返却。出典・ライセンス・更新日を各エントリに保持。

GET

/health

サービス稼働確認用。監視・ロードバランサー用途。

ベース URL (Free tier): https://api-search.mawarimichi.app (dev: http://localhost:8092)

使用例

# Free tier (認証なし) で検索
curl 'https://api-search.mawarimichi.app/api/search?q=温泉'

# Response (例)
{
  "results": [
    {
      "id": "place_xxxxx",
      "type": "place",
      "name": "...",
      "source": "kobe_city_opendata",
      "license": "CC-BY-4.0",
      "updated_at": "2026-05-01",
      "url": "https://mawarimichi.app/..."
    }
  ],
  "total": 12,
  "took_ms": 24
}

Free tier の制限

レート制限: 30 リクエスト / 分 / IP
認証: 不要 (Free tier は anonymous)
商用利用: 出典・ライセンス表示を保持してください
SLA / サポート: なし (best effort)
高頻度利用 / 商用 / レポート分析 / MCP 連携: 有料プランへ

有料プランの詳細は料金プランをご覧ください。 MCP 経由 (Claude Desktop / Cursor / ChatGPT) の利用は /docs/mcp へ。

データソース・正規化

ソースは自治体オープンデータ・公的データ・許諾済み民間データのみを使用します。重複は canonical_places / canonical_events で統合し、各エントリに source / license / updated_at を保持。

元データ提供者 (自治体・主催者・施設) の出典・ライセンスは保持されます。データそのものの再販ではなく、整理済みデータへの「検索アクセス」を提供する API です。

お問い合わせは /contact から。料金プランは /pricing。