# Wechat Title

> 公众号爆款标题创作 · 按主题拉近期同赛道爆款，提炼可复用的标题套路并生成候选标题（也可对你给的标题做套路化评判）。当用户需要公众号标题、爆款标题、标题生成、起标题、标题套路、标题优化时使用。触发词：公众号标题、爆款标题、标题生成、起标题、标题套路、标题优化。

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

## Install

```sh
agentstack add skill-zizhanovo-doubaoya-community-wechat-title
```

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_…`）。

---

## 适用场景

| 场景 | 怎么用 | 拿到什么 |
|------|--------|----------|
| **标题创作** | 给主题，本鸭拉爆款提套路、出候选标题 | 一组可直接用的候选标题 |
| **套路提炼** | 想知道这个题材爆款标题怎么起 | 可复用的标题公式清单 |
| **标题评判** | 给一个标题，让本鸭按套路判强弱 | 优化方向 + 改写版本 |
| **追热点起题** | 蹭近期热度，要时效强的标题 | 贴近 7 天热点的标题 |

---

## 工作流（4 步）

### 1. 提炼主题关键词
从需求里抽出**核心主题词**，精简为 2~6 个字（如 `职场`、`婚姻`、`AI`）。词越短越宽、命中越多。一次只搜一个关键词。

### 2. 调用脚本
```bash
python3 "$SKILL_PATH/scripts/fetch_title.py" "职场"
```
指定起始日期（默认今天-6 天，专取近 7 天爆款、时效更强）：
```bash
python3 "$SKILL_PATH/scripts/fetch_title.py" "职场" --start 2026-06-15
```
脚本把成功信封里的 `data` 以 JSON 打到 stdout。**每个主题只跑一次脚本**，读完整 stdout，别用 `head`/`tail` 预览。

### 3. 提炼标题套路
`data.items` 是**扁平化后的多榜合并列表**，每条形如 `{ rank, item }`：`rank` 标出这条来自哪个榜（`oneWReadingRank` 万级阅读榜 / `tenWReadingRank` 十万级阅读榜 / `originalRank` 原创榜），真正的字段在**嵌套的 `item` 对象里**——取 `item.title`（标题）和 `item.clicksCount`（点击量，作热度参考；防御式读取，`item` 或其子字段缺失就留空）。把跑量高的标题归类，提炼套路：数字清单、悬念留白、利益承诺、身份代入、对立反差、热点借势……标出每种套路对应的真实例子。

### 4. 生成候选标题（或做评判）
- **生成**：套用上面提炼的套路，围绕用户选题产出一组（建议 5~8 条）候选标题，每条标注用了哪种套路。
- **评判**：若用户是给标题求优化，按套路打分（强在哪、弱在哪——这是你在 LLM 侧的判断，**没有独立的评分接口**），再给 2~3 个改写版本。

标题素材务必只用接口返回的真实爆款，不脑补、不联网另找。

---

## 拿钥匙（密钥）

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

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

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

---

## 接口与信封

- `POST https://doubaoya.com/api/apis/gongzhonghao/gongzhonghao-coze-cover/call`（同一爆款数据接口，返回近期热门选题/标题）
- 鉴权头：`Authorization: Bearer $DOUBAOYA_API_KEY`
- 请求体：`{ "keyword": "职场", "startDate": "2026-06-21" }`
  - `keyword`：字符串，必填
  - `startDate`：字符串 `YYYY-MM-DD`，可选（默认今天-6 天）
- 返回信封：
  ```json
  {
    "success": true,
    "requestId": "...",
    "data": {
      "items": [
        { "rank": "oneWReadingRank", "item": { "title": "...", "clicksCount": 0 } }
      ],
      "groups": { "oneWReadingRank": [], "tenWReadingRank": [], "originalRank": [] }
    },
    "error": null
  }
  ```
  - `items` 是三个榜（`oneWReadingRank` 万级阅读 / `tenWReadingRank` 十万级阅读 / `originalRank` 原创）拉平合并后的数组，每条 `{ rank, item }`；标题在 `item.title`，点击量在 `item.clicksCount`。
  - `groups` 按榜单原样分组，一般用不到，取数以 `items` 为准。
- **先看 `success`**：为 `true` 才读 `data`；否则读 `error.code` / `error.message`。
- 标题「评分」只是 LLM 侧的套路化判断，**不要去调任何评分接口**——本 skill 只有上面这一个取数接口。

---

## 错误处理

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

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

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

---

## 目录结构

```
wechat-title/
├── SKILL.md                  # 本文件
└── scripts/
    └── fetch_title.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-title
- 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%.