美业大健康全域地图获客2.0

概述

美业大健康全域地图获客

一句话：说一句话，自动调三份地图帮你把某个区域的客户捞出来，按名称+电话去重后存成 Excel 表格放桌面。

特性：独立自包含（不依赖任何其他技能）｜三地图自动择优｜名称+电话去重｜行政区/周边双模式｜支持数量上限与距离排序｜美业噪音自动过滤｜跨平台（Windows/macOS/Linux）。

快速开始（3 步）

1. 安装技能：把本目录整个复制到 ~/.workbuddy/skills/美业大健康全域地图获客/（或用 zip 包让 WorkBuddy 安装）。
2. 配置 Key（只需高德 1 个即可用，百度/腾讯可选）：

   python scripts/configure_keys.py          # 交互式粘贴 Key
   # 或一次性：python scripts/configure_keys.py --amap <高德Key> --baidu <百度Token>

1. 对 WorkBuddy 说：「找郑州经开区的美业客户」或「找10个正商经开广场附近的美业客户」，技能自动出表。

安装方法

安装后确认目录结构：

美业大健康全域地图获客/
├── SKILL.md                 # 本说明（技能入口）
├── config.example.json      # Key 配置模板
├── scripts/
│   ├── find_customers.py    # 核心脚本
│   └── configure_keys.py    # Key 一键配置助手
└── references/
    └── industry_map.md      # 行业映射表（可自行扩充）

配置 Key（一次性）

两种配置方式（任选其一）：

• 方式 1（推荐，技能内配置）：运行 python scripts/configure_keys.py，按提示粘贴 Key，写入本目录 config.json（权限 0600）。脚本自动读取，无需改系统环境变量。
• 方式 2（环境变量）：

  export AMAP_WEBSERVICE_KEY="高德Key"
  export BAIDU_MAP_AUTH_TOKEN="百度Token"
  export TENCENT_MAP_KEY="腾讯Key"

环境变量优先级高于 config.json。

⚠️ 高德 Key 如启用"IP 白名单"，需把运行机器的出口 IP 加入白名单，否则报 INVALID_USER_IP。

使用示例

自然语言（对 WorkBuddy 说）

• 「找郑州经开区的美业客户」
• 「找10个正商经开广场附近的美业客户」（自动解析地标坐标 → 周边 5km → 最近 10 家）
• 「把海淀区的教育机构列个表」
• 「橄榄城附近 3 公里内的餐饮店」

命令行

# 行政区模式：整个区域内搜索
python find_customers.py --region "郑州市经开区" --types "美业"

# 周边模式：以某坐标为中心，5 公里内，只要最近的 10 家
python find_customers.py --region "郑州市经开区" --types "美业" 
    --location "113.770350,34.719078" --radius 5000 --limit 10

# 多类型 / 自由词混合
python find_customers.py --region "郑州市二七区" --types "美业,KTV"

# 不强制电话（要腾讯完整名单时）
python find_customers.py --region "郑州市经开区" --types "美业" --no-require-tel

# 指定输出目录
python find_customers.py --region "郑州市经开区" --types "餐饮" --output-dir "D:/客户名单"

参数说明

执行流程

1. 解析请求：提取区域/地标、客户类型、距离、数量。地标名（如"正商经开广场"）先用高德 place/text 解析成坐标，再转周边模式；未提距离时默认 5 公里。
2. 展开关键词：类型命中行业映射表则展开为多关键词（美业 → 美容|美发|美甲|…），未覆盖的类型（如 KTV）原词直传。
3. 三源检索：高德（主）→ 百度（补）→ 腾讯（补），失败自动降级不中断；各自只保留有电话的记录（默认）。
4. 合并去重：名称+电话去重，缺电话降级名称+坐标；多源命中合并来源标记（如"高德+百度"）。
5. 美业噪音过滤：请求含"美业"类型时，自动剔除名称含「汽车美容/汽车贴膜/宠物美容/美容维修/汽车养护/美车/中医」的非美业门店（关键词"美容/养生"易误命中）。
6. 输出 Excel：默认桌面 找客户_YYYYMMDD_HHMMSS.xlsx，字段：序号/客户名称/电话/详细地址/所属区县/类型/来源地图/坐标/距离(米)；周边模式按距离升序。自动调列宽 + 冻结首行。

行业映射表

内置：美业 / 餐饮 / 教育 / 医美 / 健身 / 家居 / 母婴 / 宠物 / 汽车 / 商务。完整映射见 references/industry_map.md，可自行追加行业（映射表与脚本内嵌表任一命中即可，两处建议同步维护）。

常见问题

• 高德报 INVALID_USER_IP：Key 启用了 IP 白名单，去高德控制台把当前机器出口 IP 加入白名单（或改为"不限制 IP"）。
• 高德报 30001 ENGINE_RESPONSE_DATA_ERROR：Key 未开通"地理编码"子服务；对"找客户"影响不大（周边/POI 搜索正常），介意可去控制台勾选。
• 某区域无结果：区域名尽量写"城市+区"（如"郑州市经开区"）；试试自由关键词；百度语义接口偶尔区域漂移，脚本已按城市名过滤。
• 百度结果少：百度是语义化 AI 检索、无电话字段，仅作补充，以高德为主。
• 腾讯源显示跳过：属正常——未安装 tmap_client，或区域不含"市"字无法推断城市。需腾讯数据时：pip install tmap_client + 配 Key + 区域写"城市+区"。
• 只想要行政区范围：不要传 --location/--radius 即可。
• Excel 里"距离"为空：非周边模式不计算距离，属正常。

参考

• 行业映射表：references/industry_map.md
• 核心脚本：scripts/find_customers.py
• Key 配置助手：scripts/configure_keys.py
• 高德 API：https://lbs.amap.com/api/webservice/guide/api/search
• 百度 Agent Plan：https://lbs.baidu.com/faq/api?title=agent-plan
• 腾讯位置服务：https://lbs.qq.com/service/webService