Xiaohongshu Cover

小红书封面选题数据（都爆鸭）

本鸭帮你按关键词拉一批小红书爆款数据（低粉爆款 / 点赞 TOP500 / 单日互动 / 七日增长），从真实跑量的笔记里提炼封面套路、定封面选题方向。

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

---

拿钥匙（密钥）

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

export DOUBAOYA_API_KEY="dyh_你的密钥"

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

---

跑脚本

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

# 默认：起始日期 30 天前
python3 "$SKILL_PATH/scripts/fetch_cover_data.py" --keyword 露营

# 指定起始日期
python3 "$SKILL_PATH/scripts/fetch_cover_data.py" --keyword 露营 --start-date 2026-06-01

| 参数 | 说明 | 默认 | |------|------|------| | --keyword | 关键词（必填） | — | | --start-date | 起始日期 YYYY-MM-DD | 30 天前 |

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

---

工作流（3 步）

1. 定关键词 + 起始日期：围绕你要做的赛道给一个核心词。
2. 调脚本拿数据：数据在 data.items，是一组 { rank, item }。rank 是榜名（如 likeTheTop500、低粉爆款、单日互动、七日增长），真正的笔记在 item 里（item.title、item.likedCount 等）。
3. 提炼封面套路 + 给方向：从高赞笔记里归纳封面规律（主体大图 / 文字钩子 / 对比 / 清单感等），用本鸭口吻给 3 条可直接套用的封面方向。

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

---

接口契约

• POST https://doubaoya.com/api/apis/xiaohongshu/xiaohongshu-coze/call
• 鉴权头：Authorization: Bearer $DOUBAOYA_API_KEY
• 请求体：{ "keyword": "露营", "startDate": "2026-06-01" }
• 返回信封：

``json { "success": true, "requestId": "...", "data": { "items": [ { "rank": "likeTheTop500", "item": { "title": "...", "likedCount": 12000 } } ] }, "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 | 参数不合法（如关键词为空） | 修正 --keyword / --start-date 重试 | | 402 | INSUFFICIENT_CREDITS | 额度不足 | 去 doubaoya.com 充值/续额 | | 502 | PROVIDER_FAILED | 上游临时故障（已自动退款） | 可安全重试 |

---

目录结构

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

---

常见问答

Q：返回的数据怎么用来定封面？ A：看高赞笔记的标题与形式共性，反推它们封面大概率长什么样，归纳成可复用的封面套路。

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.