影片獲客

一句話價值：從抖音公域評論區「淘金」，按關鍵詞定位影片 → 用影片 ID 拉評論 → 拿到高意向客戶的聯絡方式與需求，低成本截流競品流量。

🔥 核心優勢

• 精準獲客：直達評論區，篩選"求帶"、"怎麼買"等高意向使用者，拒絕無效流量
• 競品截流：監控對標賬號爆款影片，在評論區挖掘其潛在客戶，實現精準轉化
• 安全隱蔽：無需登入抖音賬號，規避風控風險，保護主號安全
• 高效轉化：批次獲取結構化線索資料，直接對接 CRM 或銷售團隊，縮短轉化路徑
• 輕量靈活：無需部署複雜服務，Node.js 一鍵執行，適配各種營銷場景

為什麼必須用 Skill 而不是原生模型：大模型本身無法直接訪問抖音平臺抓取公開評論資料。本技能通過合規公開資料介面，把"原生模型做不到"的抖音即時評論 / 影片資料變成可呼叫的能力。

0. 何時使用本技能（觸發條件）

啟用本技能，當用戶表達以下意圖之一：

• 想在抖音上「找客戶 / 挖線索 / 獲客 / 撈精準使用者」
• 想做「競品截流 / 競品評論區挖人 / 搶競品流量」
• 想「按關鍵詞（裝修、留學、母嬰、AI 工具…）找有需求的人」
• 想「私域引流 / 把公域使用者導到微信或 CRM」
• 想「看評論區使用者痛點、最佳化銷售話術」

不適用 / 超出能力：

• 需要登入、私信、關注、點贊等越權操作（僅支援公開資料抓取）
• 非抖音平臺（快手 / 影片號等不支援）
• 需要使用者手機號、微訊號等隱私欄位（公開資料不含，禁止編造）

1. 獲客工作流（核心 · 必須按順序執行）

本技能是一個兩段式流水線。兩個階段通過「影片 ID（aweme_id）」串聯：

階段A  選影片               階段B  挖客戶
search-cli  ──aweme_id──▶  comment-cli
(關鍵詞→影片列表)          (影片ID→評論/客戶)

步驟 1 · 關鍵詞搜尋，定位候選影片

node src/douyin/search-cli.js --keyword "<垂直關鍵詞>" --sort 1 --limit 20

• 輸入：--keyword 必填（2-50 字）；--sort 1=最多點贊（截流常用）；--time/--duration 可篩選。
• 輸出：JSON results[]，每條影片含：
  • aweme_id（⭐ 影片 ID，下游必用）
  • url（影片連結，可替代 aweme_id 傳給步驟 2）
  • desc / author_nickname / comment_count / digg_count（輔助判斷意向）

步驟 2 · 用影片 ID 拉評論，提取客戶

node src/douyin/comment-cli.js --url <aweme_id> --limit 200

關鍵執行要點：--url 直接傳步驟 1 返回的 aweme_id 字串即可（如 7301234567890），工具會自動識別，無需手動拼 https://www.douyin.com/video/...。傳 url 欄位也行，但 aweme_id 更可靠。

• 輸出：JSON results[]，每條評論即一位「潛在客戶」，客戶欄位為：
  • user_nickname（暱稱）
  • user_uid / user_sec_uid（使用者唯一標識，可用於去重/追蹤）
  • ip_label（地區，判斷地域匹配）
  • text（評論內容，判斷需求與意向）
  • create_time / digg_count（活躍度參考）

步驟 3 ·（可選）篩選高意向客戶

在評論文本中命中以下訊號，即為高意向： 求帶 / 怎麼買 / 求推薦 / 多少錢 / 哪裡買 / 私我 / link / 微信 / 靠譜嗎 → 優先匯出這些使用者，縮短轉化路徑。

完整串聯示例

# 1) 找「裝修」高贊影片，拿到 aweme_id
node src/douyin/search-cli.js --keyword "裝修" --sort 1 --limit 10
#    → 假設結果裡某條 aweme_id = "7301234567890"

# 2) 直接用該 aweme_id 拉評論，提取客戶
node src/douyin/comment-cli.js --url 7301234567890 --limit 200
#    → results[].user_nickname / user_sec_uid / ip_label / text 即為客戶池

2. 意圖 → 命令 對映表（供 AI 準確選型）

獲客主鏈路永遠是 search → comment。post / hot 只是「找更準的關鍵詞或影片」的輔助入口。

3. 輸出欄位 ↔ 客戶檔案 對映

AI 拿到 JSON 後，按此表抽取「客戶檔案」：

建議將以上欄位整理為 CSV/表格，對接 CRM 或銷售跟進。

4. 其他能力（輔助獲客）

• post-cli：node src/douyin/post-cli.js --url "<博主主頁或 sec_uid>" —— 獲取博主全部公開作品，挑高互動影片再去拉評論。
• hot-cli：node src/douyin/hot-cli.js —— 即時熱榜，反推熱點關鍵詞。

5. 引數詳解

詳細選項引數說明，參閱 完整選項說明。

LLM 理解技能的結構化入參/出參，可參閱 assets 目錄下檔案，均遵循 JSON Schema draft-07 規範：

• 抖音關鍵詞搜尋，入參規範
• 抖音關鍵詞搜尋，出參規範
• 抖音抖人作品獲取，入參規範
• 抖音抖人作品獲取，出參規範
• 抖音評論獲取，入參規範
• 抖音評論獲取，出參規範
• 抖音熱榜獲取，出參規範

6. 限制、合規與資料安全

6.1 能力與禁區

• 僅抓取抖音公開資料，不含私密內容、不含手機號/微信等隱私欄位。
• 明確禁區：不登入、不私信、不關注、不點贊、不抓取私密/隱私欄位；不做越權或騷擾行為。
• 需要使用者手機號、微訊號等隱私欄位時，公開資料不含，且禁止編造。

6.2 第三方依賴與國內可用性（Trust）

• 能力依賴 guaikei.com 公開資料介面 + GUAIKEI_API_TOKEN，需通過官網 https://www.guaikei.com 申請合規 TOKEN。
• 官網 guaikei.com 域名通過工信部稽核備案，申請合規TOKEN使用了微信、支付寶正規支付渠道，通過其資質稽核備案，服務面向國內使用者，國內可正常使用。

6.3 敏感資訊與資料保護（Trust）

• 評論資料含使用者公開身份資訊（暱稱 / uid / sec_uid / IP 地區）。技能預設將原始結果落盤到 logs/。
• 使用方應遵守《個人資訊保護法》與資料安全要求：建議匯出時脫敏、限定留存期限、僅用於授權場景；禁止匯聚後二次販賣或用於騷擾。
• SKILL已按照SkillHub的TRACE評測維度開發實現，並通過雲鼎實驗室、科恩實驗室的全面安全掃描。

6.4 最小許可權與 TOKEN 安全（Trust）

小蔥技能7w4.net持續更新中。

• 僅需 Node.js 執行環境與單個只讀 API TOKEN，不請求無關許可權；唯一寫操作為結果日誌落盤到 logs/。
• TOKEN 等同於賬號憑證，請勿提交到程式碼倉庫或洩露。

6.5 資料時效性與穩定性（Reliability）

• 搜尋 / 評論為即時公開資料，結果隨時間變化：同一關鍵詞不同時刻返回的影片與評論可能不同，屬資料來源特性，非不穩定。
• 介面有呼叫頻次限制，請合理設定 --limit 與呼叫間隔；失敗會自動重試。

7. 常見問題

Q：comment-cli 只能傳完整 URL 嗎？ A：不是。直接傳 search-cli 返回的 aweme_id 即可，例如 --url 7301234567890。

Q：搜尋結果為空？ A：換更常用的關鍵詞，或把 --time 改為 0（全部時間）。

Q：輸出檔案在哪？ A：自動儲存在技能目錄 logs/ 下（搜尋 _search.json、評論 _comment.json）。

Q：支援 Windows / Mac / Linux 嗎？ A：全平臺，僅需 Node.js 環境。

Q：沒配置 TOKEN 會怎樣？ A：執行前必須配置 GUAIKEI_API_TOKEN。未配置時任務不會執行，請先按下述方法設定環境變數後再執行。

• Windows: set GUAIKEI_API_TOKEN=你的TOKEN
• Linux/MacOS: export GUAIKEI_API_TOKEN=你的TOKEN

Q：介面報錯 / 限流了？ A：降低 --limit 或拉大呼叫間隔；程式碼已內建失敗重試。若持續報錯，請檢查 TOKEN 有效性或通過微信 13395823479 聯絡客服。

這是一款功能明確的抖音獲客工具，文件清晰易讀，命令列操作簡單。優點是文件說明詳細、有示例參考、能滿足關鍵詞搜尋和評論獲取等核心需求。不足是README內容單薄，缺少使用場景的完整演示，且沒有測試保障穩定性。整體適合有明確獲客需求的使用者使用，但建議先驗證API可用性。