本「本地」文旅知识库 · 合作方操作指导 · 操作台 · API 文档

三分钟上手：合作方操作指导

这份文档写给合作方的产品和运营同学（不需要懂技术）。技术接入细节请转给开发看 API 文档。

① 你手里有什么

一个 API Key（一串字符）——它是你调用「本地」文旅知识库全部能力的钥匙： 124 城真实 POI、388+ 金牌导游故事（中英音频）、防幻觉的本地问答、行程规划。 Key 有两种：在 /signup 自助秒签的试用 Key（每天 30 次）和服务方签发的正式商用 Key（更大配额+可下单新城市）。 Key 等同密码，不要外传、不要写进公开代码仓库。

② 三分钟验证（不用写代码）

1
打开操作台 mcp.ailocal.top/portal
2
粘贴你的 Key，点「进入操作台」——看到你的名称和配额就说明 Key 有效
3
点「在线试调」→ 选 search_nearby_pois → 点「运行」——看到成都真实美食列表，链路就通了

③ 接进你的产品（两选一）

A. 你的产品是 AI 应用 / Agent（最快，零开发）

在支持 MCP 的客户端（Claude Desktop、Cherry Studio、自家 Agent 平台）里加一段配置（在操作台/API 文档页可复制）， 你的 AI 立刻就能回答「帮我规划南京三天亲子游」「附近有什么故事可以听」。

B. 你的产品是 App / 小程序 / 网站

把 API 文档 和你的 Key 发给开发同学。核心就三个动作：按位置搜 POI（search_nearby_pois）、 拿故事音频（get_local_stories）、AI 问答/规划（ask_local_guide / plan_trip）。 故事音频是 HTTPS URL，可以直接在你们产品里播放。

④ 要一个新城市（自助下单）

1
操作台 →「我的订单 / 下单」
2
填城市名（或坐标）+ 你的联系方式 + 需求备注（如「偏亲子向」）
3
提交后 24–48 小时交付整套内容包（真实 POI + 故事 + 中英音频 + 封面），交付后我们会联系你
下单权限需要 admin 级别的 Key——如果提示无权限，联系你的服务方对接人开通。

⑤ 用量与配额

操作台首页能看到：今日已用 / 配额进度条、近 7 日分工具用量、每日趋势。 超配额会怎样：当天调用会返回「配额已用完」提示，次日 0 点自动恢复；要提额联系服务方。

⑥ 常见问题

Q：Key 泄露了怎么办？
立刻联系服务方——管理台一键吊销旧 Key、签发新 Key，全程约 1 分钟。

Q：调接口拿到空列表？
先调 list_covered_cities 确认该城市已覆盖；未覆盖的城市可以自助下单生成。

Q：AI 回答里的地点可靠吗？
可靠。所有回答涉及的地点都来自真实核验候选池（服务端防幻觉校验），不是 AI 编造；故事是 AI 生成但都附史料来源（sourceNote），展示时请保留「AI 生成」标注。

Q：对接联系人？
hello@ailocal.top