本地通推荐 (Local Guide)#

技能描述#

利用互联网全域搜索，绕过商业评价平台，挖掘真正受当地人认可的地道去处。支持美食、小吃、酒店、景点、温泉等多种类型推荐。

环境配置（必需）#

本技能使用 EXA 搜索引擎 作为核心数据来源，使用前必须配置 API Key。

获取 EXA API Key 步骤#

步骤 1：注册账号

1. 访问 EXA 官网： https://exa.ai
2. 点击右上角 "Sign Up" 或 "Get Started"
3. 选择注册方式：
   • Google 账号登录（推荐，最快）
   • GitHub 账号登录
   • 邮箱注册

步骤 2：进入 Dashboard

1. 登录后自动跳转到 Dashboard
2. 或点击右上角头像 → "Dashboard"

步骤 3：获取 API Key

1. 在 Dashboard 左侧菜单找到 "API Keys"
2. 或直接访问： https://exa.ai/dashboard/api-keys
3. 点击 "Create new API Key" 按钮
4. 输入 Key 名称（如： local-guide）
5. 点击 "Create" 生成 Key
6. 复制生成的 API Key（格式类似： xxxxx-xxxxx-xxxxx-xxxxx）

步骤 4：配置环境变量

bash

# Linux / Mac
export EXA_API_KEY=你复制的API_Key

# 添加到配置文件永久保存
echo 'export EXA_API_KEY=你复制的API_Key' >> ~/.bashrc
source ~/.bashrc

# Windows PowerShell
$env:EXA_API_KEY="你复制的API_Key"

# Windows CMD
set EXA_API_KEY=你复制的API_Key

免费额度说明：

• EXA 提供免费试用额度
• 每月有 1000 次免费搜索请求
• 超出后需付费订阅

验证配置：

bash

# 检查环境变量是否设置成功
echo $EXA_API_KEY

# 测试 EXA 搜索
python3 scripts/search_module.py

---

触发词#

• 本地通推荐 [类型] [地名]
• 本地通 [类型] [地名]
• [地名] 本地通 [类型]

支持的类型：

• 美食 / 小吃
• 甜品 / 糖水
• 酒店 / 住宿 / 民宿
• 好玩 / 景点 / 玩乐
• 温泉 / 泡温泉
• 购物 / 商场
• 咖啡 / 咖啡馆
• 酒吧 / 夜生活
• 停车 / 停车场 / 停车位

使用示例#

text

# 美食推荐
本地通 美食 南海桂城
本地通推荐 小吃 佛山市南海区桂城
本地通 糖水 广州天河

# 景点推荐
本地通 好玩 佛山南海
本地通推荐 景点 广州市番禺区
本地通 小众景点 深圳

# 停车场推荐
本地通 停车 佛山南海千灯湖公园
本地通推荐 停车场 广州天河城
本地通 停车位 广东省中医院

# 温泉推荐
本地通 温泉 广州从化
本地通推荐 泡温泉 佛山三水

# 酒店推荐
本地通 酒店 佛山南海
本地通推荐 性价比酒店 广州越秀

核心逻辑#

1. 严格的来源排除 (Anti-Spam Filter)#

严禁引用：

• 大众点评
• 美团
• 携程（美食林/酒店/景点）
• 小红书商业推广笔记
• 马蜂窝商业推广

理由： 避开算法推荐、商业竞价排名及刷单污染的数据。

2. 深度搜索渠道 (Source Targeting)#

优先检索并分析以下来源：

官方权威来源（优先级最高）：

• 地方政府官方推荐（如文旅局、商务局、旅游局）
• 地方新闻媒体的专题报道（如南方+、南方网、本地日报等）
• 地方政府认定的"老店"、"老字号"名录
• 官方评选活动（如"十大名店"、"最佳景点"等）

生活方式社区：

• 豆瓣同城/小组
• 知乎（搜索"本地人推荐"、"从小去到大"等话题）

社交媒体原生态内容：

• 微博实时搜索
• Bilibili 探店/探景视频评论区
• 本地生活博主（非营销号）的非赞助分享

地方性平台：

• 地方性论坛（如上海宽带山、广州妈妈网等）
• 当地街坊社区讨论

3. 搜索关键词策略 (Search Query Strategy)#

根据类型使用不同的关键词组合：

官方推荐类（优先）：

text

[地名] 官方推荐 [类型]
[地名] 文旅 推荐 [类型]
[地名] 旅游局 推荐 [类型]
[地名] 政府 推荐 [类型]
南方+ [地名] [类型]

本地人口碑类：

text

[地名] 本地人推荐 [类型]
[地名] 本地人常去 [类型]
[地名] 街坊推荐 [类型]
[地名] 只有本地人才知道的 [类型]
[地名] 从小去到大 [类型]
[地名] 老字号 [类型]
[地名] 排队 [类型]

类型特定关键词：

美食/小吃：

text

[地名] 老店 美食
[地名] 十大名小吃
[地名] 苍蝇小馆
[地名] 居民楼 美食

甜品/糖水：

text

[地名] 老字号 糖水
[地名] 本地人推荐 甜品
[地名] 老店 糖水
[地名] 传统糖水
[地名] 榴莲甜品
[地名] 双皮奶 姜撞奶
[地名] 糖水铺 推荐

酒店/住宿：

text

[地名] 本地人推荐 酒店
[地名] 性价比高 酒店
[地名] 特色民宿
[地名] 老牌酒店

好玩/景点：

text

[地名] 本地人常去 景点
[地名] 免费景点
[地名] 小众景点
[地名] 周末去哪玩

温泉：

text

[地名] 本地人推荐 温泉
[地名] 性价比高 温泉
[地名] 老牌温泉
[地名] 温泉酒店

停车/停车场：

text

[地名] 停车位 便宜
[地名] 停车场 收费标准
[地名] 停车 地下停车场
[地名] 停车 免费停车
[地名] 商场 停车
[地名] 医院 停车
[地名] 停车攻略

4. 输出标准 (Output Format)#

对于搜寻到的每一个推荐，给出：

基本信息：

• 名称与大致位置（具体的街道或标志物）
• 联系电话
• 导航地址（可以直接在高德导航的地址）
• 人均消费（价格区间，如：¥10-20、¥30-50、¥80-150等）
• 营业/开放时间

推荐理由： 必须包含该地被认为是"地道"或"本地人喜欢"的证据，例如：

• 政府官方推荐（如文旅局推荐、官方评选等）
• 开了多年的老店/老景点（10年以上即可）
• 本地人常去、街坊口碑好
• 隐藏在居民区或老街区
• 本地人从小去到大
• 本地媒体多次报道
• 性价比高、不宰客

避雷参考： 提及可能存在的缺点，增加信息真实性：

• 服务态度一般
• 环境简陋/设施老旧
• 不接受预约
• 营业时间不固定
• 只收现金
• 周末人多需排队
• 交通不便

输出格式示例#

通用类型格式（美食/酒店/景点/温泉/购物/咖啡/酒吧）#

markdown

# 🎯 [地名] 本地通推荐 - [类型]

根据官方推荐（[来源]）和本地口碑，为您精选以下地道去处：

---

## 🏆 官方认证推荐

### 1. [名称] ⭐⭐⭐
📍 **位置**：[具体街道/标志物]
📞 **电话**：[联系电话]
🗺️ **导航**：[高德地址]
⏰ **营业时间**：[营业时间]
💰 **人均消费**：[人均价格]

✨ **推荐理由**：
- [地道证据1]
- [地道证据2]
- [地道证据3]

⚠️ **避雷参考**：
- [缺点1]
- [缺点2]

---

### 2. [名称] ⭐⭐
...

---

## 🏅 [其他分类]（如：本地口碑推荐）

### 3. [名称] ⭐⭐
...

---

## 📝 温馨提示

1. **官方认证优先**：[说明]
2. **避开高峰**：[建议]
3. **提前确认**：[提醒]
4. **交通建议**：[建议]
5. **支付方式**：[说明]

**搜索来源**：[列出来源]（已排除大众点评、美团、携程等商业平台）

---

停车场专用格式#

markdown

# 🚗 [地名] 本地通推荐 - 停车场

根据官方信息和本地车主反馈，为您整理以下停车选择：

---

## 🏆 性价比推荐

### 1. [停车场名称] ⭐⭐⭐
📍 **位置**：[具体街道/标志物]
🗺️ **导航**：[高德地址]
🅿️ **车位数量**：[约XX个]
💰 **收费标准**：[如：首小时5元，之后2元/小时；或：全天封顶20元]
⏰ **开放时间**：[24小时/XX:XX-XX:XX]
🔌 **充电桩**：[有/无，如有注明数量]

✨ **推荐理由**：
- [优点1：如收费便宜]
- [优点2：如车位充足]
- [优点3：如位置便利]

⚠️ **注意事项**：
- [注意1：如限高2.2米]
- [注意2：如只支持现金/微信]

---

### 2. [停车场名称] ⭐⭐
...

---

## 🏅 免费停车

### 3. [停车场名称] ⭐⭐
📍 **位置**：[位置]
⏰ **免费时段**：[如：消费满50元免2小时]
📝 **使用条件**：[条件说明]

---

## 📝 停车小贴士

1. **高峰时段**：[如：周末10:00-14:00车位紧张]
2. **省钱建议**：[如：周边商场消费可免停车费]
3. **充电提醒**：[如：XX停车场有快充桩]
4. **限高注意**：[如：地下停车场限高2.0-2.2米]
5. **支付方式**：[如：大部分支持微信/支付宝]

**搜索来源**：[列出来源]

---

重要规则：

1. 必须包含完整的基本信息（位置、电话、导航、营业时间、人均消费）
2. 必须包含推荐理由（至少3条）
3. 必须包含避雷参考（至少2条）
4. 必须按照官方认证、本地口碑等分类组织
5. 不得简化为列表形式，必须保持详细格式
6. 每个推荐必须独立成段，用分隔线分开
7. 停车场类型：重点标注收费标准、车位数量、充电桩等关键信息

飞书卡片输出#

当检测到用户来自飞书渠道时，必须：

1. 生成完整的详细内容（与 webchat 相同）
2. 将内容转换为 JSON 格式
3. 调用飞书卡片脚本 发送卡片

JSON 数据格式#

通用类型：

json

{
  "location": "广州天河",
  "type": "温泉",
  "sources": "广州市文旅局、南方+报道",
  "items": [
    {
      "name": "某某温泉度假村",
      "category": "官方认证推荐",
      "stars": 3,
      "address": "天河区某某路123号",
      "phone": "020-12345678",
      "navigation": "广州市天河区某某路123号",
      "hours": "09:00-22:00",
      "price": "¥128-298",
      "reasons": [
        "广州市文旅局官方推荐温泉度假村",
        "开业15年，本地人常去",
        "水质好，性价比高"
      ],
      "warnings": [
        "周末人多需提前预约",
        "部分设施较老旧"
      ]
    }
  ]
}

停车场类型：

json

{
  "location": "广州某医院",
  "type": "停车",
  "sources": "医院官网、本地车主反馈",
  "items": [
    {
      "name": "医院配套停车场",
      "category": "性价比推荐",
      "stars": 3,
      "address": "越秀区某某路88号",
      "navigation": "广州市越秀区某某路88号",
      "spaces": "约55个",
      "hour_rate": "5元/小时",
      "first_hour": "5元",
      "after_hour": "5元/小时",
      "daily_cap": "无封顶",
      "free_time": "无",
      "hours": "全天开放",
      "charging": "无",
      "reasons": [
        "距离医院最近",
        "收费相对便宜",
        "步行可达门诊"
      ],
      "warnings": [
        "车位紧张，高峰期难找位",
        "需注意停车时限规定"
      ]
    }
  ]
}

停车场JSON字段说明：

字段说明示例hour_rate每小时费用（必填）"5元/小时"、"10元/小时"first_hour首小时费用"免费"、"5元"after_hour后续每小时费用"3元/小时"、"5元/小时"daily_cap全天封顶"20元封顶"、"无封顶"free_time免费时长"首15分钟免费"、"无"spaces车位数量"约55个"charging充电桩"有，5个快充"、"无"

飞书卡片脚本#

使用 scripts/send_feishu_card.py 发送卡片：

bash

echo '{JSON数据}' | python3 scripts/send_feishu_card.py {receive_id} {reply_to}

飞书渠道识别#

当用户来自飞书时，在生成完整内容后，额外生成 JSON 数据并调用卡片脚本。

---

实施步骤#

1. 接收指令：识别"本地通推荐 [类型] [地名]"

2. 类型识别：判断用户要查找的类型（美食/酒店/景点/温泉等）

3. 多轮全面搜索（至少5-8轮）：

   • 第1轮：官方推荐（"[地名] 官方推荐 [类型]"、"[地名] 文旅 推荐 [类型]"）
   • 第2轮：老店/老牌（"[地名] 老字号 [类型]"、"[地名] 老牌 [类型]"）
   • 第3轮：本地口碑（"[地名] 本地人推荐 [类型]"、"[地名] 街坊常去 [类型]"）
   • 第4轮：特色推荐（"[地名] 特色 [类型]"、"[地名] 性价比高 [类型]"）
   • 第5轮：补充搜索（根据前面结果补充不足的分类）
   • 第6-8轮：深度搜索（针对结果不足的分类，使用更多关键词组合搜索）

4. 来源过滤：排除商业平台内容，优先采纳官方和本地社区来源

5. 信息整合：汇总所有搜索结果，去重，按分类组织

6. 数量检查：确保每个分类至少有10个推荐，如果不足则继续搜索（除非该类型在当地确实没有这么多）

7. 信息提取：提取名称、位置、电话、地址、营业时间、人均消费

8. 证据收集：收集"地道"证据（官方认证、本地口碑、开业年限等）和真实缺点

9. 格式化输出： 严格按照输出格式示例 生成回复，不得简化或改变结构

10. 渠道一致性检查：确保飞书、webchat、群聊、私聊等所有渠道输出完全一致

注意事项#

• 不强求老字号：只要是本地人喜欢、常去的地方就可以推荐

• 优先官方推荐：政府文旅、旅游局推荐的优先级最高

• 多源验证：优先推荐有多个独立来源验证的地方

• 避免网红化：排除过度商业化、主要靠营销的地方

• 信息时效性：提醒用户可能已搬迁/关闭/装修，建议提前确认

• 真实性：必须包含真实缺点，增加可信度

• 格式统一：无论在任何渠道，都必须使用完整的详细格式，不得简化为列表

• 数量要求：每个分类至少推荐10个地方，提供足够的选择（除非该类型在当地确实没有这么多）

• 结果稳定性：使用相同的搜索关键词和来源，确保每次返回的结果基本一致

• 全面搜索：必须进行至少5-8轮搜索，覆盖不同关键词组合，确保找到足够多的推荐（每分类至少10个）

• 类型适配：根据不同类型调整搜索关键词和输出重点

  • 美食：重点关注口味、老店历史、本地口碑
  • 酒店：重点关注位置便利性、设施、性价比
  • 景点：重点关注独特性、人流量、最佳游览时间
  • 温泉：重点关注水质、环境、服务
  • 停车场：重点关注收费标准、车位数量、距离目的地远近、充电桩