📦 Creativault
v1.0.0Creator Scraper Creativault 创作者数据采集技能。从 TikTok、YouTube、Instagram 搜索并采集创作者/网红数据,支持多维度搜索……
详细分析 ▾
运行时依赖
版本
creator-scraper-cv 技能首次发布,用于在 TikTok、YouTube 和 Instagram 上采集创作者数据。 - 支持按筛选条件搜索创作者/达人、发现相似/同类创作者,以及通过链接/用户名/关键词批量采集数据。 - 提供任务管理、状态轮询及导出功能(xlsx、csv、html)。 - 结果以结构化、易读的表格输出,含配额/积分统计及服务等级明示。 - 强制选择服务等级(S1、S2、S3),并清晰提示用户及披露统计信息。 - 根据用户语言输出多语言结果(中文/英文);为各平台提供专用格式模板。 - 展示结果后提示用户导出数据。
安装命令
点击复制技能文档
前置条件
设置以下环境变量:CV_API_KEY— Creativault Open API Key(后台获取)CV_USER_IDENTITY— 操作者邮箱CV_API_BASE_URL(可选)— API 基址,默认http://api.creativault.vip
Linux / macOS:
``bash
export CV_API_KEY=cv_live_your_key_here
export CV_USER_IDENTITY=your_email@example.com
`
Windows PowerShell:
`powershell
$env:CV_API_KEY = "cv_live_your_key_here"
$env:CV_USER_IDENTITY = "your_email@example.com"
`
能力
| 能力 | 脚本 | 模式 |
|------------|--------|------|
| 搜索达人 | scripts/search_creators.mjs | 同步,实时 |
| 提交采集任务 | scripts/submit_collection_task.mjs | 异步,返回 task_id |
| 提交关键词采集 | scripts/submit_keyword_task.mjs | 异步,返回 task_id |
| 查任务状态 | scripts/get_task_status.mjs | 同步,单次查询 |
| 轮询任务状态 | scripts/poll_task_status.mjs | 每 60s 自动轮询 |
| 获取采集数据 | scripts/get_task_data.mjs | 同步,分页 |
| 服务端导出 | scripts/export_task_data.mjs | 返回文件下载链接 |
| 本地导出 CSV | scripts/export_to_csv.mjs | 管道输入,增量追加 |
| 获取下载链接 | scripts/get_download_url.mjs | 同步 |
| 解析用户名 | scripts/resolve_creator.mjs | 同步,返回 platform_id |
| 找相似达人 | scripts/find_lookalike.mjs | 同步,返回相似列表 |
所有脚本以 JSON 字符串作命令行参数,结果 JSON 输出至 stdout。
语言:用户用中文则回中文,用英文则回英文。
如何选择方案
执行前按用户意图选最佳路径:
| 用户意图 | 方案 | 响应时间 |
|-------------|----------|---------------|
| 带筛选(关键词、国家、粉丝数)“搜索/找达人” | search_creators.mjs | 即时 (~1s) |
| 给定主页链接/用户名找“相似/lookalike/相似达人” | resolve_creator.mjs → find_lookalike.mjs | 即时 (~2s) |
| 指定链接/用户名“采集/抓取”详细数据 | submit_collection_task.mjs → 轮询 → 取数据 | 5~30 分钟 |
| 按关键词找达人并采集详情 | submit_keyword_task.mjs → 轮询 → 取数据 | 5~30 分钟 |
决策规则:
带筛选条件 → 先搜索,即时出结果。- 给指定链接/用户名且要“相似” → 解析+相似流程。
- 给具体链接/用户名 → 采集(异步)。
- 搜索结果已满足 → 不再提交采集。
- 仅当用户明确要详细数据才用采集。
采集完成后必须调用export_task_data.mjs` 生成可下载文件(默认 xlsx)并给下载链接,勿只展示原始 JSON。
服务等级选择
用户不知 S1/S2/S3 含义,必须先询问再搜索,禁止静默选择。
服务等级对照(询问时展示):
| 等级 | 名称 | 返回内容 | 积分/条 | |------|------|----------|---------| | S1 | 纯名单筛选 | 基础信息(用户名、昵称、头像、粉丝数、主页链接) | 1 | | S2 | 精准触达 | S1+国家、性别、互动率、平均播放、带货类目、邮箱标识、语言 | 3 | | S3 | 深度画像 | S2+受众女性比例、受众国家分布、受众语言分布 | 4 |
规则:
- 用户未指定等级 → 展示上表并问:
- 用户明确说“S1/S2/S3”或“深度画像/精准触达/名单” → 直接采用。
- 当前对话已选过等级 → 后续搜索沿用,除非用户改口。
- 每次搜索后在统计区注明所用等级及消耗积分。
- 结果展示后附加: