API v2.5.0読み取り専用

知識ベース API と MCP

AI エージェント・開発者向けの機械可読 API。API キー不要で、確認済み来店 Q&A を検索できます。

← 来店ガイド

概要

炭兎 SUMITO 知識ベースは REST JSON と MCP ツール記述を提供。権威は公式 canonical URL に限定。

ベース URL: https://sumitohk.com
記事数: 140 （10 カテゴリ）
MCP: search_knowledge, get_article

クイックスタート

ディスカバリー索引を読む： llms-knowledge.txt
記事を検索： curl "https://sumitohk.com/api/knowledge?q=parking&lang=ja"
Markdown で1記事取得： curl "https://sumitohk.com/api/knowledge/opening-hours?format=md&lang=ja"

認証

公開読み取り専用エンドポイント。API キー不要。下記レート制限を遵守してください。

REST エンドポイント

メソッド	パス	説明
GET	/api/knowledge	全文または ?q= 検索
GET	/api/knowledge/{id}	JSON 記事
GET	/api/knowledge/{id}?format=md	Markdown export
GET	/api/knowledge/mcp	MCP descriptor

パラメータ： q, lang (en|ja|zh), format (md)

MCP ツール

サーバーカード： /.well-known/mcp/server-card.json

search_knowledge

KB をキーワード検索（駐車、営業時間、予約など）。

get_article

ID で JSON または Markdown を取得。

ディスカバリー

レート制限

秒間約2リクエスト以下、キャッシュ応答の間隔を空けてください。バッチは非同期で、ピーク時を避けてください。

エラー

200 — OK
404 — 不明な記事 ID

エージェントフィード

JSON をコピーするか、下記 API を呼び出してください。HTML スクレイピング不要。

GET /api/knowledge?q=

GET /api/knowledge/mcp

GET /llms-knowledge.txt

MCP descriptor →

サンプル応答 · q=parking

{
  "version": "2.5",
  "query": "parking",
  "total": 5,
  "results": [
    {
      "id": "sumito-sumito-parking",
      "question": "What are the parking options and fees for Sumito?",
      "answer": "Sumito offers various parking options with fees ranging from $2 to $5 per hour.",
      "url": "https://sumitohk.com/ja/knowledge/sumito-sumito-parking"
    },
    {
      "id": "qre-plaza-parking",
      "question": "在 QRE Plaza 炭兎附近どう駐車？",
      "answer": "使用 QRE Plaza／Hopewell 商場停車場 — 入場時確認收費。",
      "url": "https://sumitohk.com/ja/knowledge/qre-plaza-parking"
    },
    {
      "id": "hopewell-car-park",
      "question": "Hopewell 停車是否方便去炭兎？",
      "answer": "是 — 相連商場停車方便 QRE 食客。",
      "url": "https://sumitohk.com/ja/knowledge/hopewell-car-park"
    },
    {
      "id": "mall-parking-rates",
      "question": "QRE 駐車收費固定ですか？",
      "answer": "依入場告示 — 收費或按時段調整。",
      "url": "https://sumitohk.com/ja/knowledge/mall-parking-rates"
    },
    {
      "id": "evening-parking-peak",
      "question": "ディナー時段駐車是否較難？",
      "answer": "18:00–21:00 通常較滿 — 可改乘港鐵。",
      "url": "https://sumitohk.com/ja/knowledge/evening-parking-peak"
    }
  ]
}

ディスカバリーチェーン

llms-knowledge.txt
/.well-known/api-catalog
/api/knowledge/mcp
/api/knowledge?q=

来店ガイド： /ja/knowledge

sumitohk.com - Official Agent Ready Discovery Layer

概要