本「本地」· BendiService · 开发者文档 v0.1.0 · 合作方操作台 · 操作指导

文旅知识库开放 API

一套覆盖中国 125 城的文旅内容层：真实核验 POI、金牌导游故事（中英双语音频、史实溯源）、防幻觉问答与行程规划。通过 MCP（Model Context Protocol）或 REST 接入，适合旅行 App、车机、酒店、景区导览、各类 AI Agent 调用。

125

覆盖城市

1854+

真实 POI

250+

导游故事

L3 街区网格

含凯里、伊犁、太原、苏州、乌鲁木齐、大连、莆田、长沙、恩施、平遥、泉州、福州等；全量清单调 list_covered_cities。

① 接入（MCP，推荐）

端点 POST https://mcp.ailocal.top/mcp（Streamable HTTP，协议 2025-06-18）
鉴权 Authorization: Bearer <API_KEY>（申请 Key 见文末）

MCP 客户端配置（Claude Desktop / Cherry Studio 等）：

{"mcpServers": {"bendi-local-guide": {
  "url": "https://mcp.ailocal.top/mcp",
  "headers": {"Authorization": "Bearer <API_KEY>"}
}}}

curl 快验：

curl -X POST https://mcp.ailocal.top/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <API_KEY>" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_nearby_pois",
       "arguments":{"lat":30.652,"lng":104.0657,"cat":"吃"}}}'

② 工具清单

`search_nearby_pois`	按经纬度搜附近真实 POI（吃/逛/玩/住），返回距离、热度、封面。内部走 L3 网格→城市降级链，只返回已核验的真实地点。
`get_poi_detail`	按 POI id 取详情：长文案、种草短评、坐标、关联故事与优惠券，一次拿全。
`get_local_stories`	取金牌导游故事（含中英音频 URL、章节、史实溯源 sourceNote）。按 poi_id 取单个地点的，或按 city 取全城精选。所有故事 AI 生成并附史料溯源，透出时请保留标注。
`list_covered_cities`	列出知识库已覆盖的城市及内容规模（POI/故事数量）。调用其他工具前先确认覆盖范围。
`ask_local_guide`	问本地向导任何自由行问题（哪里好吃/怎么逛/带孩子去哪），支持多轮 history。回答经 grounding 校验：涉及的地点/故事全部来自真实候选池，绝不虚构。复杂问题约 5–30 秒。
`plan_trip`	生成按天/分时段的多日行程（吃逛住玩全部落到真实 POI，经 plan→critique 两趟校验）。给城市名或坐标均可，1–7 天。规划约 20–60 秒。
`get_contextual_reco`	按位置+时间情境主动推荐「下一步去哪」（清晨/午后/傍晚 × 工作日/周末自动选场景），返回带推荐理由的卡片列表，POI 来自真实候选池。
`request_city_content`admin	【需 admin 权限 Key】B2B 按需生成下单：给一个城市名（或坐标），后台生成整套内容包（真实 POI+金牌导游故事+中英音频+封面），24–48h 交付。重复下单自动去重。

⚠️ 回答/推荐涉及的地点全部来自真实核验候选池（服务端 grounding 校验），不是 LLM 虚构；故事为 AI 生成并附史料溯源（sourceNote），向下游透出时请保留 aiGenerated 标注。

③ 按需生成（B2B）

未覆盖的城市/区域可下单生成整套内容包（真实 POI + 故事 + 中英音频 + 封面，24–48h）：
REST：POST /v1/enqueue　body {"city":"桂林","contact":"you@corp.com","note":"要亲子向"}
或 MCP 工具 request_city_content（需 admin 权限 Key）。

④ 配额与合规

· 没有 Key？自助申请试用 Key（每天 30 次，秒发）；正式商用 Key 联系 hello@ailocal.top。
· 每个 Key 有日调用配额，超限返回配额提示，次日 0 点重置；提额请联系服务方。
· POI 坐标/照片含第三方地图来源数据，转售前请与服务方确认授权范围；叙事文案/音频为本服务自产，可随授权使用。
· 申请 Key / 商务合作：hello@ailocal.top