前言¶
線下獲客或本地商戶調研時，常需要在某個城市裏按品類搜一批門店，再整理成可導入通訊錄或表格的手機號列表。手工在地圖 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。
