x-top-account
X(Twitter)每日最具影响力账号榜单追踪分析工具;每日早上9:00更新前一天榜单,最多回溯7天;支持性别(男/女/全部)与32个行业分类筛选、分页翻页、HTML可视化报告导出与定时订阅推送;当用户需要查询X/Twitter账号排名、热门账号榜、分行业/分性别榜单、下载榜单报告或订阅推送时使用。触发词:X榜单、Twitter榜单、推特账号排名、X热门账号、Twitter影响力榜、推特大V排行。
Install
npx skills add https://github.com/redfox-data/redfox-community/tree/main/skills/x-top-account
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install redfox-data-redfox-community@llmmart
git clone https://github.com/redfox-data/redfox-community.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole redfox-data/redfox-community collection as a plugin from our marketplace. Git is the plain clone.
README
X (Twitter) 热门账号榜 / x-top-account
中文 | English
简介
帮你快速发现 X (Twitter) 平台最具影响力的账号,掌握全球头部创作者格局。
核心价值 基于每日 X 平台 TOP200 影响力账号的粉丝、涨幅、跨平台数据,帮你解决对标账号、海外投放、竞品监控、行业洞察四大核心问题。
适用对象
- 🌏 出海内容创作者 — 了解同赛道头部账号表现,寻找对标和学习对象
- 🏢 品牌方/海外投放 — 高效筛选优质达人,评估跨平台合作价值
- 📦 MCN 机构/跨境运营 — 掌握竞品动态,制定运营策略
- 📊 行业分析师 — 获取数据洞察,生成分析报告
功能特性
核心功能
- 排名查询:查询 X 平台每日影响力账号榜,每页 20 条、共 10 页 200 条,支持翻页浏览
- 筛选过滤:支持性别(全部/男/女)与 32 个行业分类精准查询,支持模糊词匹配(如"宠物"自动映射萌宠动物)
- 影响力评分:结合粉丝数、互动量、曝光数等加权综合评估,满分 100 分
- HTML 报告生成:生成 X 平台风格的可视化 HTML 文件,账号名可点击跳转 X 主页,支持一键导出 PDF / 高清图片
- 订阅推送:支持设置每日定时自动推送,也可按性别 / 行业组合订阅
密钥获取与安全说明
- 本技能需要使用环境变量:
REDFOX_API_KEY。 REDFOX_API_KEY由 红狐 hub (https://redfox.hk)提供。- 请前往 红狐 hub 注册账号,获取
REDFOX_API_KEY。 - 配置设备环境变量
REDFOX_API_KEY后使用本技能。 - 在提供密钥前,请先确认密钥来源、可用范围、有效期及是否支持重置/撤销。
- 禁止在代码、提示词、日志或输出文件中硬编码/明文暴露密钥。
使用指南
直接用自然语言描述你的需求,无需记忆任何命令格式。
常用说法速查
| 意图 | 示例话术 | 效果 |
|---|---|---|
| 查最新榜 | "给我最新的 Twitter 全品类日榜" | 返回最新日期第 1 页 20 条 |
| 查行业榜 | "宠物类 Twitter 账号排行怎么样?" | 返回萌宠动物行业最新榜单 |
| 查性别榜 | "看看美妆类女博主的 X 榜单" | 返回时尚美妆 + 女性筛选榜单 |
| 指定日期 | "给我 2026 年 9 月 20 日的 Twitter 榜单" | 返回指定日期榜单 |
| 翻页 | "继续看第 2 页" | 返回第 2 页 20 条 |
| 下载报告 | "帮我生成这次榜单的 HTML 报告" | 生成可视化 HTML 文件并交付 |
| 订阅推送 | "我想每天收到宠物类 X 榜单更新" | 创建定时自动推送任务 |
输出示例
📈 X (Twitter) 热门账号榜 · 全部行业 · 全部
数据日期:2026-09-21(第 1/10 页) 共 200 个账号上榜(本页展示 20 条)
💡 榜单说明:每日早上 9:00 更新前一天榜单,与实时数据存在差异
📐 影响力评分:结合粉丝数、互动量、曝光数等加权综合评估,满分 100
| 排名 | 账号名 | 账号简介 | 国家/地区 | 主行业 | 影响力评分 | 日涨幅 | X粉丝数 | 其他平台粉丝数 | 专题标签 |
|---|---|---|---|---|---|---|---|---|---|
| 🥇 1 | 账号名(可点击) | 简介 | 美国 | Tech & Software | 99/100 | +1.25% | 2.2亿+ | — | 标签 |
| 🥈 2 | 账号名(可点击) | 简介 | 美国 | Entertainment & Culture | 97/100 | +0.88% | 3,100w+ | YouTube 4亿+ | — |
| … | … | … | … | … | … | … | … | … | … |
⚡ 更多操作 本次榜单完整共 200 条数据,是否需要继续查看第 2 页?
📬 订阅服务 1️⃣ 是否需要订阅每日 X(Twitter) 账号最新排名? 2️⃣ 支持您按照性别(全部/男/女)与 32 个行业分类筛选项订阅
使用场景
| 场景 | 角色 | 示例问法 | 收益 |
|---|---|---|---|
| 寻找赛道标杆账号 | 出海创作者 / 个体运营 | "科技类 Twitter 账号哪些做得好?" | 快速找到行业头部,明确内容方向 |
| 评估达人合作候选人 | 品牌方 / 海外投放 | "美妆类女博主 TOP20 有哪些表现亮眼?" | 批量筛选,提升投放决策效率 |
| 监控竞品赛道动态 | MCN / 跨境运营团队 | "宠物榜第 2 页有哪些新面孔?" | 实时掌握竞争格局,快速响应市场变化 |
| 生成行业分析报告 | 行业分析师 / 咨询顾问 | "帮我生成金融投资行业榜单的 HTML 报告" | 一键生成可视化 HTML,方便汇报分享 |
| 定期追踪账号排名变化 | 运营团队 | "我想每天收到科技类 X 榜单更新" | 订阅推送,自动化榜单情报获取 |
重要数据说明
榜单更新时间与数据回溯
| 规则 | 说明 |
|---|---|
| 更新时间 | 每日早上 9:00 更新昨日榜单 |
| 回溯范围 | 过去 7 天 |
| 空数据 | 目标日期无数据时,自动回退最近可用日期 |
支持筛选项
- 性别(3 项):全部、男、女
- 行业分类(32 类):全部行业、商业创业、汽车出行、设计创意、航空领域、电商零售、教育培训、工程运营、娱乐文化、环境能源、家庭育儿、时尚美妆、金融投资、美食饮品、游戏电竞、健康医疗、牧场马术、宗教信仰、科学学术、体育健身、科技软件、旅行户外、视觉艺术、健康生活、居家手工、人力职场、公益平权、法律法务、市场营销、音乐领域、萌宠动物、政治新闻
Skill manifest
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 报告就展示多少条,两者必须一致。翻页后需重新生成对应页报告。
Files (redfox-community)
-
assets
-
category_config.json 4.3 KB
Loading…
-
-
references
-
api_docs.md 4.2 KB
Loading… -
category_map.md 3.6 KB
Loading…
-
-
scripts
-
fetch_rank.py 14.8 KB
Loading… -
generate_report.py 13.9 KB
Loading…
-
-
README.en.md 6.3 KB
Loading… -
README.md 6.5 KB
# X (Twitter) 热门账号榜 / x-top-account **中文** | [English](README.en.md) --- ## 简介 帮你快速发现 X (Twitter) 平台最具影响力的账号,掌握全球头部创作者格局。 **核心价值** 基于每日 X 平台 TOP200 影响力账号的粉丝、涨幅、跨平台数据,帮你解决对标账号、海外投放、竞品监控、行业洞察四大核心问题。 **适用对象** - 🌏 出海内容创作者 — 了解同赛道头部账号表现,寻找对标和学习对象 - 🏢 品牌方/海外投放 — 高效筛选优质达人,评估跨平台合作价值 - 📦 MCN 机构/跨境运营 — 掌握竞品动态,制定运营策略 - 📊 行业分析师 — 获取数据洞察,生成分析报告 --- ## 功能特性 ### 核心功能 - **排名查询**:查询 X 平台每日影响力账号榜,每页 20 条、共 10 页 200 条,支持翻页浏览 - **筛选过滤**:支持性别(全部/男/女)与 32 个行业分类精准查询,支持模糊词匹配(如"宠物"自动映射萌宠动物) - **影响力评分**:结合粉丝数、互动量、曝光数等加权综合评估,满分 100 分 - **HTML 报告生成**:生成 X 平台风格的可视化 HTML 文件,账号名可点击跳转 X 主页,支持一键导出 PDF / 高清图片 - **订阅推送**:支持设置每日定时自动推送,也可按性别 / 行业组合订阅 --- ## 密钥获取与安全说明 - 本技能需要使用环境变量:`REDFOX_API_KEY`。 - `REDFOX_API_KEY` 由 [红狐 hub](https://redfox.hk/settings/api-keys?source=github) (`https://redfox.hk`)提供。 - 请前往 [红狐 hub](https://redfox.hk?source=github) 注册账号,获取 `REDFOX_API_KEY`。 - 配置设备环境变量 `REDFOX_API_KEY` 后使用本技能。 - 在提供密钥前,请先确认密钥来源、可用范围、有效期及是否支持重置/撤销。 - 禁止在代码、提示词、日志或输出文件中硬编码/明文暴露密钥。 --- ## 使用指南 直接用自然语言描述你的需求,无需记忆任何命令格式。 ### 常用说法速查 | 意图 | 示例话术 | 效果 | | ---------- | ------------------------------------------ | ----------------------------- | | 查最新榜 | "给我最新的 Twitter 全品类日榜" | 返回最新日期第 1 页 20 条 | | 查行业榜 | "宠物类 Twitter 账号排行怎么样?" | 返回萌宠动物行业最新榜单 | | 查性别榜 | "看看美妆类女博主的 X 榜单" | 返回时尚美妆 + 女性筛选榜单 | | 指定日期 | "给我 2026 年 9 月 20 日的 Twitter 榜单" | 返回指定日期榜单 | | 翻页 | "继续看第 2 页" | 返回第 2 页 20 条 | | 下载报告 | "帮我生成这次榜单的 HTML 报告" | 生成可视化 HTML 文件并交付 | | 订阅推送 | "我想每天收到宠物类 X 榜单更新" | 创建定时自动推送任务 | ### 输出示例 📈 X (Twitter) 热门账号榜 · 全部行业 · 全部 数据日期:2026-09-21(第 1/10 页) 共 200 个账号上榜(本页展示 20 条) 💡 榜单说明:每日早上 9:00 更新前一天榜单,与实时数据存在差异 📐 影响力评分:结合粉丝数、互动量、曝光数等加权综合评估,满分 100 | 排名 | 账号名 | 账号简介 | 国家/地区 | 主行业 | 影响力评分 | 日涨幅 | X粉丝数 | 其他平台粉丝数 | 专题标签 | | :--: | ---------------- | -------------------- | :-------: | --------------------- | :--------: | :-----: | :-----: | -------------- | -------- | | 🥇 1 | 账号名(可点击) | 简介 | 美国 | Tech & Software | 99/100 | +1.25% | 2.2亿+ | — | 标签 | | 🥈 2 | 账号名(可点击) | 简介 | 美国 | Entertainment & Culture | 97/100 | +0.88% | 3,100w+ | YouTube 4亿+ | — | | … | … | … | … | … | … | … | … | … | … | ⚡ 更多操作 本次榜单完整共 200 条数据,是否需要继续查看第 2 页? 📬 订阅服务 1️⃣ 是否需要订阅每日 X(Twitter) 账号最新排名? 2️⃣ 支持您按照性别(全部/男/女)与 32 个行业分类筛选项订阅 --- ## 使用场景 | 场景 | 角色 | 示例问法 | 收益 | | -------------------- | --------------------- | ----------------------------------------- | ---------------------------------- | | 寻找赛道标杆账号 | 出海创作者 / 个体运营 | "科技类 Twitter 账号哪些做得好?" | 快速找到行业头部,明确内容方向 | | 评估达人合作候选人 | 品牌方 / 海外投放 | "美妆类女博主 TOP20 有哪些表现亮眼?" | 批量筛选,提升投放决策效率 | | 监控竞品赛道动态 | MCN / 跨境运营团队 | "宠物榜第 2 页有哪些新面孔?" | 实时掌握竞争格局,快速响应市场变化 | | 生成行业分析报告 | 行业分析师 / 咨询顾问 | "帮我生成金融投资行业榜单的 HTML 报告" | 一键生成可视化 HTML,方便汇报分享 | | 定期追踪账号排名变化 | 运营团队 | "我想每天收到科技类 X 榜单更新" | 订阅推送,自动化榜单情报获取 | --- ## 重要数据说明 ### 榜单更新时间与数据回溯 | 规则 | 说明 | | -------- | --------------------------------- | | 更新时间 | 每日早上 9:00 更新昨日榜单 | | 回溯范围 | 过去 7 天 | | 空数据 | 目标日期无数据时,自动回退最近可用日期 | ### 支持筛选项 - **性别(3 项)**:全部、男、女 - **行业分类(32 类)**:全部行业、商业创业、汽车出行、设计创意、航空领域、电商零售、教育培训、工程运营、娱乐文化、环境能源、家庭育儿、时尚美妆、金融投资、美食饮品、游戏电竞、健康医疗、牧场马术、宗教信仰、科学学术、体育健身、科技软件、旅行户外、视觉艺术、健康生活、居家手工、人力职场、公益平权、法律法务、市场营销、音乐领域、萌宠动物、政治新闻 -
SKILL.md 12.6 KB
--- name: x-top-account description: X(Twitter)每日最具影响力账号榜单追踪分析工具;每日早上9:00更新前一天榜单,最多回溯7天;支持性别(男/女/全部)与32个行业分类筛选、分页翻页、HTML可视化报告导出与定时订阅推送;当用户需要查询X/Twitter账号排名、热门账号榜、分行业/分性别榜单、下载榜单报告或订阅推送时使用。触发词:X榜单、Twitter榜单、推特账号排名、X热门账号、Twitter影响力榜、推特大V排行。 dependency: {} --- # 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](https://redfox.hk/settings/api-keys?source=github) 获取API KEY #### 配置 API Key 方案1: 以OpenClaw为例,将REDFOX_API_KEY添加到~/.openclaw/openclaw.json中 ```bash { "env": { "REDFOX_API_KEY": "ak_xxxx..." } } ``` 方案2: 终端配置:export REDFOX_API_KEY="ak_xxxx..." ```bash export REDFOX_API_KEY="ak_xxxx..." ``` ### 依赖安装 无需安装第三方依赖,使用 Python 标准库即可运行。 --- ## 4. 使用指南 ### 基础使用 **查询榜单数据(默认第 1 页 20 条)并生成 HTML 报告**: ```bash python scripts/fetch_rank.py --query "用户原始问题" --html ``` 脚本会自动解析: - **日期**:未明确则取最新可用日期(每日 9:00 更新,9 点后为昨日,9 点前为前日) - **性别**:识别 男/女(如 "女博主" → female),未明确则 all - **行业**:模糊匹配 32 个行业(如 "宠物" → "萌宠动物"),接口 category 传行业中文名,未明确则 all;skill 内部不暴露英文分类值 - **页码**:识别 "第2页" 等表达,未明确则第 1 页 **翻页查询**: ```bash python scripts/fetch_rank.py --query "用户原始问题" --page 2 --html ``` **显式指定筛选条件**(优先级高于 --query 解析结果): ```bash 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](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/fetch_rank.py) | 查询榜单数据 | | [scripts/generate_report.py](scripts/generate_report.py) | 生成 HTML 可视化报告 | | [references/category_map.md](references/category_map.md) | 行业映射表与匹配规则 | | [references/api_docs.md](references/api_docs.md) | API 接口详细文档(技术参考) | --- ## 7. 常见问答 ### 安装 **Q: 需要安装什么依赖?** A: 无需安装第三方依赖,使用 Python 标准库即可运行。 **Q: 如何配置 API Key?** A: 请前往 [红狐hub](https://redfox.hk/settings/api-keys?source=github) 获取 API KEY,然后通过环境变量 `REDFOX_API_KEY` 配置。 ### 使用 **Q: 榜单数据什么时候更新?** A: 每日早上 9:00 更新前一天榜单。当前时间未到 9:00 时,脚本会自动取前天数据。 **Q: 支持哪些筛选?** A: 性别 3 项(全部/男/女)+ 行业 32 类,完整列表见 [references/category_map.md](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 报告就展示多少条,两者必须一致。翻页后需重新生成对应页报告。
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.