前言¶
线下获客或本地商户调研时,常需要在某个城市里按品类搜一批门店,再整理成可导入通讯录或表格的手机号列表。手工在地图 App 里逐条复制,很难规模化。
下面介绍 SkillHub 社区 Skill「有钱之前」(@user_e1f92728/yqzq283928,v1.0.11,分类 life-service)。它把高德、百度、腾讯三家地图的 POI 搜索串成一条「阶梯降级」流水线,在全国任意城市按关键词检索商家,并同时生成桌面上的 Excel 与 vcf 通讯录文件。Skill 标注 requires_api_key=true,使用前需自行申请并配置地图 Web 服务密钥。
这是什么¶
「有钱之前」由社区发布者 user_e1f92728 维护,来源为 community。定位是多地图商家手机号搜索(Skill 包内副标题为「阶梯降级版」):Agent 按 Skill 说明理解你的「城市 + 多个关键词」意图,必要时调用包内 Python 脚本 scripts/amap_search.py 完成检索与导出。
官方入口:
- API 页:https://api.skillhub.cn/user_e1f92728/yqzq283928
- SkillHub 页:https://www.skillhub.cn/skills/user_e1f92728/yqzq283928
截至脚本抓取时,该 Skill 在 SkillHub 上评分为 100000,下载 1180 次。
核心功能¶
已核实能力如下(均来自 v1.0.11 包内 SKILL.md 与 scripts/amap_search.py):
- 全国城市 + 多关键词搜索:输入格式为「城市 关键词1 关键词2 …」,例如「厦门 蛋糕 甜品 面包」。
- 阶梯降级:默认只用高德(三级行政区划,Skill 说明为最精准);高德日额度用尽后自动切百度,百度用尽再切腾讯;三家都耗尽则提示次日再试,切换时会通知当前使用的地图。
- 双格式输出:在桌面生成
{城市}_{日期}.xlsx(店名、手机号、地址等)与同名.vcf(便于导入手机通讯录);可用--out指定输出目录。 - 号码过滤规则(
references/quickstart.md):仅保留手机号,固话格式会被过滤;同一店名只保留第一个匹配到的手机号。 - 密钥不进 Skill 仓库:Key 写在用户本机配置文件,不写入技能文件。
| 平台 | Skill 文档中的每日额度说明 |
|---|---|
| 高德 | 5000 次 |
| 百度 | 未知(备胎) |
| 腾讯 | 10000 次(备胎) |
安装与启用¶
安装 SkillHub CLI¶
若尚未安装,按 SkillHub 官方安装文档检查或安装 CLI:
command -v skillhub && skillhub --version
未安装时可执行(完整安装,含默认 Skill):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
说明见:https://skillhub.cn/install/skillhub.md
安装「有钱之前」¶
官方页面给出的安装提示为:根据上述安装文档,安装 @user_e1f92728/yqzq283928。CLI 搜索结果显示的等价命令为:
skillhub install yqzq283928 --namespace user_e1f92728 --dir <当前 Agent 的 skills 目录>
不同客户端的 skills 目录(摘自 SkillHub 安装文档):
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或项目下的.agents/skills/
安装后需让 Agent 重新加载 skills(各客户端方式不同,以你所用环境为准)。
配置地图 API Key¶
SKILL.md 要求至少配置高德 Web 服务 Key;百度、腾讯 Key 选填,用于降级。
在 ~/.qclaw/workspace/map_config.json 写入:
{
"amap_key": "你的高德Web服务API密钥(必填)",
"baidu_key": "你的百度AK(选填)",
"tencent_key": "你的腾讯Key(选填)"
}
脚本 amap_search.py 亦支持旧文件名 ~/.qclaw/workspace/amap_config.json(仅 amap_key 时会被读取并映射到统一配置)。
申请地址(Skill 文档与脚本提示):
- 高德:https://console.amap.com/dev/key/app(Key 类型选「Web 服务」)
- 百度:https://lbsyun.baidu.com(应用类型选「服务端」);脚本降级提示中还有 https://lbsyun.baidu.com/apiconsole/key/create
- 腾讯:https://lbs.qq.com/console/mykey.html(脚本在需配置
tencent_key时打印)
典型用法¶
在对话里使用¶
配置好 Key 后,按 Skill 约定直接发送一行查询,例如:
厦门 蛋糕 甜品 面包
北京 火锅 烧烤 串串
上海 奶茶 咖啡 甜品
Agent 按 Skill 流程搜索完成后,应告知桌面上的 .xlsx 与 .vcf 路径。
命令行直接跑脚本¶
Skill 包内脚本支持独立调用(需本机 Python 3):
python scripts/amap_search.py 城市 "关键词1 关键词2" [输出前缀] [--out 目录]
默认输出目录为 ~/Desktop;缓存目录为 ~/.qclaw/workspace/.map_cache。
适用场景与注意¶
适合谁
- 需要在指定城市、按多个品类关键词批量拉取商家联系方式,并导出 Excel 或 vcf 的从业者(Skill 分类为生活服务类获客工具)。
- 已能申请并管理高德(及可选百度、腾讯)地图开放平台密钥的开发者或运营。
限制与注意
- 依赖外网与配额:三家地图均有调用额度;高德用尽才会降级,需自行关注控制台用量与合规使用范围。
- 配置路径:Skill 与脚本默认读写
~/.qclaw/workspace/;在 Cursor 等环境使用时,需保证该路径可写,或确认 Agent 会按 Skill 调用脚本而非仅口头回复。 - 数据合规:导出的是公开 POI 中的联系方式,实际使用须遵守地图平台服务条款、个人信息保护相关法规及业务场景要求;Skill 本身不提供脱敏或授权校验。
- 文档差异:
references/quickstart.md以 Windows 路径示例amap_config.json为主;主流程以SKILL.md的map_config.json为准,脚本已兼容两者。
结尾¶
「有钱之前」把多地图搜索、额度降级和 Excel/vcf 导出封装成 Agent Skill,用「城市 + 关键词」即可完成一轮本地商户手机号整理。安装与密钥配置以 SkillHub 官方页与 https://skillhub.cn/install/skillhub.md 为准;Skill 详情见 https://www.skillhub.cn/skills/user_e1f92728/yqzq283928。