Claude Skill

x-top-account

X(Twitter)每日最具影响力账号榜单追踪分析工具;每日早上9:00更新前一天榜单,最多回溯7天;支持性别(男/女/全部)与32个行业分类筛选、分页翻页、HTML可视化报告导出与定时订阅推送;当用户需要查询X/Twitter账号排名、热门账号榜、分行业/分性别榜单、下载榜单报告或订阅推送时使用。触发词:X榜单、Twitter榜单、推特账号排名、X热门账号、Twitter影响力榜、推特大V排行。

LLM Mart · 0 points · 3 views 0 listing impressions 0 install-command copies
Download redfox-data-redfox-community-skills_x-top-account-5e7b435.zip · 29 KB

Install

skills CLI npx skills add https://github.com/redfox-data/redfox-community/tree/main/skills/x-top-account
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install redfox-data-redfox-community@llmmart
Git 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.

No comments yet.

Reviews (0)

No reviews yet.