| name | creator-lookalike |
| description | CreatiVault official lookalike creator discovery skill. MUST be used when the user wants
to find similar creators/KOLs/influencers based on a seed username, profile URL, creator UID,
platform, audience style, content style, region, language, follower range, or cross-platform
expansion. Use scripts/find_lookalike.mjs and CreatiVault OpenAPI as the authoritative source.
Do not use web search unless the user explicitly asks for public web search or confirms fallback.
Use when: similar creators, lookalike creators, find similar influencers, find similar KOLs,
creator lookalike, seed creator, cross-platform creator search, TikTok to YouTube creators,
相似达人, 类似达人, 找相似, 找同类型达人, 种子达人, 跨平台找达人, 根据主页找相似,
根据用户名找相似, 根据达人找相似.
相似达人发现能力，支持种子达人解析、相似度匹配、跨平台搜索。通过 username、profile_url 或自动全平台搜索找到风格相似的创作者。
Use when: 相似达人, 类似达人, similar creators, lookalike, find similar
|
| compatibility | Node.js 20.6+ |
| metadata | {"layer":"discovery","parent":"creator-scraper-cv"} |
概述
基于种子达人查找风格相似的创作者，支持同平台匹配和跨平台发现（如从 TikTok 达人找到 YouTube 上的相似创作者）。
脚本引用
| 脚本 | 路径 | 模式 | 状态 |
|---|
| find_lookalike.mjs | ../../scripts/find_lookalike.mjs | Sync, 自动解析 username/URL | ✅ |
输入方式
API 内部自动将 username/URL 解析为平台 ID，无需额外 resolve 步骤。
方式一：username + platform（指定平台）
明确指定达人所在平台，直接在该平台查找相似达人：
node ../../scripts/find_lookalike.mjs '{"username":"creator_demo","platform":"tiktok","limit":10}'
方式二：profile_url（自动识别平台）
传入达人主页链接，API 自动解析平台和用户名：
node ../../scripts/find_lookalike.mjs '{"profile_url":"https://www.tiktok.com/@creator_demo","limit":10}'
支持的 URL 格式：
- TikTok:
https://www.tiktok.com/@username
- YouTube:
https://www.youtube.com/@username
- Instagram:
https://www.instagram.com/username
方式三：username only（搜索全平台）
仅传入用户名，不指定平台，API 自动在 TikTok、YouTube、Instagram 三个平台搜索匹配：
node ../../scripts/find_lookalike.mjs '{"username":"creator_demo","limit":10}'
参数说明
| 参数 | 类型 | 必填 | 说明 |
|---|
username | string | 二选一 | 达人用户名（不含 @），与 profile_url 二选一 |
platform | string | 否 | 种子达人平台：tiktok / youtube / instagram，省略则搜索全平台 |
profile_url | string | 二选一 | 达人主页链接（自动识别平台），与 username 二选一 |
target_platform | string | 否 | 目标搜索平台，省略则与种子达人同平台。设为不同平台可实现跨平台搜索 |
target_region | string | 否 | 目标国家代码，all 表示不限 |
target_language | string | 否 | 目标语言代码，all 表示不限 |
limit | integer | 否 | 返回数量，默认 20，最大 50 |
follower_min | integer | 否 | 最小粉丝数 |
follower_max | integer | 否 | 最大粉丝数 |
avg_views_min | integer | 否 | 最小平均播放量 |
avg_views_max | integer | 否 | 最大平均播放量 |
female_rate_min | number | 否 | 最小女性受众比例（0~100） |
lang | string | 否 | 响应语言：cn / en，仅控制返回字段翻译，不筛选达人 |
service_level | string | 否 | 服务等级，默认 S1 |
跨平台搜索说明
设置 target_platform 与种子达人不同平台，可发现跨平台相似达人：
node ../../scripts/find_lookalike.mjs '{"username":"creator_demo","platform":"tiktok","target_platform":"youtube","limit":10}'
输出格式
🔍 找到 N 个与 @seed_username 相似的达人
📊 相似达人列表
| # | 用户名 | 昵称 | 粉丝数 | 平均播放 | 互动率 | 相似度 | 国家 | 主页链接 |
| --- | ----------- | ----------- | ------- | -------- | ------- | ------ | ---- | ----------------- |
| 1 | username1 | Nickname1 | 120K | 3.8万 | 7.20% | 85.0% | US | [查看][link1] |
| 2 | username2 | Nickname2 | 95.5K | 2.1万 | 5.50% | 78.3% | US | [查看][link2] |
[link1]: https://www.tiktok.com/@username1
[link2]: https://www.tiktok.com/@username2
📈 统计信息
• 种子达人：@seed_username（平台ID：7123456789）
• 结果总数：N 个相似达人
• 本次消耗：10 积分
• 剩余配额：xxx 次
• 请求ID：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
返回字段：uid、username、nickname、avatar_url、profile_url、country_code、followers_count、avg_views、engagement_rate、match_score。
其中 match_score 为相似度评分（0~100），按相似度降序排列。
错误处理
| 错误码 | 说明 | 处理方式 |
|---|
| 40401 | 达人不在数据库中 | 告知用户该达人尚未被平台收录，建议换一个达人或提交采集任务 |
| 40001 | 参数无效 | 检查 username/profile_url 格式 |
| 42902 | 每日配额耗尽 | 等待 UTC 00:00 重置或升级套餐 |
决策规则
- 用户给出主页链接 → 使用
profile_url 参数
- 用户给出用户名 + 平台 → 使用
username + platform
- 用户仅给出用户名 → 仅传
username，API 搜索全平台
- 用户要求"找 YouTube 上类似的" → 设置
target_platform: "youtube"
