CreatiVaultCreatiVault
SkillsOpenAPI
文档导航

快速开始

把 CreatiVault 的达人搜索、采集、相似达人和建联能力接入你使用的 AI 助手。

💡
开始前，请先准备 CreatiVault 账号、在 Skills 页面创建的 API Key，以及支持 Skills 的 AI 助手（Codex、Cursor、Claude Code、Kiro、GitHub Copilot 等）。

先确认你要完成的目标

你不需要填写接口参数，只要把目标直接告诉AI 助手。它会根据目标选择搜索、采集、导出、相似达人或建联流程。

使用场景你想完成什么推荐说法
快速找达人按国家、行业、粉丝、互动率、邮箱等条件筛出候选名单帮我找 5 位美国 TikTok 美妆达人，粉丝 1 万到 10 万，要有邮箱，用 S2
批量补全资料已有一批主页链接或用户名，需要采集主页、联系方式和表现数据帮我采集这些 TikTok 达人的数据：[粘贴链接或用户名]
找相似达人围绕一个种子达人扩展风格、受众或内容相似的达人帮我找和 @creator_demo 相似的美国 YouTube 达人
推进建联给筛选出的达人发起邮件沟通、跟进合作意向给这些有邮箱的达人发送合作邀约，并记录后续跟进状态

第一步：让AI 助手安装技能

把下面这句话发给AI 助手即可。它会从 CreatiVault 官方技能仓库安装正式版达人采集能力；如果当前环境不支持自动安装，可以联系团队管理员协助完成。

复制给AI 助手
请使用 npx skills add creativault/skills --skill creator-scraper-cv 安装官方 CreatiVault Skill

第二步：配置账号授权

API Key 可以理解为“授权钥匙”：它告诉系统是谁在调用 CreatiVault、能使用哪些能力、消耗哪个账户的积分。邮箱用于记录操作者，方便团队追踪任务和排查问题。

💡
在账户 Skills 页面创建 Key，并由管理员配置到运行环境。不要把真实 Key 发进聊天记录、公开群或代码仓库。
变量必填描述
CV_API_KEY是CreatiVault 的授权钥匙，决定调用权限、积分账户和可用额度
CV_USER_IDENTITY是操作者邮箱，用于记录是谁发起搜索、采集、导出或建联
CV_API_BASE_URL否生产 API 地址：http://api.creativault.vip；Skill 请求使用该地址下的 /openapi/v1/... 路径
复制给AI 助手或团队管理员
请帮我配置 CreatiVault Skills：
CV_API_KEY=你的 API Key
CV_USER_IDENTITY=你的工作邮箱
CV_API_BASE_URL=http://api.creativault.vip

第三步：开始使用

安装完成后，先用一个小范围任务验证链路，再扩大采集规模。

示例提示词
搜索美国 TikTok 美妆达人，粉丝 1 万到 10 万，要有邮箱，用 S2
采集这些 YouTube 频道的数据：@channel1, @channel2
帮我找和 @creator_demo 相似的 Instagram 健身达人
把搜索结果导出成 Excel

选择合适的数据等级

建议先用 S1/S2 缩小候选范围，确认名单方向后再使用 S3 获取深度画像。

等级适合场景计费主要返回内容
S1快速筛名单、判断达人是否值得继续看按生效规则基础身份、主页、粉丝、联系方式存在性等
S2需要精准触达和评估合作价值按生效规则国家、性别、粉丝、播放、互动、行业、邮箱等
S3需要做受众画像和投放/合作决策按生效规则受众性别、国家、语言、年龄分布等

首次上线检查

  • •AI 助手已安装成功，并能识别 creator-scraper-cv 达人采集能力。
  • •API Key 和操作者邮箱已配置，并确认这个 Key 有可用积分和权限。
  • •先执行一次 5 到 10 条的小范围搜索，确认能返回达人列表。
  • •需要分享给团队或客户时，再执行导出 Excel/CSV。

备用方式：手动安装

如果AI 助手所在环境不能直接安装 Skills，可以使用下面的源码方式。大多数情况下不需要执行这一步。

Terminal
git clone https://github.com/creativault/skills.git
cp -r skills/creator-scraper-cv your-agent/skills/