Google Maps 潛在客戶生成
目標
從 Google Maps 產生高品質 B2B 潛在客戶,並透過爬取網站及使用 Claude 提取結構化聯絡資料,進行深度聯絡資訊豐富化。
輸入參數
| 參數 | 必填 | 說明 |
|---|---|---|
--search | 是 | 搜尋查詢(例如 "台北市水電師傅") |
--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 同步
流程
基本使用
# 建立包含 10 個潛在客戶的新試算表
python3 ./scripts/gmaps_lead_pipeline.py --search "台北市水電師傅" --limit 10
# 附加到現有試算表(建議用於建立資料庫)
python3 ./scripts/gmaps_lead_pipeline.py --search "台中牙醫" --limit 25 \
--sheet-url "https://docs.google.com/spreadsheets/d/..."
# 更高數量
python3 ./scripts/gmaps_lead_pipeline.py --search "新北市屋頂承包商" \
--limit 50 --workers 5
管線步驟
- Google Maps 爬取 - Apify
compass/crawler-google-places回傳商家列表 - 網站爬取 - 抓取主要頁面及最多 5 個聯絡頁面
- 網頁搜尋豐富化 - DuckDuckGo 搜尋擁有者聯絡資訊
- Claude 提取 - Claude 3.5 Haiku 提取結構化聯絡資料
- Google Sheets 同步 - 附加新潛在客戶,並以 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 陣列 of 團隊成員
中繼資料: 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 禁止存取:約 10-15% 的網站會封鎖爬蟲(程式會優雅處理)
- 驗證問題:刪除
token.json並重新驗證 - 重複資料:使用 lead_id(對 名稱|地址 進行 MD5 編碼)進行去重
環境變數
APIFY_API_TOKEN=your_token
ANTHROPIC_API_KEY=your_key
結構定義
輸入參數
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
search | 字串 | 是 | 搜尋查詢(例如 '台北市水電師傅') |
limit | 整數 | 否 | 最大結果數(預設:10) |
sheet_url | 字串 | 否 | 要附加的現有試算表網址 |
workers | 整數 | 否 | 平行工作數(預設:3) |
輸出值
| 名稱 | 類型 | 說明 |
|---|---|---|
sheet_url | 字串 | 包含 36 欄位潛在客戶資料的 Google 試算表網址 |
lead_count | 整數 | 已抓取的潛在客戶數量 |
憑證
| 名稱 | 來源 |
|---|---|
APIFY_API_TOKEN | .env |
ANTHROPIC_API_KEY | .env |
可組合的技能
與此技能良好銜接的技能:classify-leads, casualize-names, instantly-campaigns, onboarding-kickoff
成本
每個潛在客戶 $0.012-0.022