又一个神级 Codex Skill 诞生了：一个 API Key，打通全网自媒体数据！

阅读全文

⭐⭐⭐ Spring Boot 项目实战	⭐⭐⭐ Spring Cloud 项目实战
《Dubbo 实现原理与源码解析 —— 精品合集》	《Netty 实现原理与源码解析 —— 精品合集》
《Spring 实现原理与源码解析 —— 精品合集》	《MyBatis 实现原理与源码解析 —— 精品合集》
《Spring MVC 实现原理与源码解析 —— 精品合集》	《数据库实体设计合集》
《Spring Boot 实现原理与源码解析 —— 精品合集》	《Java 面试题 + Java 学习指南》

摘要: 原创出处 http://www.iocoder.cn/Fight/redfox-social-media-api-skill/ 「芋道源码」欢迎转载，保留摘要，谢谢！

🙂🙂🙂关注微信公众号：【芋道源码】有福利：

RocketMQ / MyCAT / Sharding-JDBC 所有源码分析文章列表

RocketMQ / MyCAT / Sharding-JDBC 中文注释源码 GitHub 地址

您对于源码的疑问每条留言都将得到认真回复。甚至不知道如何读源码也可以请教噢。

新的源码解析文章实时收到通知。每周更新一篇左右。

认真的源码交流微信群。

做内容数据开发的人都有个共同感受。想拿热门榜、爆款笔记、公众号增长这些数据，自己写爬虫要天天跟反爬耗，反爬升级一次代码就得改一次；买现成的数据工具会员，又只能人工导出 CSV，接不进自己的系统。

RedFox 想解决的就是这一段。它把自媒体数据封成标准 HTTP 接口，放在 redfox.hk 上，再配一套开源的 Agent Skill，让 Codex、Claude Code 这类助手直接调。它不做需要人工点点的后台看板，一个接口拿数据。

RedFox 官网首页

它卖的是中间那一层归一化

它省下来的其实是三层归一化。第一层是鉴权，十几个平台只用同一个 Key，不用为每个平台维护一套认证和抓取逻辑。第二层是字段，播放、点赞、评论、分享在各平台原生的字段名都不一样，归一之后同一份代码能处理所有平台。第三层是查询，分页、时间范围、排序和多平台聚合走同一套参数。

三层叠起来，你不再需要写一个字段适配层。写爬虫的维护成本是跟着平台走的，平台改一次接口你就改一次代码；这层归一化把维护面从十几个平台收成一份接口契约。

配套的技能仓库放在 GitHub 上，地址是 redfox-data/redfox-community，现在四百多 Star。

redfox-data/redfox-community 仓库首页，Star 420

有一件事要先说清。仓库里放着技能和文档，但根目录当前没有许可证文件，公开可读可拉取，授权条款一个字没写。要接到商业项目里，这一点值得先跟对方确认。

一层接口盖住十几个平台

平台清单是这层归一化的门面。刚介绍它的时候数下来是十一个，含抖音、小红书、视频号、公众号、快手、B 站、西瓜视频、微博、今日头条、百家号、知乎。官方接口文档现在按二十个分组列接口，除了上面那些，还多了 TikTok、X、YouTube、Instagram 这四个海外平台，汽车之家、懂车帝、易车这三个垂类，以及 AI 搜索、AI 工具、多平台聚合三组。

接口文档本身写得比多数同类产品细。每个接口一页，给出 Method、Host、Path、请求头、请求参数表、响应示例和常见状态码，左侧按平台分目录，右上角就是获取密钥的入口。文档层面支持分页、时间范围、排序和多平台聚合查询。

调用长什么样，以及它已经变了

调用形态跟早先那个例子已经不一样了，照抄会直接打不通，所以先把当前的样子写清楚。

现在一律是 POST。域名是 redfox.hk，路径长这样 /story/api/<平台前缀>/<接口名>，抖音榜单是 /story/api/dy/search/likesRank，小红书搜索是 /story/api/xhs/search/search，公众号取文章正文是 /story/api/gzh/ability/temp/article/content。鉴权不走 Authorization 头，是把密钥放进 REDFOX_API_KEY 或者 X-API-KEY 请求头。

密钥在控制台生成，前缀是 ak_。环境变量可以先配上。

export REDFOX_API_KEY="ak_xxxxxx"

以全网热搜查询为例，参数是起止时间，格式到秒。

curl -X POST "https://redfox.hk/story/api/hotKeyword/list" \
  -H "REDFOX_API_KEY: $REDFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"startDate":"2026-09-29 00:00:00","endDate":"2026-09-30 00:00:00"}'

返回是 code 加 data 两层，data 是记录数组。字段名做过归一，播放、点赞、评论、分享各平台都是同一套叫法，这就是前面说的第二层。

接口文档页给出的 BASE URL、平台目录与请求头

Skill 从 45 个涨到了一百多个

技能仓库不到半年就从四十五个涨到一百二十四个，覆盖范围也从采集扩到了分析、改写和下载。官网技能广场的文案写的是「探索超过 100+ 新媒体数据采集和分析技能」。

RedFox 技能广场

每个技能是一个独立目录，核心是一份 SKILL.md，复制到宿主的技能目录就能用。也可以用命令行装。

npx skills init
npx skills add redfox-data/redfox-community

这个命令行工具不在技能仓库里，属于 Agent Skill 生态里独立的那个包，当前版本 1.7.0。装上之后在 Codex 或 Claude Code 里直接说需求就行，Agent 自己去调接口、解析数据、组织结果，不用记接口路径。

仓库 skills 目录

官网现在还多了一条路。平台把接口包成了 MCP 服务，让支持 MCP 协议的客户端直连，接入四步是选平台、选 Key、拿配置、粘进客户端，远程地址形如 mcp.redfox.hk/<平台>/mcp。它已经支持十一个平台，另外六个标着即将上线。

早先的资料里还提过 Python 和 Node.js 的 SDK，官方 README 里没给这两个 SDK 的包名，想用建议以官网开发者文档为准。

四个场景里，三个能立刻用

场景一，每日热点自动入库。挂个定时任务，每天凌晨拉一次热门榜单写进数据库，替掉原来那套爬虫脚本。这是最直接的一个用法。

场景二，低粉爆款监测。接口能按粉丝量和互动量筛出小号做出高互动的笔记，喂推荐模型或者当选题来源都合适。

场景三，发布前的违禁词检查。把正文传进去，返回风险词、风险类型和替换建议。这一条作者实测过，他写了篇多平台对比的文章，跑出来三处风险表述，逐个给了替代表达。

违禁词检查的返回示意

场景四，多平台改写。在 Codex 里说一句把这篇改成另外两个平台的版本，技能会串起相关接口，中间步骤仍然是结构化调用。

前面三个可以直接跑通，第四个更依赖宿主对技能的调度能力，值得先拿个小任务试。

文生图和视频生成也在里面

平台另外接了文生图和视频生成两个能力。文生图在技能里描述需求就能出图，适合给文章配头图；视频生成用的是字节的模型，当前在技能里可以免费调用。

来源那篇的头图就是它自己生成的，作者连生成过程都截了图。数据采集和内容生成放在同一个平台里，省掉的是来回切工具这一步。

技能仓库里还有个叫 redfox-skill-generator 的技能，用途是拿它再生成新的技能。这个用法挺有意思，等于把这套技能集合的扩展也交回给了 Agent。

合规和稳定性，官方怎么说

数据来源是这类服务最该问的问题。官方的自述是通过平台公开接口、合法合作方授权、以及遵守 robots.txt 的公开爬虫三条路取数，不提供破解、模拟登录、绕过反爬这些手段。

对抖音、小红书这类数据敏感的头部平台，官方说明里写的是已取得相关数据服务资质并接受平台定期审核。资质的具体品类和审核周期，官方没有给出公开可查的凭证，这一点得自己找对方确认。

可用性方面，官网注册页展示的是 99.99%，免费额度写的是每日 1,000 次免费调用、无需信用卡，同一屏还有 10K+ 开发者和 500K+ 全网数据。这几个数字都是官网文案，属于服务方的对外承诺，不是第三方实测结果。

怎么开始用

注册流程三步。进官网用邮箱注册，然后到控制台创建 API Key，再照接口文档挑平台调用。

注册入口与三个卖点

密钥管理页给出快速开始三步。创建的密钥以 ak_ 开头，页面上还有跑通第一次调用的引导。未登录也能先看这一页，只是拿不到真实密钥。

API 密钥页与快速开始三步

计费按请求量走，没有月租。按量单价区间是每条请求 0.02 到 0.06 元，按账户累计调用量分六档往下走，最低到标价的五成，优质库和实时库两条基价线不一样。技能本身免费部署，只有调数据接口才计费。

技能包也在第三方技能商店上架了，那边显示的使用量最高一档是两万五。想绕过代码先试手感，可以从商店进；要把数据接进自己的系统，还是得回官网注册领额度。

技能商店里的自媒体技能包

换与不换的判断

该不该换，取决于你现在维护的是什么。如果你那套采集脚本是自己写的、字段适配层是自己拼的，这层归一化确实能省掉一块长期维护。如果你只是偶尔导一次数据，或者手上已经有稳定的导出流程，收益没那么大。

换过去的代价也要说清。换过去之后数据来源成了一层你没法自行审计的中间层。平台的授权状态、接口配额、单价调整都不在你手上；接口文档里也能看到有的平台标着即将上线，覆盖面是按平台逐个补的。

比较务实的做法是先拿免费额度，把最常用的那一两个接口接进现有流程跑两周，看字段够不够、延迟能不能接受，再决定要不要把主要流程换过去。仓库在 https://github.com/redfox-data/redfox-community

图片待确认

TODO @芋艿：IMG-004 未使用——这张是来源作者自己在 Codex 里的会话截图，含个人工作区与对话内容，属需要用户判断的作者产品截图
TODO @芋艿：IMG-006 未使用——这张是来源作者用 Codex 生成头图的会话截图，画面里带作者本机文件路径，属需要用户判断的作者产品截图