# Wechat Original Hot

> 公众号原创热门榜 · 按行业分类 + 时间区间拉取微信公众号的原创热门爆款（区别于转载/洗稿），终端表格展示（标题链接/账号/阅读量）并给出原创创作洞察。当用户需要看原创爆文、原创热门榜、做原创选题、研究原创作者怎么写、追原创内容趋势时使用。

- **Type:** Skill
- **Install:** `agentstack add skill-zizhanovo-doubaoya-community-wechat-original-hot`
- **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/wechat-original-hot

## Install

```sh
agentstack add skill-zizhanovo-doubaoya-community-wechat-original-hot
```

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

## About

# 公众号原创热门榜（都爆鸭）

本鸭帮你按**行业分类 + 时间区间**捞出微信公众号近期的**原创**热门爆款——专盯原创创作者写出来的爆款，绕开转载、洗稿那一堆，给原创写手看清楚同行在用什么角度、什么切口把原创内容写爆。一个分类下去，终端铺出可点的原创爆文表格，再附一句创作洞察。

> 数据走 **doubaoya.com** 一条线，鉴权用你自己的密钥（环境变量 `DOUBAOYA_API_KEY`，形如 `dyh_…`）。

> 说明：原创榜与 10万+ 爆文榜**接口同源**（都走 `category-time-hot`），区别在**展示层/解读层的侧重**——本技能站在原创创作者视角解读，强调"这是原创写手自己跑出来的爆款"，引导你提炼可复用的原创写法，而不是单纯看阅读量天花板。

---

## 适用场景

| 场景 | 怎么用 | 拿到什么 |
|------|--------|----------|
| **原创选题灵感** | 拉 `科技` 看原创写手近期在写什么、怎么切 | 给自己的原创下一篇找方向 |
| **原创写法拆解** | 横扫某分类原创爆款的标题与开头 | 摸出能复用的原创起标题/切口套路 |
| **原创趋势追踪** | 固定区间拉 `人文资讯` 原创榜 | 看原创内容风向往哪走 |
| **同行对标** | 锁定 `财经` 看同赛道原创作者谁在跑量 | 对标头部原创内容打法 |
| **原创素材沉淀** | 按分类批量收原创爆文 | 攒一手可参考的原创范本 |

---

## 工作流（4 步）

### 1. 确认分类与时间区间
从用户描述里抽出**行业分类**（一个字符串，如 `科技`、`财经`、`人文资讯`、`职场`、`教育`），默认 `科技`。
时间区间：不指定时默认**结束日 = 今天、开始日 = 今天往前 6 天**（近一周）。需要回溯就用 `--start`/`--end` 覆盖，日期格式 `YYYY-MM-DD`。

> 常见分类示例（供 `--type` 参考）：科技、财经、人文资讯、职场、教育、健康养生、情感心理、时尚潮流、美食餐饮、汽车交通。一次只拉一个分类。

### 2. 调用脚本
```bash
python3 "$SKILL_PATH/scripts/fetch_original_hot.py" --type 科技
```
指定区间：
```bash
python3 "$SKILL_PATH/scripts/fetch_original_hot.py" --type 财经 --start 2026-06-01 --end 2026-06-07
```
脚本把成功信封里的 `data` 以 JSON 打到 stdout。**每次查询只跑一次脚本**，直接读完整 stdout，别用 `head`/`tail` 预览，也别对同一参数重复调用。

### 3. 渲染原创爆文表格
从 `data.items`（文章数组）里取字段，铺成 Markdown 表格。字段做防御式读取——`title` / `accountName`（账号）/ `readCount`（阅读量）可能缺失，缺了就留空，别报错。标题渲染成**可点链接**（指向文章原文 URL），按阅读量降序排。

| 标题 | 原创账号 | 阅读量 |
|------|----------|--------|
| [示例原创爆文](https://mp.weixin.qq.com/s/xxx) | 某某原创号 | 50,000+ |

### 4. 给一句原创创作洞察
表格之后，用本鸭口吻补一句**原创视角**的洞察：这批原创爆款在用什么切口、哪种写法在跑、原创写手还有什么角度没被写透。落在"怎么把原创内容写爆"上，简短有用，别堆套话。

---

## 拿钥匙（密钥）

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

配置到环境变量（脚本只认这个）：
```bash
export DOUBAOYA_API_KEY="dyh_你的密钥"
```

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

---

## 接口与信封

- `POST https://doubaoya.com/api/apis/gongzhonghao/category-time-hot/call`
  （与 10万+ 爆文榜同一接口，原创/10万+ 的区分在展示层解读侧重）
- 鉴权头：`Authorization: Bearer $DOUBAOYA_API_KEY`
- 请求体：`{ "type": "科技", "startDate": "2026-06-21", "endDate": "2026-06-27" }`
  - `type`：字符串，行业分类（默认 `科技`）
  - `startDate` / `endDate`：`YYYY-MM-DD`，时间区间（默认近一周）
- 返回信封：
  ```json
  {
    "success": true,
    "requestId": "...",
    "data": { "items": [ { "title": "...", "accountName": "...", "readCount": 56789 } ] },
    "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` | 参数不合法（如日期格式错） | 修正分类/日期重试 |
| 402 | `INSUFFICIENT_CREDITS` | 额度不足 | 去 doubaoya.com 充值/续额 |
| 502 | `PROVIDER_FAILED` | 上游临时故障（**已自动退款**） | 可安全重试 |

> `502 PROVIDER_FAILED` 会自动退款，重试是安全的，不会重复扣费。

---

## 目录结构

```
wechat-original-hot/
├── SKILL.md                      # 本文件
└── scripts/
    └── fetch_original_hot.py     # 零依赖脚本（urllib），调用 doubaoya.com
```

## 关于响应里的 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-wechat-original-hot
- 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%.