🗺️ Google Maps 爬蟲

從 Google Maps 提取完整商家資料並發現電子郵件 - 適用於市場研究、商業智能和潛在客戶開發的綜合解決方案。

⚠️ 重要聲明

📋 負責任使用: 此工具專為合法商業研究、市場分析和聯絡方式發現而設計。使用者有責任確保符合相關服務條款和資料保護法規。

🔒 法律合規: 請確保您的使用符合：

• 平台服務條款
• 當地隱私和資料保護法律（GDPR、CCPA等）
• 尊重網站 robots.txt 和速率限制
• 適用的商業和行銷法規

🎯 此工具的功能

本工具從 Google Maps 搜尋結果中提取全面的商家資訊，包括：

• 📍 商家詳情: 名稱、地址、電話、評分、評論數、營業時間
• 📧 電子郵件地址: 透過造訪 Google Maps 列表中的商家網站來提取電子郵件
• 🌍 多語言支援: 支援英文和繁體中文
• ⚡ 高效處理: 每次搜尋最多可處理 120 家商家

非常適合潛在客戶開發、B2B 銷售、市場研究和商業智能。

✨ 主要功能

🗺️ Google Maps 資料提取

• 完整商家檔案: 提取名稱、地址、電話號碼、評分、評論數
• 營業時間: 取得每日詳細營業時間
• 位置資料: 精確的經緯度座標和 Google Place ID
• 商家類別: 自動偵測商家類型（餐廳、商店、服務業等）

📧 電子郵件收集功能

• 網站提取: 造訪 Google Maps 列表中的商家網站以提取電子郵件
• 電子郵件模式偵測: 從網站內容中找出電子郵件地址
• 批次處理: 高效處理多個商家網站
• 網站整合: 使用來自 Google Maps 資料的商家網站進行電子郵件發現

🚀 性能與可靠性

• 並行處理: 同時處理多個搜尋以獲得更快的結果
• 錯誤恢復: 內建重試機制和錯誤處理
• 記憶體優化: 8GB RAM 配置以實現穩定處理
• 超時管理: 基於工作負載的智能超時計算

🌍 多語言與位置支援

• 2 種語言: 英文、繁體中文
• 廣泛覆蓋: 在 Google Maps 上搜尋主要城市和地區的商家
• 本地結果: 透過適當的語言設定獲得地區專屬的商家資料

🚀 快速入門指南

1. 基本使用方法（Apify 平台）

{
    "searchQueries": ["台北咖啡店", "台中餐廳"],
    "maxResults": 100,
    "language": "zh-TW",
    "scrapeEmails": true,
    "maxScrolls": 50
}

2. CLI 使用方法（Apify CLI）

# 安裝 Apify CLI
npm install -g apify-cli

# 執行爬蟲
apify call hObIpg7rlrRbL5X71 \
  -i '{"searchQueries":["高雄牙醫診所"],"maxResults":50,"scrapeEmails":true}' \
  --timeout 3600

3. 進階配置

{
    "searchQueries": [
        "台北 信義區 公司",
        "新竹 東區 咖啡廳",
        "台中 西屯區 餐廳"
    ],
    "maxResults": 100,
    "language": "zh-TW",
    "scrapeEmails": true,
    "maxScrolls": 50,
    "startUrls": [
        {"url": "https://www.google.com/maps/search/台北市中心披薩店"}
    ]
}

📊 輸入參數

參數	類型	預設值	範圍	說明
searchQueries	陣列	必需	1-50 項	搜尋詞彙如「台北咖啡店」
maxResults	數字	100	50-200	每個搜尋查詢的最大結果數
language	字串	"en"	見下方	本地化結果的介面語言
scrapeEmails	布林值	true	-	從商家網站提取電子郵件
maxScrolls	數字	50	30-100	載入更多結果的滾動嘗試次數
startUrls	陣列	[]	0-20 項	直接的 Google Maps 網址（可選）

🌍 支援的語言

• 英文 (en) - 預設
• 繁體中文 (zh-TW) - 台灣、香港

📋 輸出資料結構

每個提取的商家包括：

{
    "名稱": "布納咖啡館 信義館｜網美餐廳｜下午茶｜早午餐｜聚餐｜慶生｜包場｜包廂",
    "地點編號": "ChIJOSbdSz2rQjQRtqbdUdBUfr8",
    "緯度": 25.0331987,
    "經度": 121.5594265,
    "評分": 4.7,
    "評論數": 3310,
    "地址": "110台灣台北市信義區信義路四段415之3號",
    "商家類型": "餐廳",
    "電話": "+886 2 2758 9886",
    "網站": "http://www.buna.com.tw/",
    "網址": "https://www.google.com/maps/place/...",
    "電子郵件": null,
    "營業時間": [
        "星期一: 09:00–00:00",
        "星期二: 09:00–00:00",
        "星期三: 09:00–00:00",
        "星期四: 09:00–00:00",
        "星期五: 09:00–00:00",
        "星期六: 08:00–00:00",
        "星期日: 08:00–00:00"
    ]
}

💡 獲得最大結果的最佳實踐

🎯 搜尋查詢優化

• 具體明確: 「台北大安區義大利餐廳」 > 「餐廳」
• 包含位置: 總是指定城市/區域以獲得準確的本地結果
• 使用商家類別: "牙醫診所"、"水電行"、"咖啡店"、"飯店"
• 鎖定特定區域: "信義區附近的餐廳"、"台中市中心商店"

📍 地理覆蓋策略

為了全面的潛在客戶開發，使用多個搜尋查詢定位不同的區域或鄰里：

範例：

{
  "searchQueries": [
    "台北市大安區牙醫診所",
    "台北市信義區牙醫診所", 
    "台北市中山區牙醫診所",
    "台北市松山區牙醫診所",
    "台北市內湖區牙醫診所"
  ]
}

最佳實踐：

• 將大城市劃分為區域/鄰里以獲得更好的覆蓋率
• 每個商家類型使用 5-10 個地理變化
• 結合商家類別 + 特定位置以獲得有針對性的結果

⚡ 性能優化

{
    "maxResults": 50,        // 速度與覆蓋率的最佳平衡點
    "maxScrolls": 50,        // 平衡結果與處理時間
    "scrapeEmails": true,    // 啟用潛在客戶開發（較慢但有價值）
    "language": "zh-TW"      // 匹配您的目標市場語言
}

🕐 超時與記憶體設定

配置	建議超時時間	預期結果
50 個結果，無電子郵件	30 分鐘	~45 家商家
100 個結果，無電子郵件	60 分鐘	~95 家商家
50 個結果，含電子郵件	45 分鐘	~40 家有電子郵件的商家
100 個結果，含電子郵件	90 分鐘	~80 家有電子郵件的商家
200 個結果，含電子郵件	3 小時	~120 家有電子郵件的商家

記憶體: 8GB（自動配置）
公式: max(1800, 查詢數 × maxResults × 15-25 秒)

🎯 使用案例與行業

🏢 B2B 潛在客戶開發

• 銷售團隊: 建立具有已驗證聯絡資訊的目標潛在客戶名單
• 數位代理商: 尋找需要行銷服務的本地企業
• 軟體公司: 按行業和位置定位企業
• 顧問公司: 研究特定市場中的潛在客戶

📧 電子郵件行銷

• 本地活動: 針對特定地理區域的企業
• 行業專屬: 尋找餐廳、飯店、商店或服務提供商
• 活動推廣: 聯繫本地企業尋求贊助機會
• 合作夥伴拓展: 與互補企業建立聯繫

📊 市場研究

• 競爭對手分析: 繪製競爭對手位置和聯絡資訊地圖
• 市場規模: 計算特定類別和位置的企業數量
• 位置情報: 分析企業密度和分布
• 聯絡資料庫建置: 建立全面的行業目錄

🏪 行業專屬應用

• 房地產: 尋找物業管理公司、房屋仲介
• 餐飲業: 餐廳、咖啡廳、酒吧、外燴服務
• 醫療保健: 牙醫診所、診所、醫療機構
• 零售業: 商店、精品店、專賣店
• 專業服務: 律師事務所、會計師事務所、顧問公司

🐛 疑難排解指南

❌ 常見問題

1. "找不到結果"

原因: 搜尋詞太籠統、該地區沒有商家
解決方案: 使用具體關鍵詞、包含位置、嘗試更廣泛的搜尋詞

2. "驗證失敗"

原因: 輸入參數低於最低要求
解決方案:

• 確保 maxResults 至少為 50（最少：50，最多：200）
• 確保 maxScrolls 至少為 30（最少：30，最多：100）
• 確認語言為 "en" 或 "zh-TW"

3. "達到超時時間"

原因: 大量資料集的超時時間不足
解決方案: 增加超時時間、減少 maxResults、關閉電子郵件提取以加快處理

4. "電子郵件提取率低"

原因: 商家沒有網站、聯絡頁面受保護
解決方案: 正常行為 - 不是所有商家都有可提取的電子郵件

5. "偵測到速率限制"

原因: 對 Google Maps 的請求太頻繁
解決方案: 減少 maxScrolls、稍後再試

✅ 優化提示

1. 從小開始: 擴大前先以 50 個結果測試
2. 使用具體查詢: "台北信義區咖啡廳" > "咖啡"
3. 監控日誌: 檢查 Apify 控制台以獲取詳細進度
4. 調整超時: 使用我們的計算器以獲得最佳設定

⚠️ 重要限制與注意事項

• Google Maps 限制: 每個搜尋查詢最多約 120 個結果
• 電子郵件可用性: 不是所有商家都有可提取的電子郵件地址
• 速率限制: 尊重平台限制並負責任地使用
• 網站可訪問性: 某些商家網站可能限制自動存取
• 地區差異: 結果品質因地理位置而異
• 條款合規: 使用者必須確保所有使用符合適用的服務條款和法規

📞 支援與文件

🆘 獲得協助

1. 檢查日誌: 查看 Apify 控制台日誌以獲取詳細錯誤訊息
2. 驗證參數: 確保所有輸入參數符合最低要求
3. 小規模測試: 從 1-2 個搜尋查詢和 50 個結果開始
4. 超時設定: 使用我們的計算器進行最佳配置

📚 其他資源

• Apify 平台文件
• Google Maps 搜尋技巧
• 潛在客戶開發最佳實踐

🤝 社群

• 分享您的使用案例和成功故事
• 回報錯誤或請求功能
• 加入資料提取相關討論