mcpField
G
gmaps-leads

gmaps-leads

github.com/aiagentwithdhruv营销与增长20136 次安装15 周前更新
代码仓库

关于 gmaps-leads

gmaps-leads 是用于生成 B2B 潜在客户的技能，可从 Google Maps 获取商家信息，并通过网站抓取和联系人提取补充数据，最后同步到 Google Sheets。支持追加到现有表格及并行处理。

主要功能

  1. 01抓取 Google Maps 商家信息
  2. 02提取网站及联系页内容
  3. 03通过 DuckDuckGo 补充联系人信息
  4. 04用 Claude 提取结构化联系人
  5. 05同步至 Google Sheets 并去重
  6. 06配置结果数量和并行工作数

适用场景

  1. 01建立本地商家潜客名单
  2. 02补充潜客的所有者信息
  3. 03向表格追加新潜客

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/aiagentwithdhruv/skills --skill gmaps-leads

安装后在 Claude Code 中输入/gmaps-leads确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

scripts/
extract_website_contacts.py
gmaps_lead_pipeline.py
gmaps_parallel_pipeline.py
scrape_google_maps.py
update_sheet.py

详细介绍

Google Maps 潜在客户开发

目标

从 Google Maps 获取高质量的 B2B 潜在客户，并通过抓取网站和使用 Claude 提取结构化联系信息，深入丰富联系人数据。

输入

参数必填描述
--search是搜索查询（例如："plumbers in Austin TX"）
--limit否最大结果数（默认值：10）
--sheet-url否要追加数据的现有表格
--workers否并行工作线程数（默认值：3）

脚本

  • ./scripts/gmaps_lead_pipeline.py - 主流程编排
  • ./scripts/gmaps_parallel_pipeline.py - 并行版本
  • ./scripts/scrape_google_maps.py - Google Maps 抓取工具
  • ./scripts/extract_website_contacts.py - 网站联系人提取工具
  • ./scripts/update_sheet.py - Google Sheets 同步

流程

基本用法
# Create new sheet with 10 leads
python3 ./scripts/gmaps_lead_pipeline.py --search "plumbers in Austin TX" --limit 10

# Append to existing sheet (recommended for building database)
python3 ./scripts/gmaps_lead_pipeline.py --search "dentists in Miami FL" --limit 25 \
  --sheet-url "https://docs.google.com/spreadsheets/d/..."

# Higher volume
python3 ./scripts/gmaps_lead_pipeline.py --search "roofing contractors in Austin TX" \
  --limit 50 --workers 5

流水线步骤

  1. Google Maps 抓取 - Apify compass/crawler-google-places 返回商家列表
  2. 网站抓取 - 获取主页和最多 5 个联系页面
  3. 网络搜索丰富数据 - 使用 DuckDuckGo 搜索所有者联系信息
  4. Claude 提取 - Claude 3.5 Haiku 提取结构化联系人信息
  5. Google 表格同步 - 追加新的潜在客户，并按 lead_id 去重

输出架构（36 个字段）

商家基本信息： business_name、category、address、city、state、zip_code、phone、website、rating、review_count

提取的联系人信息： emails、additional_phones、business_hours

社交媒体： facebook、twitter、linkedin、instagram、youtube、tiktok

所有者信息： owner_name、owner_title、owner_email、owner_phone、owner_linkedin

团队联系人： 团队成员 JSON 数组

元数据： lead_id、scraped_at、search_query、pages_scraped、enrichment_status

成本

组件每个潜在客户的成本
Apify Google Maps~$0.01-0.02
Claude Haiku~$0.002
DuckDuckGo/HTTP免费
总计~$0.012-0.022

100 个潜在客户：总计约 $1.50-2.50

故障排除

  • “未找到商家”：在查询中包含地点
  • 403 Forbidden：约 10-15% 的网站会屏蔽抓取工具（已妥善处理）
  • 身份验证问题：删除 token.json 并重新进行身份验证
  • 重复项：使用 lead_id（由名称|地址生成的 MD5）进行去重

环境

APIFY_API_TOKEN=your_token
ANTHROPIC_API_KEY=your_key

架构

输入
名称类型必填描述
searchstring是搜索查询（例如：'plumbers in Austin TX'）
limitinteger否最大结果数（默认值：10）
sheet_urlstring否要追加数据的现有表格
workersinteger否并行工作线程数（默认值：3）
输出
名称类型描述
sheet_urlstring包含 36 个字段的潜在客户数据的 Google 表格 URL
lead_countinteger抓取的潜在客户数量
凭据
名称来源
APIFY_API_TOKEN.env
ANTHROPIC_API_KEY.env
可组合使用

与此技能搭配良好的技能：classify-leads、casualize-names、instantly-campaigns、onboarding-kickoff

成本

每个潜在客户 $0.012-0.022

评论

支持 Markdown