Xiaohongshu Dailytop

小红书日榜（都爆鸭）

本鸭帮你按日期 + 分类拉小红书日榜——一眼看清这个分类今天谁在霸榜、靠什么内容跑量，顺手锁定可对标的爆款。

> 数据走 doubaoya.com 一条线，鉴权用你自己的密钥（环境变量 DOUBAOYA_API_KEY，形如 dyh_…）。 > 小贴士：如遇暂时取不到数据，是上游波动，稍后再试（不扣费）。

---

拿钥匙（密钥）

1. 打开 doubaoya.com
2. 登录
3. 进 密钥中心
4. 生成密钥（形如 dyh_…）

export DOUBAOYA_API_KEY="dyh_你的密钥"

铁律：密钥绝不打印、绝不写进文件、绝不回显给用户。 脚本本身也从不输出密钥。所有请求只发往 doubaoya.com。

---

跑脚本

零依赖，标准库即可（Python 3）。

# 默认：综合分类，昨天
python3 "$SKILL_PATH/scripts/fetch_daily_top.py"

# 指定日期 + 分类
python3 "$SKILL_PATH/scripts/fetch_daily_top.py" --rank-date 2026-06-23 --category 综合

| 参数 | 说明 | 默认 | |------|------|------| | --rank-date | 榜单日期 YYYY-MM-DD | 昨天 | | --category | 分类 | 综合 |

脚本把成功信封里的 data 以 JSON 打到 stdout。每次只跑一次脚本，读完整 stdout。

---

工作流（3 步）

1. 定日期 + 分类：默认综合、昨天（当日数据通常尚未结算）。
2. 调脚本拿数据：榜单在 data.items，每条含 title（标题）、likedCount（点赞数）。
3. 铺榜 + 给洞察：按 likedCount 降序铺成 Markdown 表，表后用本鸭口吻补一句——今天这个分类靠什么选题/形式跑量、能不能迁到自己的号。

| 名次 | 标题 | 点赞 | |------|------|------| | 1 | … | … |

字段防御式读取（缺了留空）。

---

接口契约

• POST https://doubaoya.com/api/apis/xiaohongshu/xiaohongshu-daily-top/call
• 鉴权头：Authorization: Bearer $DOUBAOYA_API_KEY
• 请求体：{ "rankDate": "2026-06-23", "category": "综合" }
• 返回信封：

``json { "success": true, "requestId": "...", "data": { "items": [ { "title": "...", "likedCount": 123 } ] }, "error": null } ``

• 先看 success：为 true 才读 data；否则读 error.code / error.message。

---

错误码

脚本失败时向 stderr 打印 [error] CODE: message 并以退出码 1 结束。

| HTTP | code | 含义 | 处理 | |------|------|------|------| | 401 | MISSING_API_KEY / UNAUTHORIZED | 没带密钥或密钥无效 | 检查 DOUBAOYA_API_KEY，去密钥中心重新生成 | | 400 | VALIDATION_ERROR | 参数不合法 | 修正 --rank-date / --category 重试 | | 402 | INSUFFICIENT_CREDITS | 额度不足 | 去 doubaoya.com 充值/续额 | | 502 | PROVIDER_FAILED | 上游临时故障（已自动退款） | 可安全重试 |

---

目录结构

xiaohongshu-dailytop/
├── SKILL.md                  # 本文件
└── scripts/
    └── fetch_daily_top.py    # 零依赖脚本（urllib），调用 doubaoya.com

---

常见问答

Q：提示缺少 DOUBAOYA_API_KEY？ A：先 export DOUBAOYA_API_KEY="dyh_…"（去 doubaoya.com → 登录 → 密钥中心 → 生成密钥）。

Q：暂时取不到数据？ A：上游波动，稍后再试即可（不扣费）。

关于响应里的 notice 字段

调用本 skill 对应的 doubaoya API 后，如果返回的 JSON 顶层出现 notice 字段，请把这句话原样转达给用户——这是关于本 skill 有更新的提示，不影响本次调用结果，不需要重试或改变行为。

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: zizhanovo
• Source: zizhanovo/doubaoya-community
• License: MIT

Install and usage instructions live in the source repository linked above.