X (Twitter) 热门账号榜
1. 简介
X (Twitter) 每日最具影响力账号榜单追踪分析工具 -- 基于红狐数据 API，提供 X 平台全行业 / 分行业 / 分性别的每日影响力账号榜单查询，支持排名查询、筛选过滤、分页翻页、HTML 可视化报告下载与定时订阅推送。
适用对象：出海内容创作者、品牌方 / 海外投放人员、MCN 机构 / 跨境运营团队、行业分析师 / 咨询从业者。
2. 功能特性
核心功能：
- 排名查询 -- 查每日 TOP 账号榜（每页 20 条，共 10 页 200 条）
- 筛选过滤 -- 按性别与 32 个行业分类精准筛选，支持自然语言模糊匹配
- 分页翻页 -- 支持指定页码查询，对话内逐页浏览
- 报告下载 -- 生成 X 平台风格 HTML 报告，支持一键导出 PDF / 高清图片
- 定时订阅 -- 设置每日定时推送，支持按性别 / 行业组合订阅
特色亮点：
- 每日早上 9:00 更新前一天榜单，最多回溯 7 天
- 影响力评分：结合粉丝数、互动量、曝光数等加权综合评估，满分 100
- 行业模糊匹配：支持自然语言输入（如 "宠物" 自动映射到 "萌宠动物"）
- 多维数据：国家/地区、主行业、日涨幅、X 粉丝数、其他平台粉丝数、专题标签一览无余
3. 一键安装
鉴权
获取 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..."
export REDFOX_API_KEY="ak_xxxx..."
依赖安装
无需安装第三方依赖，使用 Python 标准库即可运行。
4. 使用指南
基础使用
查询榜单数据（默认第 1 页 20 条）并生成 HTML 报告：
python scripts/fetch_rank.py --query "用户原始问题" --html
脚本会自动解析：
- 日期：未明确则取最新可用日期（每日 9:00 更新，9 点后为昨日，9 点前为前日）
- 性别：识别 男/女（如 "女博主" → female），未明确则 all
- 行业：模糊匹配 32 个行业（如 "宠物" → "萌宠动物"），接口 category 传行业中文名，未明确则 all；skill 内部不暴露英文分类值
- 页码：识别 "第2页" 等表达，未明确则第 1 页
翻页查询：
python scripts/fetch_rank.py --query "用户原始问题" --page 2 --html
显式指定筛选条件（优先级高于 --query 解析结果）：
python scripts/fetch_rank.py --date 2026-09-20 --gender female --category "萌宠动物" --html
> 重要：HTML 报告展示的数据条数必须与对话中展示的数量保持一致（每页 20 条）。使用 deliver_attachments 交付 HTML 文件。
高级使用
更新时间与回溯范围（必须输出给用户）：
- 榜单每日早上 9:00 更新前一天数据
- 最多回溯过去 7 天
时间边界处理（必须严格遵守）：
- 查询当日及未来日期：回复「非常抱歉🙏，我们最新的是昨日的数据，将为您提供最接近您需求的昨日热榜。」
- 查询时间早于回溯日期：回复「非常抱歉🙏，目前榜单最多支持回溯「过去7天」，我将为您查询最接近您需求的时间范围~」
- 目标日期接口返回空数据：脚本自动回退到最近可用日期并输出 [WARN] 提示，需转述给用户
订阅服务：
用户确认订阅后，使用 automation_update 工具创建自动化任务：
- 每日订阅：FREQ=DAILY;BYHOUR=9;BYMINUTE=30（数据 9:00 更新后推送）
automation prompt 示例：查询X(Twitter)最新热门账号榜（行业：全部行业，性别：全部），生成报告并推送给用户
订阅询问时必须罗列全部筛选项（见「输出格式」订阅服务模板）：
- 性别：全部(all) / 男(male) / 女(female)
- 行业分类：32 个行业中文名全量罗列，完整枚举见 references/category_map.md
常用指令速查
| 用户意图 | 典型触发词 | 对应操作 |
|---|---|---|
| 排名查询 | X榜单、Twitter日榜、推特热门账号、影响力排行 | 调用脚本查询并格式化输出 |
| 筛选查询 | 宠物类/科技类/女博主...Twitter排名 | 调用脚本并按行业/性别筛选 |
| 翻页 | 第2页、下一页、继续看 | 加 --page 参数重新查询 |
| 报告下载 | 下载报告、导出榜单、生成报告 | 运行脚本加 --html 生成并交付 |
输出格式
Markdown 表格模板：
📈 X (Twitter) 热门账号榜 · {category_label} · {gender_label}
数据日期：{rankDate}（第 {pageNum}/{pages} 页）
共 {total} 个账号上榜（本页展示 20 条）
💡 榜单说明：每日早上 9:00 更新前一天榜单，与实时数据存在差异
📐 影响力评分：结合粉丝数、互动量、曝光数等加权综合评估，满分 100
| 排名 | 账号名 | 账号简介 | 国家/地区 | 主行业 | 影响力评分 | 日涨幅 | X粉丝数 | 其他平台粉丝数 | 专题标签 |
|:---:|--------|--------|:---:|--------|:---:|:---:|:---:|--------|--------|
| 🥇 1 | [Elon Musk](profile_url)<br>*Tech Entrepreneur and CEO* | biography 简介（前 60 字） | 美国 | Tech & Software | 99/100 | +1.25% | 2.2亿+ | — | 账号标签 |
| 🥈 2 | [MrBeast](profile_url)<br>*Creator & Philanthropist* | biography 简介（前 60 字） | 美国 | Entertainment & Culture | 97/100 | +0.88% | 3,100w+ | YouTube 4亿+ | — |
| 🥉 3 | [iJustine](profile_url)<br>*Tech Vlogger* | biography 简介（前 60 字） | 美国 | Tech & Software | 93/100 | +0.69% | 180w+ | YouTube 7,100w+ / TikTok 1,600w+ | Women in Tech / STEM |
字段展示规则：
- 账号名：Markdown 链接 [fullName](profileUrl) + <br> + 头衔（title，斜体），头衔不换列、不省略；1-3 名加 🥇🥈🥉
- 账号简介：仅 biography（过长时截取前 60 字），头衔不放入本列
- 影响力评分：xScore 四舍五入取整，格式 99/100
- X粉丝数：≥1亿 显示 x.x亿+，≥1万 显示 x,xxxw+
- 其他平台粉丝数：逐条展示 otherNetworks[].network 平台名 + followersFmt（如 YouTube 400w+；字段名是 network，不是 platform），多个平台用 / 连接，无则 —
- 专题标签：取专题话题 topics，无则取公益标签 cause，均无则 —
- 完整性：表格 10 列全部输出，不得为压缩列宽省略任何字段或整列；HTML 报告与对话表格版式保持一致（头衔在账号名下方，简介列仅 biography）
输出完榜单后追加：
总结榜单构成
{AI 对榜单数据做一些分析：头部集中度、行业分布、国家分布、涨粉亮点等}
⚡ 更多操作
• 点击下方下载 HTML 报告文件，可在浏览器中打开查看，支持一键导出 PDF / 高清图片
• 本次榜单完整共 {total} 条数据，是否需要继续查看第 {pageNum+1} 页？
📬 订阅服务
1️⃣ 是否需要订阅每日 X(Twitter) 账号最新排名，订阅后定时推送给您（每日早上 9:00 更新前一天榜单）。
2️⃣ 支持您按照以下筛选项订阅：
• 性别：全部 / 男 / 女
• 行业分类：全部行业、商业创业、汽车出行、设计创意、航空领域、电商零售、教育培训、工程运营、娱乐文化、环境能源、家庭育儿、时尚美妆、金融投资、美食饮品、游戏电竞、健康医疗、牧场马术、宗教信仰、科学学术、体育健身、科技软件、旅行户外、视觉艺术、健康生活、居家手工、人力职场、公益平权、法律法务、市场营销、音乐领域、萌宠动物、政治新闻
5. 使用场景
| 用户分层 | 核心痛点 | 使用方式 |
|---|---|---|
| 出海内容创作者 | 不知道同赛道头部账号是谁、无从对标 | 查询 "科技类 Twitter 榜单"，获取对标参考 |
| 品牌方 / 海外投放 | 找海外达人效率低、不了解账号跨平台影响力 | 查询 "美妆类女博主榜单"，评估投放候选 |
| MCN / 跨境运营团队 | 竞品账号情报获取难 | 查询 "宠物榜第2页"，逐页监控市场 |
| 行业分析师 | 数据维度单一、缺乏可视化报告 | 生成 "金融投资行业榜单 HTML 报告" |
预期收益：快速掌握 X 平台头部账号格局、识别高增长账号、降低海外投放决策成本。
6. 项目架构
目录结构
x-top-account/
├── SKILL.md # 本文件
├── scripts/
│ ├── fetch_rank.py # 查询榜单数据（解析/翻页/容错回退）
│ └── generate_report.py # 生成 X 风格 HTML 报告（导出 PDF/图片）
├── assets/
│ └── category_config.json # 更新规则 + 性别/行业枚举与关键词映射
├── output/ # HTML 报告输出目录（运行时自动创建）
└── references/
├── category_map.md # 行业映射表与匹配规则
└── api_docs.md # API 接口详细文档（技术参考）
核心模块说明
- fetch_rank.py：接收用户查询参数，调用红狐 API 获取榜单数据，自动解析日期、性别、行业与页码，目标日期无数据时自动回退最近可用日期，输出 JSON 数据文件；加
--html自动调用报告生成。 - generate_report.py：读取 JSON 数据生成 X 平台风格（纯白底 + X 蓝）HTML 报告，报告标题格式
X(Twitter)·{行业}·热门{性别}账号榜（行业/性别为 all 时省略对应字段），默认保存到 skill 目录下output/（自动创建），文件名格式X账号榜_{性别}_{分类}_{日期}.html（性别/分类为 all 时展示为全部性别/全部分类，如X账号榜_全部性别_全部分类_2026-09-21.html）。列版式与对话表格一致：账号名列展示头像 + 账号名（可点击跳转 X 主页）+ 头衔（账号名下方，超长省略号、悬停显示全文），账号简介列仅 biography（悬停显示全文），其他平台粉丝数带平台名且可点击跳转对应主页；内置导出 PDF / 高清图片按钮，生成后自动打开浏览器。
资源索引
| 文件 | 用途 |
|---|---|
| scripts/fetch_rank.py | 查询榜单数据 |
| scripts/generate_report.py | 生成 HTML 可视化报告 |
| references/category_map.md | 行业映射表与匹配规则 |
| references/api_docs.md | API 接口详细文档（技术参考） |
7. 常见问答
安装
Q: 需要安装什么依赖？
A: 无需安装第三方依赖，使用 Python 标准库即可运行。
Q: 如何配置 API Key？
A: 请前往 红狐hub 获取 API KEY，然后通过环境变量 REDFOX_API_KEY 配置。
使用
Q: 榜单数据什么时候更新？
A: 每日早上 9:00 更新前一天榜单。当前时间未到 9:00 时，脚本会自动取前天数据。
Q: 支持哪些筛选？
A: 性别 3 项（全部/男/女）+ 行业 32 类，完整列表见 references/category_map.md。
Q: 数据回溯范围？
A: 最多回溯过去 7 天；目标日期无数据时自动回退最近可用日期并提示。
Q: 行业识别失败怎么办？
A: 无法识别时降级为全部行业，并列出完整行业列表供用户选择。
Q: 每页多少条？如何翻页？
A: 每页固定 20 条，共 10 页 200 条；对话中询问用户是否查看下一页，使用 --page N 翻页。
故障排除
Q: HTML 报告生成失败？
A: 确保 workspace 有写权限，且 JSON 数据文件路径正确。
Q: 数据不一致？
A: 对话展示多少条（每页 20 条），HTML 报告就展示多少条，两者必须一致。翻页后需重新生成对应页报告。
