| name | douyin-account-search |
| description | 抖音账号搜索工具。输入关键词就能搜到抖音上的博主账号，账号名称、粉丝数、总获赞数、关注数、作品数一览无余，点一下链接就能跳转主页看详情。当用户需要搜索抖音账号、查找抖音达人、了解抖音创作者时使用。触发词：抖音账号搜索、抖音达人、抖音博主、搜抖音账号、抖音KOL、抖音网红。 |
抖音账号搜索
📝 简介
输入关键词就能搜到抖音上的博主账号，账号名称、粉丝量、总获赞数、关注数、作品数一目了然，点一下链接就能跳转主页看详情。
✨ 功能特性
| 功能模块 | 能力描述 | 核心价值 |
|---|
| 关键词搜索 | 输入关键词搜索抖音博主账号 | 精准发现目标赛道的账号 |
| 数据展示 | 展示账号名称、粉丝数、总获赞数、关注数、作品数 | 快速评估账号影响力 |
| 主页直达 | 每条结果附可点击的主页链接 | 一键跳转查看账号详情 |
| 翻页浏览 | 每页展示多条结果，支持多页翻看 | 不遗漏任何一个账号 |
🎯 适用对象
- 🔍 内容创作者 — 找同赛道博主，研究对标账号的内容方向和运营思路。
- 📊 运营 / 数据分析 — 快速摸清某个品类在抖音上有哪些头部账号，掌握竞争格局。
- 🏢 品牌 / MCN — 筛选潜在合作达人，按粉丝量评估账号价值，辅助签约决策。
- 🛒 电商选品 — 搜索细分赛道的带货达人，找到匹配的推广人选。
🔑 鉴权
获取 API Key
请前往 红狐hub 获取 API KEY
配置 API Key
方案1: 以 OpenClaw 为例，将 REDFOX_API_KEY 添加到 ~/.openclaw/openclaw.json 中：
{ "env": { "REDFOX_API_KEY": "ak_xxxx..." } }
方案2: 终端配置
export REDFOX_API_KEY="ak_xxxx..."
🔄 工作流程
Step 1：理解用户意图，提取关键词
⚠️ 核心规则：语义理解优先，优先提取细分方向词，而非泛化大类词
1. 提取关键词
- 从用户描述中提取 2~6 字的细分关键词
- 过滤冗余修饰词：用户说的"xx达人""xx博主""xxKOL""xx网红""xx账号"，搜索关键词仅取核心部分 xx，去除末尾的"达人""博主""KOL""网红""账号"等类别修饰词。例如"美妆达人" → 搜索"美妆"，"健身博主" → 搜索"健身"
- 若用户意图模糊（如"帮我搜抖音博主"），主动询问：「请问你想搜索哪个方向或领域的抖音账号？」
- 不得在用户未提供关键词时擅自猜测并调用脚本
2. 识别页码参数（用户未指定时使用默认值）
- 页码（
--page）：默认 1
- 用户提到"下一页"、"第2页" → 对应页码
- 用户提到"上一页" → 当前页 - 1
- 未提及页码 →
1（默认）
Step 2：调用搜索脚本
python3 ~/.agents/skills/douyin-account-search/scripts/search_douyin_account.py "<关键词>" [--page 页码]
参数说明：
| 参数 | 可选值 | 含义 |
|---|
| keyword | 任意字符串 | 搜索关键词 |
--page | 正整数 | 页码，从1开始（默认1） |
脚本以 JSON 格式输出：
| 字段 | 说明 |
|---|
accounts | 匹配的账号列表（保持接口原始顺序） |
page | 当前页码 |
has_next | 是否有下一页（true/false） |
total | 当前页返回条数 |
⚠️ 完整数据读取规则： 脚本输出 JSON 数据量较大时，终端可能截断中间内容并显示 // This is the omitted part。此时必须读取 Bash 输出中提示的完整文件路径（如 Full output saved to: /path/to/file），使用 Read 工具获取完整 JSON 后再生成表格，确保所有字段数据完整可见，不遗漏任何记录。
每条账号字段：
| 字段 | 说明 |
|---|
nickname | 账号昵称 |
account_id | 抖音账号ID |
follower_count | 粉丝数 |
like_count | 总获赞数 |
follow_count | 关注数 |
video_count | 作品总数 |
signature | 账号简介 |
verified | 是否认证 |
profile_url | 主页链接 |
Step 3：判断结果并展示
情况 A：accounts 数量 > 0（有匹配结果）
A1. 告知用户查询范围
📊 关键词「XXX」查询到 N 个抖音账号（第 {page} 页），以下是详细数据：
A2. 渲染 Markdown 表格（全部展示）
| # | 账号名称 | 粉丝数 | 总获赞数 | 关注数 | 作品数 | 主页链接 |
| --- | ---------------- | ------- | -------- | ------ | ------ | --------------------------- |
| 1 | 赵露思 | 305.2w | 1.2亿 | 9 | 156 | [访问主页](profile_url) |
数字格式化规则：
< 10000：原始数字（如 320）≥ 10000 且 < 1亿：x.xw 格式（如 1.2w、305.2w）≥ 1亿：x.x亿 格式（如 1.2亿）
昵称规则： 完整展示，不截断
主页链接规则： 固定显示文字 [访问主页](profile_url)，点击可跳转至抖音账号主页
A3. 翻页提示（⚠️ 紧接在表格之后，不可省略，每次必须输出）
📄 当前第 {page} 页。回复「下一页」继续查看。
- 若
has_next 为 false（已是最后一页）：
📄 当前第 {page} 页，已无更多数据。
翻页时「下一页」调用规则： 若用户回复「下一页」，调用脚本时递增页码：
python3 ~/.agents/skills/douyin-account-search/scripts/search_douyin_account.py "<关键词>" --page {page+1}
⚠️ A1~A3 缺一不可，必须在同一轮输出中连续完成。若缺少 A3，视为执行错误，必须重新补充输出。
情况 B：accounts 数量 = 0（无匹配结果）
B1. 抱歉提示
😔 抱歉，未找到与「XXX」直接相关的抖音账号。
⚠️ B1 必须在同一轮输出中完成，不得中断。
Step 4：结束输出
全部内容展示完毕后，不等待、立刻结束输出。
