Skip to content
Back to search

redfox-api-helper

SkillWorks with Claude CodeGitHub

检索并调用 RedFoxHub(红狐数据)API,覆盖抖音、小红书、公众号、B站、快手、视频号、TikTok、YouTube、X、Instagram、微博、知乎、汽车与电商平台、全网热点榜、AI 搜索、图片/视频生成、素材上传、账户余额等 28 类共 201 个端点。当用户需要查社媒账号/作品/评论/榜单数据、热点、达人、商品数据,或要调用红狐接口时使用。Use when the user asks for RedFox / 红狐 data, or social media data that can be fetched through these endpoints.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/liangdabiao--redfox-api-skill/badge.svg)](/listings/liangdabiao--redfox-api-skill)

HTML

<a href="/listings/liangdabiao--redfox-api-skill"><img src="/api/listings/liangdabiao--redfox-api-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

把整个仓库目录放进 skills 目录即可(目录名建议 `redfox-api-helper`):

# Claude Code
git clone https://github.com/liangdabiao/redfox_api_skill.git ~/.claude/skills/redfox-api-helper

# WorkBuddy 项目级
git clone https://github.com/liangdabiao/redfox_api_skill.git .workbuddy/skills/redfox-api-helper

或者直接把本目录的文件拷进一个文件夹(`README.md` 可选)。

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 79 lines
  1. ---
  2. name: redfox-api-helper
  3. description: 检索并调用 RedFoxHub(红狐数据)API,覆盖抖音、小红书、公众号、B站、快手、视频号、TikTok、YouTube、X、Instagram、微博、知乎、汽车与电商平台、全网热点榜、AI 搜索、图片/视频生成、素材上传、账户余额等 28 类共 201 个端点。当用户需要查社媒账号/作品/评论/榜单数据、热点、达人、商品数据,或要调用红狐接口时使用。Use when the user asks for RedFox / 红狐 data, or social media data that can be fetched through these endpoints.
  4. ---
  5. # RedFoxHub API Helper
  6. 本仓库根目录就是 Skill 目录。`SKILL.md`、`apis.json`(201 个端点的本地目录)、`api_searcher.py`(检索)、`api_client.py`(调用)都在这一层,`README.md` 是给人看的说明。命令都在该目录执行。
  7. ## 数据源
  8. `apis.json` 是唯一数据源,含每个端点的 HTTP 方法、路径、中英文摘要、真实请求字段名、必填项、默认值和可直接执行的 `example_call`。检索脚本只读本地文件,不联网、不消耗积分。
  9. ## 配置 API Key
  10. 调用前必须有 key,从 https://redfox.hk/settings/api-keys 获取。读取顺序:`--token` → 环境变量 `REDFOX_API_KEY` → 本目录及上级目录的 `.env`。没配会直接报错,不会静默发请求。**不要把 key 写进本仓库。**
  11. ```bash
  12. export REDFOX_API_KEY="ak_xxxxxx"
  13. ```
  14. ## 工作流
  15. 1. 用关键词或平台列端点:`python api_searcher.py "小红书 搜索 笔记"`、`python api_searcher.py platform:xiaohongshu`、`python api_searcher.py platforms`
  16. 2. 用 `detail:` 查真实字段名和必填项:`python api_searcher.py detail:douyin.search_users`
  17. 3. 按 `example_call` 调用:`python api_client.py POST /story/api/dyData/searchUser "keyword=乐高"`
  18. 4. 看响应:`code: 2000` 为成功,数据在 `data`;`3203/3801` 且文案为查无数据时是**空结果**(不是调用失败,退出码 0);其他 code 才是业务错误(见下方)。
  19. ## 命令速查
  20. ```bash
  21. python api_searcher.py "抖音 账号 搜索" --limit 5
  22. python api_searcher.py "hot rank" --json
  23. python api_searcher.py platforms # 28 个平台及端点数
  24. python api_searcher.py platform:xiaohongshu # 该平台全部端点
  25. python api_searcher.py platform:xiaohongshu --json
  26. python api_searcher.py detail:douyin.search_users # 参数 / 必填 / 示例命令
  27. python api_searcher.py detail:/story/api/dyData/searchUser --full
  28. python api_client.py GET /story/web/points/api-key/balance
  29. python api_client.py POST /story/api/dyData/searchUser "keyword=乐高"
  30. python api_client.py GET /story/api/hotSpot/getListByPlatform "platform=2" "startDate=2026-11-13" "endDate=2026-11-14"
  31. python api_client.py POST /story/api/xhsUser/searchArticle "keyword=积木" --summary
  32. python api_client.py POST /story/api/hotSpot/getListByPlatformWithKeyword --body '{"keywords":["三星"],"startDate":"2026-11-01","endDate":"2026-11-14"}'
  33. python api_client.py POST /story/api/dyData/searchUser "keyword=乐高" --output result.json
  34. ```
  35. ## 调用约定
  36. - **请求头**由脚本自动加:`REDFOX_API_KEY`、`Content-Type: application/json`、浏览器 User-Agent。
  37. - **POST**:`k=v` 进 JSON body;**GET**:`k=v` 进 query。两种都支持 `--body '{"a":1}'` 传复杂结构;`k=v` 的值写成 `["a","b"]` / `{"x":1}` / 数字 / `true` 会自动解析成对应类型,其余按字符串传。中文、URL、特殊字符会正确编码。
  38. - **字段名用 `detail:` 给出的 `api_name`**(camelCase,如 `sortType`、`startDate`),不要照抄 SDK 的 snake_case 参数名。
  39. - 鉴权只靠请求头,脚本自动带上;不要把 key 拼进 URL。
  40. - **部分标为可选的参数服务端实际必填**(如 `page` / `offset` / `sourceType`),`example_call` 已给出默认值,照抄即可;只传必填项会返回 `1002`/`3203`。
  41. - **有些端点是「几个 ID 里至少传一个」**:抖音作品列表 `accountId` / `authorUrl` / `secUserId`、小红书 `redId` / `userid`、B站 `mid` / `accountUrl`。SDK 把它们都标成可选,`example_call` 已带第一个 ID 的占位符,把 `<...>` 换成真实 ID 再跑;字段名以 `detail:` 为准。
  42. - **上传类接口**(2 个)用 `--file <本地文件> --field file`,其余参数照常 `k=v`。
  43. - 输出:`--summary` 只看结构、`--compact` 压缩、`--output file.json` 落盘大响应、`--retries N` 才会在 429/5xx 重试(默认 0,避免重复计费)。
  44. - 退出码:成功、查无数据为 `0`,其余错误为 `1`。stderr 打印 `HTTP xxx` / `RedFox code xxxx: msg`;查无数据会额外标 `no matching data, not a failure`。完整响应始终输出/落盘,便于区分「没这个号」和「接口坏了」。
  45. ## 状态码
  46. `code: 2000` 成功。常见失败:`400` 参数错误、`401` 鉴权失败、`403` 无权限、`1001` 缺必要参数、`1002/1003` 参数格式/类型错、`3103` key 不存在、`3105` key 被禁用、`3201` 积分不足、`4004` 操作过于频繁(限流)、5xx 服务端异常。完整列表:https://redfox.hk/api-codes
  47. `3203` / `3801` 必须看文案区分:
  48. - 「未查询到相关数据 / 暂未收录 / 库内不存在 / 未找到账号 / 数据不存在 / 暂无作品 / 资源在平台上未找到」是**查无数据**,不是调用失败,退出码 0,stderr 标 `no matching data` 并注明扣费情况。Instagram 搜索事件词会返回 `3203「积分未扣除: API错误: 所请求的资源在平台上未找到。」`,同样属于空结果。**退出码 0 不等于免费**:`3203` 文案通常写明「积分未扣除」,`3801` 会写明「已扣除 0.600 积分」(实测),批量调研要按 `msg` 统计成本。
  49. - 其它文案(例如「关键词长度请不要超过6个字」)是真正的参数错误,退出码 1。
  50. ## 注意
  51. - 按次计费(最低约 ¥0.02/次),部分接口按累计调用量阶梯计价;不要无意义地重复调用,重试默认关闭。
  52. - AI 搜索、图片/视频生成是「提交任务 → 查询结果」两步,提交即计费;先用 `detail:` 看清参数。
  53. - **AI 搜索返回的是模型生成文本,不是结构化事实**:实测把 GitHub 关注者数字写错、引用来源混入无关页面;做调研时要用具体数据端点或官方来源交叉验证。
  54. - 快手作品搜索关键词不要超过 6 个字(超出返回 `3203`)。优质库覆盖有限:抖音 / 小红书作品列表对多个真实账号仍返回 `3203 优质库暂未收录`(积分未扣除),B站同类端点正常返回;查不到时换关键词或换端点,别当作接口故障反复重试。
  55. - 账号搜索是模糊匹配:中文复合词会串到无关行业(实测搜「MOC设计师」返回 20 个室内 / 服装设计师账号),命中要按简介和作品二次筛;臆造一个「不存在的关键词」也可能被模糊匹配出数据并照常扣费,不能用来测空结果。
  56. - **跨平台批量取数先确认字段路径**:TikTok 搜索结果用 `content` / `statsData` / `publishTime` / `workId`,评论端点 `/story/api/tiktok/ability/commentList` 的参数是 `aweme_id`(snake_case,与其余端点的 camelCase 不同);YouTube 发布时间是 `"19 hours ago"` 这类相对字符串,做时间线要先换算成日期,否则整批内容会缺席。
  57. - 同一条内容经不同数据服务取到的点赞 / 浏览数会因抓取时刻相差几十到几千(实测 87,852 vs 87,860 赞、7,972,081 vs 7,971,007 浏览);去重时按来源标注,别当成两份独立样本。
  58. - 文档站:https://redfox.hk/apis ;单个端点页可查响应字段结构。
  59. - 目录里的 `apis.json` 由官方 Python SDK 端点定义生成;若官方 SDK 更新,端点路径与字段可能变化,调用前以 `detail:` 为准。
README.md · README · 76 lines
  1. # RedFoxHub API Skill
  2. 一个 Agent Skill:让 AI 能查到并调用 [RedFoxHub(红狐数据)](https://redfox.hk/apis) 的接口。覆盖抖音、小红书、公众号、B站、快手、视频号、今日头条、TikTok、YouTube、X、Instagram、微博、知乎、汽车/电商、全网热点榜、AI 搜索、图片视频生成等 **28 类共 201 个端点**。
  3. 仓库:https://github.com/liangdabiao/redfox_api_skill
  4. **这个仓库的根目录就是 Skill 目录**,下载下来直接放进你的 skills 目录即可用,不需要额外安装 Python 依赖(只用标准库)。
  5. ## 安装
  6. 把整个仓库目录放进 skills 目录即可(目录名建议 `redfox-api-helper`):
  7. ```bash
  8. # Claude Code
  9. git clone https://github.com/liangdabiao/redfox_api_skill.git ~/.claude/skills/redfox-api-helper
  10. # WorkBuddy 项目级
  11. git clone https://github.com/liangdabiao/redfox_api_skill.git .workbuddy/skills/redfox-api-helper
  12. ```
  13. 或者直接把本目录的文件拷进一个文件夹(`README.md` 可选)。
  14. ## 配置 Key
  15. 去 https://redfox.hk/settings/api-keys 生成 key,然后二选一:
  16. ```bash
  17. export REDFOX_API_KEY="ak_xxxxxx"
  18. ```
  19. 或在**本目录外面**放一个 `.env`,写入 `REDFOX_API_KEY=ak_xxxxxx`。没配 key 时脚本会明确报错,不会静默发请求。别把 key 提交进仓库。
  20. ## 三步用法
  21. ```bash
  22. # 1. 找端点
  23. python api_searcher.py "抖音 账号 搜索"
  24. python api_searcher.py platforms # 看有哪些平台
  25. python api_searcher.py platform:xiaohongshu # 看某平台全部端点
  26. # 2. 查参数(给出真实字段名、必填项、可直接执行的命令)
  27. python api_searcher.py detail:douyin.search_users
  28. # 3. 调用
  29. python api_client.py POST /story/api/dyData/searchUser "keyword=乐高"
  30. ```
  31. `code: 2000` 表示成功,数据在 `data` 里。`3203/3801` 且文案是「未查询到数据 / 未收录 / 暂无作品」时属于**查无数据**,不是失败,退出码 0;其他 code 才是错误(退出码 1,原因打到 stderr)。
  32. ## 常用例子
  33. | 想做什么 | 命令 |
  34. |---|---|
  35. | 查余额 | `python api_client.py GET /story/web/points/api-key/balance` |
  36. | 搜抖音账号 | `python api_client.py POST /story/api/dyData/searchUser "keyword=乐高"` |
  37. | 搜小红书笔记 | `python api_client.py POST /story/api/xhsUser/searchArticle "keyword=积木"` |
  38. | 抖音热点榜 | `python api_client.py GET /story/api/hotSpot/getListByPlatform "platform=2" "startDate=2026-11-13" "endDate=2026-11-14"` |
  39. | 全网热搜(数组参数) | `python api_client.py POST /story/api/hotSpot/getListByPlatformWithKeyword --body '{"keywords":["三星"],"startDate":"2026-11-01","endDate":"2026-11-14"}'` |
  40. | 大响应存文件 | `python api_client.py POST /story/api/dyData/searchUser "keyword=乐高" --output result.json` |
  41. | 只看结构 | `python api_client.py POST /story/api/dyData/searchUser "keyword=乐高" --summary` |
  42. ## 几点注意
  43. - **POST 的 `k=v` 进 JSON body,GET 的进 query**。字段名用 `detail:` 里的 `api_name`(如 `sortType`),不是 SDK 文档的 snake_case。
  44. - 有些参数 SDK 标成可选、服务端却要求必填(`page`、`offset`、`sourceType` 等)。`detail:` 给出的 `example_call` 已经带好默认值,**照抄就不会报 `1002`/`3203`**。
  45. - 有些端点是「几个 ID 里至少传一个」:抖音作品列表 `accountId`、小红书 `redId`/`userid`、B站 `mid`。`example_call` 里带 `<...>` 占位符,换成真实 ID 再跑。抖音 / 小红书作品列表优质库覆盖有限,多个真实账号会返回「暂未收录」,不等于接口坏了。
  46. - 鉴权只用请求头,别把 key 拼进 URL。
  47. - 值写成 `["a","b"]`、`{"x":1}`、数字或 `true` 会自动按对应类型发送;中文和链接会正确编码。
  48. - 按次计费(最低约 ¥0.02/次),默认不重试以免重复扣费;需要时用 `--retries 2`。
  49. - AI 搜索、图片/视频生成是「提交任务 → 查结果」两步,提交就会计费;AI 搜索返回的是模型生成文本,事实类结论要交叉验证。
  50. - 遇到 `400/1001` 用 `detail:` 核对参数;`401/3103/3105` 检查 key;`3201` 是积分不足;`4004` 是触发限流,稍等再试。
  51. - `3203/3801` 看文案:「未查询到数据 / 暂未收录 / 资源在平台上未找到」属正常空结果(退出码 0),若写的是参数问题(如关键词超过 6 个字),仍按参数错误处理。**退出码 0 不代表免费**——`3203` 常写明「积分未扣除」,`3801` 会写明「已扣除 0.600 积分」。
  52. - 账号搜索是模糊匹配,中文复合词容易串到无关行业(实测搜「MOC设计师」返回的多是室内 / 服装设计师);命中后按简介和作品再筛。
  53. - 批量做跨平台统计时,先确认字段路径再抽数:TikTok 结果用 `content` / `statsData` / `publishTime`,评论端点参数是 `aweme_id`;YouTube 给的是 `"19 hours ago"` 这类相对时间,要先换算。
  54. 官方文档:https://redfox.hk/apis | 状态码:https://redfox.hk/api-codes - 感谢社区 https://linux.do

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.