# Xiaohongshu Cover

> 小红书封面选题数据 · 按关键词拉一批小红书爆款数据（低粉爆款 / 点赞 TOP500 / 单日互动 / 七日增长），帮你从真实爆款里提炼封面套路、定封面选题方向。当用户需要小红书封面参考、小红书封面选题、小红书封面套路、爆款封面灵感、小红书首图时使用。触发词：小红书封面、封面选题、封面套路、封面参考、首图灵感、爆款封面。

- **Type:** Skill
- **Install:** `agentstack add skill-zizhanovo-doubaoya-community-xiaohongshu-cover`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [zizhanovo](https://agentstack.voostack.com/s/zizhanovo)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [zizhanovo](https://github.com/zizhanovo)
- **Source:** https://github.com/zizhanovo/doubaoya-community/tree/main/skills/xiaohongshu-cover

## Install

```sh
agentstack add skill-zizhanovo-doubaoya-community-xiaohongshu-cover
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

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

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

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

---

## 拿钥匙（密钥）

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

```bash
export DOUBAOYA_API_KEY="dyh_你的密钥"
```

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

---

## 跑脚本

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

```bash
# 默认：起始日期 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](https://github.com/zizhanovo)
- **Source:** [zizhanovo/doubaoya-community](https://github.com/zizhanovo/doubaoya-community)
- **License:** MIT

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-zizhanovo-doubaoya-community-xiaohongshu-cover
- Seller: https://agentstack.voostack.com/s/zizhanovo
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.