Creativault Creator Scraper CV 概覽
Creativault Creator Scraper CV 是專為 AI 代理設計的端到端創作者情報技能。
它協助代理發現創作者、收集創作者資料、尋找相似創作者、匯出創作者清單，並在 TikTok、YouTube、Instagram 和 Twitter/X 上執行推廣工作流程。
此技能適用於網紅行銷團隊、成長團隊、創作者合作團隊、DTC 品牌、Shopify 賣家、TikTok Shop 賣家、SaaS 行銷人員、代理商和 KOL 推廣操作人員。
核心功能
- 依平台、國家、利基、關鍵字、粉絲數、觀看數、互動率、受眾和聯絡方式可用性搜尋創作者
- 從一個種子檔案尋找相似或類似的創作者
- 從連結、使用者名稱、檔案或關鍵字大量收集創作者資料
- 追蹤非同步收集任務
- 將創作者資料匯出為 xlsx、csv 或 html 格式
- 發送創作者推廣電子郵件
- 管理批次推廣、後續追蹤及推廣指標
- 策劃從發掘到推廣的完整網紅工作流程
支援的平台
| 平台 | 支援的功能 |
|---|---|
| TikTok | 搜尋、相似創作者、批次收集、關鍵字收集、聯絡資料可用時進行推廣 |
| YouTube | 搜尋、相似創作者、批次收集、關鍵字收集、聯絡資料可用時進行推廣 |
| 搜尋、相似創作者、批次收集、匯出、聯絡資料可用時進行推廣 | |
| Twitter/X | 於支援處以連結、使用者名稱或檔案為基礎的收集 |
子技能
| 子技能 | 用途 | 路徑 |
|---|---|---|
| creator-search | 使用篩選條件搜尋創作者 | discovery/creator-search/SKILL.md |
| creator-lookalike | 從種子檔案尋找相似創作者 | discovery/creator-lookalike/SKILL.md |
| creator-collection | 批次收集創作者資料並匯出結果 | collection/creator-collection/SKILL.md |
| creator-outreach | 發送推廣電子郵件並管理後續追蹤 | outreach/creator-outreach/SKILL.md |
| workflow | 執行完整的網紅活動工作流程 | workflow/SKILL.md |
路由規則
當使用者希望透過篩選條件尋找創作者、網紅、KOL 或社群帳號時，使用 creator-search。
當使用者提供創作者使用者名稱或個人檔案 URL 並要求尋找相似創作者時，使用 creator-lookalike。
當使用者希望從連結、使用者名稱、檔案或關鍵字收集創作者資料，然後匯出結果時，使用 creator-collection。
當使用者希望發送電子郵件、執行批次推廣、管理回覆或追蹤後續追蹤時，使用 creator-outreach。
當使用者希望進行完整的活動，例如尋找創作者、收集資料、匯出清單並準備推廣時，使用 workflow。
安裝
npx skills add https://github.com/creativault/skills/tree/main/creator-scraper-cv
需求
使用前請設定必要的環境變數。
export CV_API_KEY=cv_live_your_key_here
export CV_USER_IDENTITY=your_email@example.com
可選：
export CV_API_BASE_URL=http://api.creativault.vip
| 變數 | 必要 | 說明 |
|---|---|---|
| CV_API_KEY | 是 | Creativault 開放 API 金鑰 |
| CV_USER_IDENTITY | 是 | 操作者電子郵件地址 |
| CV_API_BASE_URL | 否 | API 基礎 URL |
服務等級
| 等級 | 最適合 | 資料深度 | 點數 |
|---|---|---|---|
| S1 | 基本創作者清單建立 | 基本個人檔案和粉絲資料 | 每位創作者 1 點 |
| S2 | 準備推廣的研究 | S1 加上更豐富的個人檔案、聯絡方式、表現和互動欄位（如有） | 每位創作者 3 點 |
| S3 | 深度受眾分析 | S2 加上受眾國家、語言、性別和年齡欄位（如有） | 每位創作者 4 點 |
建議預設值：
- 使用 S1 進行快速清單建立
- 使用 S2 進行推廣工作流程
- 使用 S3 進行付費活動，其中受眾契合度很重要
參數規則
將平台標準化為：
tiktok
youtube
instagram
twitter
使用國家和語言代碼：
{"country_code": "US"}
{"language_code": "en"}
使用 0 到 100 的百分比值：
{"last10_avg_video_interaction_rate_gte": 3}
使用 JSON 布林值：
{"has_email": true}
不要將 quota_remaining 視為點數餘額。僅在 API 回傳錯誤代碼 40201 時顯示點數不足的警告。
範例工作流程
創作者搜尋
尋找美國地區、粉絲數 1 萬到 10 萬、電子郵件可用且互動率高於 3% 的 50 位 TikTok 美妝創作者。
相似創作者發掘
尋找與這個 TikTok 個人檔案相似的 20 位創作者。
批次收集
收集這 100 個 Instagram 創作者連結的詳細資料，並將結果匯出為 xlsx。
推廣
向此清單中所有有可用電子郵件地址的創作者發送一封簡短的合作電子郵件。
完整活動
尋找 100 位美妝類別的 TikTok Shop 創作者，收集他們的資料，匯出清單，並準備推廣活動。
輸出指南
顯示創作者結果時，使用整潔的表格，並且僅包含 API 回傳的欄位。
建議摘要：
摘要：
- 平台：TikTok
- 服務等級：S2
- 顯示的創作者：10
- 消耗的點數：30
- 剩餘每日配額：92
- 請求 ID：xxxxxxxx
預設匯出格式：xlsx。
使用 csv 進行輕量資料處理，使用 html 製作可分享的報告。
參考資料
discovery/creator-search/SKILL.mddiscovery/creator-lookalike/SKILL.mdcollection/creator-collection/SKILL.mdoutreach/creator-outreach/SKILL.mdworkflow/SKILL.mdreferences/api-reference.md