creator-lookalike

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 与种子达人不同平台，可发现跨平台相似达人：

# 从 TikTok 达人找 YouTube 上的相似创作者
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"