💡 為什麼會有這款程式？
這一切的起因，其實是在滑抖音（TikTok）時，看到不少人在推銷外貿獲客軟體，聲稱能一鍵抓取全美商家資料。當時我就在想：「這套邏輯，能不能靠我自己與 AI 的協作開發出來？」
經過實驗，我成功開發出了這套**爬蟲版（Scraper）**系統。我不選擇官方 API 版，是因為 API 雖然穩定但設定繁瑣且有潛在費用。這套「爬蟲版」旨在降低門檻，讓一般外貿 SOHO 族或小公司不需要信用卡與複雜設定，就能在雲端實現自動化獲客。
⚙️ 側邊欄（Sidebar）詳細操作說明：設定你的數位銷售員
儀表板左側的側邊欄是整個系統的「大腦」，您可以透過逐欄填寫，客製化您的開發策略。1. 搜尋定位設定
- 關鍵字 (Keyword)：輸入目標產業，如
Nail Salon（美甲店）或HVAC（空調維修）。 - 搜尋模式 (Mode)：
- 州別模式：適合大範圍掃描。先選擇「州（State）」（如：CA 加州），選單會自動連動顯示該州所有的「郵遞區號 (Zip)」。
- 單一郵遞區號模式：適合精準鎖定商圈，可自訂搜尋半徑（英哩）。
- ➕ 加入 Zip 清單：將選取的郵區加入待掃描清單。您可以一次選取多個商圈，實現連動開發。
💡 地理位置精準鎖定： 首先，在側邊欄選擇目標「州別（State）」。由於系統需要即時讀取內建的數萬筆郵編資料庫（uszips.csv），初次加載時若下拉選單未立即顯示「郵遞區號（Zip Code）」，請稍候片刻或嘗試重新切換州別以觸發數據連動，選單加載完成後即可精準挑選商圈。
2. 公司基本資料 (Company Profile)這部分資料會直接決定 AI 生成開發信的內容，建議詳實填寫：
- Email Language：可切換 英文、西班牙文、法文。考慮到美國南部（如加州、佛州）有大量西語裔店主，切換語系能大幅提高親切感。
- Industry Template：內建產業模板（如：美甲設備、水電維修、SaaS）。選取後，系統會自動帶入對應的定位描述。
- 公司資訊 (Company/Your Name)：填入公司名稱與您的稱呼，這些將作為信件簽名檔。
- 聯絡方式 (Contact Info)：包含電話、Email 與官網。程式會貼心地在表格中將網站轉為「可點擊連結」，方便您隨時檢視客戶官網。
3. 產品優勢與價值主張
- Default Products (1 per line)：輸入您的主打產品。程式會自動將其轉化為開發信中的專業項目清單。
- Value Propositions (1 per line)：輸入您的競爭優勢，例如：「工廠直營價」、「美國現貨 3 天到貨」、「支援小額批發」。
🛠️ 獲客工作流：從爬取到生成開發信
第一步：啟動機器人
設定好側欄後，按下 🚀 開始爬取。系統會自動在後台啟動worker.py（這是我設計的數位工人）。- 監控進度：您可以看著進度條跳動，並透過「實時日誌」觀察機器人現在正在點擊哪間店面。
- 🔄 刷新畫面：由於數據是分批存檔，點擊刷新按鈕即可看到最新的 Leads 列表。
第二步：一鍵「數位肉搜」背景調查
在數據表格中，針對感興趣的商家，系統提供了一鍵跳轉按鈕：- 🔍 Google：查店面評價。
- ⭐ Yelp：看客戶口碑。
- 📷 IG / 👥 FB：觀察對方的社群經營風格。 發信前先做背景調查，能讓您的開發信看起來更像「專屬提案」而非垃圾郵件。
第三步：AI 生成個人化開發信
點擊 🤖 生成開發信，AI 會抓取該店家的名稱、所在城市，結合您在側欄填寫的公司優點，自動產出一封專業的 B2B 開發信。- 下載內容：您可以直接複製信件，或下載為
.txt檔案備存。
🖥️ 為什麼我選擇將儀表板放在 Google Colab？
目前市面上許多免費的儀表板網站（如 Streamlit Cloud）都有嚴格的流量與硬體限制。- 資源優勢：Colab 提供的 12GB RAM 和 CPU 性能優於多數免費 PaaS 平台，跑起 Selenium 爬蟲非常穩定。
- 內網穿透：我使用了 Cloudflare Quick Tunnel 技術，執行後會產出一條隨機的公網連結，讓您直接在瀏覽器操作。
- 安全性：數據存放在您的 Google Drive 環境中，更加私密。
⚠️ 寫在最後的真心建議
這是一個 Demo 版爬蟲程式，旨在分享技術實踐，使用時請注意以下幾點：- 不要過度抓取：短時間掃描過多郵遞區號會導致 IP 被偵測異常，進而導致被 Google 暫時封鎖。建議採「少量多次」的策略進行開發。
- 穩定性說明：由於爬蟲是透過 Selenium 模擬真人瀏覽行為，其穩定性會受到 Google Maps 網頁介面更新或前端選擇器（Selectors）更動的影響。
- API 展望：如果您的業務量極大且不差 API 費用，未來我也會嘗試分享 Google Maps API 的自動化版本，穩定性與掃描速度將會更高。
- 關於檔案持久化（重要！）：
- Colab 的限制：預設情況下，Colab 的檔案空間是暫時性的。一旦執行階段（Runtime）中斷或重新啟動，您辛苦爬取的 leads.csv 以及 worker.py 等設定檔都會自動消失。
- 解決方案：如果您有長期存檔的需求，建議自行將程式碼修改為 Google Drive 整合版本。將工作目錄掛載（Mount）到雲端硬碟中，或是與其他網路硬碟（PaaS）整合，這樣即便 Colab 重開，數據也會安全地儲存在您的雲端硬碟裡。
🔗 專案原始碼與下載
我已經將完整的程式碼與相關設定檔上傳至 GitHub，歡迎大家下載使用、提交建議或與我交流技術心得：
👉 GitHub 專案網址：US-Leads-Scraper-Pro
👉 安裝部署篇:【安裝部署篇】5 分鐘啟動您的雲端獲客工廠
