一套覆盖中国 331 城的文旅内容层：真实核验 POI、金牌导游故事（中英双语音频、史实溯源）、
防幻觉问答与行程规划。通过 MCP（Model Context Protocol）或 REST 接入，
适合旅行 App、车机、酒店、景区导览、各类 AI Agent 调用。新增：
lookup_poi_knowledge 直接检索本地文旅知识库（县志/古籍/历史来源），返回带真实出处的史料片段——
这是普通攻略做不到的事实底座，叙事/问答前先取它，杜绝「AI 编典故」。
含 凯里、伊犁、太原、榆林、长海县、苏州、乌鲁木齐、大连、万宁、莆田、屯昌县、十堰 等；全量清单调 list_covered_cities。
端点 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 生成并附史料溯源，透出时请保留标注。 |
lookup_poi_knowledge | 直接检索本地文旅知识库：给定 POI 名（可带城市/区县），返回带真实出处的史料片段（县志/古籍/历史来源）。这是本服务的核心护城河——只透出经人工整理、可溯源的史料，绝不编造；适合在叙事/问答前先取事实底座。 |
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_contentadmin | 【需 admin 权限 Key】B2B 按需生成下单：给一个城市名（或坐标），后台生成整套内容包（真实 POI+金牌导游故事+中英音频+封面），24–48h 交付。重复下单自动去重。 |
list_scenic_areas | 按城市/关键字罗列景区（ScenicArea 级）：返回景区封面、子景点数、标签、中心坐标，并带景区细分层内容（高清真实照片 coverHiRes≥2000px、AI 稿件摘要与出处、金牌导游中英音频 audioUrl/audioUrlEn、contentStatus 齐备度）。用于三方元服务「景区选择」页、整页景区导览。排序：已生产内容者优先，城市兜底全域（isFallback=true）沉底，取列表首条即为可直接取包的景区；建议加 contentOnly:true 只看有内容的。 |
list_attractions | 按景区或点位罗列景点（Attraction 级）：返回坐标、热度、内容生产状态、溯源条数，并带景点细分层齐备度（hasCopy/hasAudioZh/hasAudioEn/hasRealImage 及各媒体 URL）。attractionId 恒等于 poiId，可直接回灌既有 get_poi_detail。 |
get_scenic_area_bundle | ★一次取整景区内容包（景区细分层主接口）：景区级返回高清真实照片(≥2000px 宽)、AI 稿件(含出处)、金牌导游中文音频与英文音频；同时返回其下每个景点的稿件/中英音频/真实图/溯源。三方元服务开一个景区详情页只需 1 次调用。 |
get_source_trace | 取某景点的溯源信息（SourceTrace 级）：来源类型/书名/原文片段/可信度。供三方展示「本介绍摘自《XX县志》P42」，满足真实可信与可溯源要求。 |
compose_cardsadmin | 文旅编排引擎入口：输入景区/景点/坐标 + 可选 uidHash，服务端组合三级知识（景区→景点→溯源）与 ECS 现有 A2UI(/v1/reco)，产出可端侧渲染的文旅 CardSpec。涉及用户域（uidHash）需鉴权。 |
get_card_templates | 返回文旅卡片模板注册表（componentHint/dataPaths/defaultAction）。公开、低配额，供负一屏/三方元服务渲染前枚举可用卡型。 |
issue_uid_hashadmin | 方案 Y 签发端点：传入用户真实 id(real_uid) 与接入方 app_id，服务端返回 HMAC-SHA256 匿名令牌（64 位十六进制）。明文 real_uid 不向三方透出、不落库，仅下发令牌；同一用户不同 app 令牌不同（防跨端关联）。需鉴权（仅可信接入方）。 |
revoke_uid_hashadmin | 方案 Y 吊销端点：将某匿名令牌加入吊销集合（仅存令牌本身，零明文 PII）。用于用户注销/违约等场景。需鉴权（管理员）。 |
get_route_playbook | 路线玩法攻略知识域：按景区/景点/关键字返回 RoutePlaybook 动线（顺序+耗时+交通+贴士）。供编排引擎组卡与三方玩法查询。公开。 |
get_area_governance | 景区数据治理：传入 areaId 返回该景区评级(L0-L3)/指标/缺口/提升建议；传 'all' 或留空返回全域景区提升规则报告（按评级/分由低到高排序）。只读元数据。 |
plan_personalized_route | P2 动态个性化路线规划通道：输入景区/景点 + 五维上下文(context)，服务端按偏好/人群选最匹配线、强制纳入已订票点、按当前位置标注就近起点、按可用时间裁剪，并消费固化层 geoCheck 给出路网可行性提示，返回 top3 候选计划。不强制出卡片，纯路线结构便于端侧自定义渲染。公开低配额。 |
sourceNote），向下游透出时请保留 aiGenerated 标注；
lookup_poi_knowledge / get_poi_detail.knowledge / get_local_stories(with_knowledge)
返回的片段来自本地文旅知识库、附真实出处，与 AI 生成故事请分别如实标注，勿混为一谈。未覆盖的城市/区域可下单生成整套内容包（真实 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