影片獲客
📖 技能介紹
name: shipin-huoke description: 抖音公域評論區精準獲客工具。當用戶需要「挖掘潛在客戶/銷售線索、私域引流、按關鍵詞找抖音高意向使用者」時啟用。標準流程：①關鍵詞搜尋影片拿到 aweme_id → ②用 aweme_id 拉取評論、提取客戶資訊（暱稱/uid/sec_uid/地區/評論內容）。 license: MIT metadata: version: 1.0.1 enabled: true type: command runtime: "nodejs@16.14.0+" requires: bins: - "node" env: - "GUAIKEI_API_TOKEN" category: - "Growth Hacking" - "Sales & Leads" - "Marketing Automation" tags: - "customer-acquisition" - "lead-generation" - "competitor-interception" - "public-traffic" - "douyin" - "sales" - "marketing" - "conversion" - "pipeline" schemas: - name: "搜尋入參" file: "assets/search_cli_req.schema.json" - name: "搜尋出參" file: "assets/search_cli_resp.schema.json" - name: "作品入參" file: "assets/post_cli_req.schema.json" - name: "作品出參" file: "assets/post_cli_resp.schema.json" - name: "熱榜出參" file: "assets/hot_cli_resp.schema.json" - name: "評論入參" file: "assets/comment_cli_req.schema.json" - name: "評論出參" file: "assets/comment_cli_resp.schema.json" examples: # —— 關鍵：端到端獲客流水線示例（搜尋 -> 評論），讓 AI 學會串聯 —— - name: 端到端獲客（搜尋後立刻用 aweme_id 拉評論） command: 'node src/douyin/search-cli.js --keyword "裝修" --sort 1' description: 先拿到候選影片的 aweme_id（如 7301234567890） - name: 用上一步的 aweme_id 拉評論、提取客戶 command: "node src/douyin/comment-cli.js --url 7301234567890 --limit 200" description: 直接把 search 返回的 aweme_id 傳給 --url，無需拼完整 URL；結果裡 user_nickname/user_uid/user_sec_uid/ip_label/text 即為客戶資訊 # —— 單步能力示例 —— - name: 競品爆款影片截流 command: 'node src/douyin/search-cli.js --keyword "競品品牌名" --sort 1' description: 鎖定競品高贊影片，再用其 aweme_id 拉評論挖客戶 - name: 監控對標賬號內容策略 command: 'node src/douyin/post-cli.js --url "https://www.douyin.com/user/MS4wLjABxxx"' description: 獲取博主作品列表，挑高互動影片再去拉評論 - name: 借勢熱榜獲客 command: "node src/douyin/hot-cli.js" description: 看即時熱點，選話題關鍵詞回去做搜尋+評論
影片獲客
一句話價值：從抖音公域評論區「淘金」，按關鍵詞定位影片 → 用影片 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 準確選型）
| 使用者真實意圖 | 應呼叫的 CLI | 關鍵引數 | 輸出用途 |
|---|---|---|---|
| 按關鍵詞找影片/客戶 | search-cli.js |
--keyword --sort |
得到 aweme_id |
| 拿某影片的評論/客戶 | comment-cli.js |
--url <aweme_id> |
得到客戶欄位 |
| 監控對標賬號內容 | post-cli.js |
--url <主頁/ sec_uid> |
挑影片再去拉評論 |
| 看熱點借勢 | hot-cli.js |
無 | 反推關鍵詞回步驟 1 |
獲客主鏈路永遠是 search → comment。post / hot 只是「找更準的關鍵詞或影片」的輔助入口。
3. 輸出欄位 ↔ 客戶檔案 對映
AI 拿到 JSON 後，按此表抽取「客戶檔案」：
| 業務含義 | 來源欄位（來自 comment-cli） |
|---|---|
| 客戶暱稱 | user_nickname |
| 客戶唯一 ID | user_uid / user_sec_uid |
| 客戶所在地區 | ip_label |
| 客戶需求/痛點 | text |
| 互動熱度 | digg_count |
| 觸達時間 | create_time |
建議將以上欄位整理為 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）
- 僅需 Node.js 執行環境與單個只讀 API TOKEN，不請求無關許可權；唯一寫操作為結果日誌落盤到
logs/。本技能來自小蔥技能站7w4.net。
- 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 聯絡客服。
🤖 AI 評測
這是一款功能明確的抖音獲客工具，文件清晰易讀，命令列操作簡單。優點是文件說明詳細、有示例參考、能滿足關鍵詞搜尋和評論獲取等核心需求。不足是README內容單薄，缺少使用場景的完整演示，且沒有測試保障穩定性。整體適合有明確獲客需求的使用者使用，但建議先驗證API可用性。
