用 Google Maps Scraper Skill 把一句自然语言变成客户线索 CSV

「在柏林找牙医，附上他们的网站和邮箱」——把这句话丢给你的 agent，Google Maps Scraper skill 就会把它变成一次有规划、先验证的 Docker 抓取，最终产出一份客户线索 CSV。

为什么这个 Skill 重要

找客户线索通常意味着手动翻 Google Maps，或者为托管 API 付费。这个项目是一个免费、MIT 许可的抓取器——GitHub 6k 星——每家企业暴露 33+ 个数据点：名称、地址、电话、网站、评分、坐标、评论等等。它以 CLI、Web UI、REST API 和可选的自托管 SaaS 版本四种形态提供，而 AI agent skill 是 README 首推的入口：你描述想要的线索，agent 规划搜索、跑一次小规模验证、启动完整的本地抓取、盯着进度，最后帮你处理结果。

安装

npx skills add gosom/google-maps-scraper

这个 skill 适用于 Claude Code、Codex、Cursor、GitHub Copilot 或任何兼容 Agent Skills 的工具。它要求在 macOS、Linux 或 Windows（通过 WSL）上有 Docker 和 Node.js。

实战：从一句话到线索 CSV

1. 用自然语言向你的 agent 提需求——README 的示例是找柏林的牙医，附网站和邮箱。
2. agent 会以非交互方式检查最新的 skill 和 Docker 镜像，推断出合理的搜索默认值，只追问它仍缺的信息。
3. 决定代理方案。你可以自带代理、不用代理，或者从随机抽出的三个代理赞助商里挑；赞助商优惠会明示，凭据在本地终端里通过掩码提示录入（不回显）——绝不粘贴进 agent 聊天。
4. agent 在完整任务前先跑一次小规模验证抓取，然后在后台启动并监控 Docker 爬取。
5. 结果返回时附带保存、过滤、分析或导出的选项——默认 CSV，加 -json 参数则是 JSON。

如果你已经清楚要搜什么，可以直接走 CLI（example-queries.txt 每行一条查询）：

docker run \
  -v gmaps-playwright-cache:/opt \
  -v "$PWD/example-queries.txt:/queries.txt:ro" \
  -v "$PWD/gmaps-output:/out" \
  gosom/google-maps-scraper \
  -input /queries.txt \
  -results /out/results.csv \
  -depth 1 \
  -exit-on-inactivity 3m

技巧

• 邮箱提取默认关闭。-email 参数会让抓取器逐个访问企业网站找邮箱——README 提醒这会显著增加处理时间。
• 要广度不要深度？Fast 模式（Beta）每次查询最多返回 21 条结果、按距离排序；README 警告可能被封锁。
• 大任务中途断了？-resume 会续跑文件抓取，补上缺的企业、跳过已写入的；它要求输出到文件，且使用与原任务相同的选项。
• -c 控制并行任务数，默认为核心数的一半。README 给出的预期吞吐：-c 8 -depth 1 时约每分钟 120 家。
• 默认会收集匿名使用统计；导出 DISABLE_TELEMETRY=1 即可退出。

何时不用这个 Skill

agent skill 依赖 Docker，没有 Docker（或 Windows 上没有 WSL）的话，二进制发行版比这条工作流更适合你。只是临时查一家的信息，直接开 Google Maps 比起一个容器更省事。另外它只抓 Google Maps——其他地图或点评平台需要别的工具。README 的法律声明值得复述一遍：请负责任地使用这个抓取器，未经授权的抓取可能违反服务条款。

查看 排行榜 了解更多 skill。