公众号订阅追踪

SKILL.md

---
name: gzh-subscribe
description: 微信公众号文章订阅 — 每天 9 点，盯梢竞对、同类、关注账号，一份你订阅的公众号文章推送。
---

# 公众号订阅追踪

你的公众号内容雷达。订阅竞对、同类和关注账号，自动抓取每日发文，以清晰的表格形式展示：发文日期、作者、标题、简介、阅读数、点赞数、发文链接，一键生成 HTML 日报。

---

## 首次使用

**开箱即用 — 粘贴命令就能跑**

内置公共 API Key，约 **10000 次免费额度**，零配置直接用：

```bash
# 1. 添加订阅（只需公众号名称即可）
python3 "$SKILL_PATH/assets/subscribe.py" add "示例公众号" --category "竞对账号"

# 如果有公众号微信号（如 WebNotes），可以一并提供以精确定位
python3 "$SKILL_PATH/assets/subscribe.py" add "示例公众号" --id "WebNotes"

# 2. 拉取今日发文
python3 "$SKILL_PATH/assets/subscribe.py" fetch

# 3. 生成并打开日报
python3 "$SKILL_PATH/assets/subscribe.py" report
```

HTML 日报保存在 `~/Downloads/QoderGzhReports/` 目录，自动在浏览器中打开。

---

## 后续使用

免费额度用完后，前往 [redfox.hk/login](https://www.redfox.hk/login) 注册账号获取自己的 API Token：

| 配置方式 | 说明 | 命令 |
|----------|------|------|
| **环境变量**（推荐） | 设置一次，全局生效 | `export X_API_KEY=ak_你的密钥` |
| **命令行参数** | 临时使用 | `python3 "$SKILL_PATH/assets/subscribe.py" fetch --api-key ak_你的密钥` |
| **配置文件** | 持久化存储 | `echo '{"api_key":"ak_你的密钥"}' > ~/.qoder/apis/redfox.json` |

---

## 功能特点

- **收件箱式订阅**：像订阅 Newsletter 一样订阅公众号，最多 20 个，名称即可，微信号可选
- **每日 9 点准时推送**：一键安装定时任务，每天早上一份精排日报，自动打开浏览器
- **三类分组管理**：「竞对账号」盯对手、「同类账号」找灵感、「关注账号」追大神
- **关键数据一屏尽览**：发文日期、标题、简介、阅读数、点赞数，原文链接一键直达
- **终端 + 日报双模式**：命令行实时查表，HTML 日报适合分享存档

---

## 适用场景

### 每日晨报
开启 `--subscribe`，每天 09:00 自动拉取所有订阅公众号的发文，
生成 HTML 日报并自动打开浏览器。像收邮件一样，每天早上收到一份
专属的公众号文章推送。

### 竞对监控
把竞品公众号加入「竞对账号」分类，随时 `fetch` 一屏看完他们的
最新发文——标题、简介、阅读数、点赞数、文章链接，表格一目了然。

### 特别关注
把行业大号、灵感来源加入「关注账号」分类，日报中优先展示，
有新发文第一时间掌握动态。

### 内容加工
拉取到的文章数据可以配合 LLM 进一步使用：
- **摘要改写**：喂给 LLM 生成自定义摘要或分析观点
- **风格仿写**：模仿目标公众号的文风输出学习笔记
- **数据沉淀**：日报 HTML 可导出为 PDF / Markdown 存档

---

## 使用方式

### 管理订阅

```bash
# 添加订阅（只需公众号名称即可）
python3 "$SKILL_PATH/assets/subscribe.py" add "公众号名称" --category "竞对账号"

# 添加订阅时附带公众号微信号
python3 "$SKILL_PATH/assets/subscribe.py" add "公众号名称" --id "WebNotes"

# 取消订阅（支持用名称或微信号）
python3 "$SKILL_PATH/assets/subscribe.py" remove "公众号名称"
python3 "$SKILL_PATH/assets/subscribe.py" remove "WebNotes"

# 查看所有订阅
python3 "$SKILL_PATH/assets/subscribe.py" list
```

### 拉取发文

```bash
# 拉取所有订阅公众号的最新发文
python3 "$SKILL_PATH/assets/subscribe.py" fetch

# 指定日期
python3 "$SKILL_PATH/assets/subscribe.py" fetch --date 2026-05-26

# 仅查看终端表格（不生成日报）
python3 "$SKILL_PATH/assets/subscribe.py" fetch --no-report
```

### 生成日报

```bash
# 生成今日 HTML 日报
python3 "$SKILL_PATH/assets/subscribe.py" report

# 指定日期和输出目录
python3 "$SKILL_PATH/assets/subscribe.py" report --date 2026-05-26 --output-dir ~/Desktop
```

### 每日自动推送

```bash
# 开启每日 09:00 自动推送
python3 "$SKILL_PATH/assets/subscribe.py" --subscribe

# 取消每日自动推送
python3 "$SKILL_PATH/assets/subscribe.py" --unsubscribe
```

### 参数说明

| 命令 | 参数 | 说明 |
|------|------|------|
| `add` | `accountName` | 公众号名称（必填） |
| | `--id` | 公众号 ID（可选） |
| | `--category` | 分类标签：竞对账号 / 同类账号 / 关注账号 |
| `remove` | `identifier` | 公众号名称 或 公众号 ID |
| `list` | — | 列出所有订阅 |
| `fetch` | `--date` | 指定日期 YYYY-MM-DD（默认今天） |
| | `--no-report` | 仅终端展示，不生成日报 |
| `report` | `--date` | 指定日期 YYYY-MM-DD（默认今天） |
| | `--output-dir` | 输出目录（默认 ~/Downloads/QoderGzhReports） |
| 全局 | `--api-key` | 指定 API Key |
| | `--subscribe` | 安装每日定时任务（09:00） |
| | `--unsubscribe` | 卸载定时任务 |

### 依赖安装

| 依赖 | 安装命令 |
|------|----------|
| `requests` | `pip3 install requests` |

---

## 常见问题

**Q：公众号 ID（微信号）是什么？必须提供吗？**
A：公众号的微信号（如 `WebNotes`），可在公众号主页 → 基础信息中查看。**非必填**，仅用公众号名称也能完成订阅和拉取发文。提供微信号可以让 API 更精确地定位到目标公众号。

**Q：最多能订阅多少个公众号？**
A：最多 20 个。这是保证 API 调用效率和合理使用的上限。

**Q：拉取频率有限制吗？**
A：内置公共 Key 约 10000 次额度，每次 fetch 按订阅数消耗。建议开启每日自动推送，而非频繁手动拉取。

**Q：日报存在哪？**
A：默认 `~/Downloads/QoderGzhReports/`，文件名格式 `公众号日报_2026-05-27.html`。

**Q：怎么自定义日报样式？**
A：修改 `$SKILL_PATH/assets/report_template.html` 中的 CSS 变量即可换色、换字体。

**Q：分类标签有什么用？**
A：日报中会按分类分组展示（竞对账号、同类账号、关注账号），便于快速区分不同目的的订阅。不指定分类则统一归入「关注账号」。

**Q：和 RSS 阅读器有什么区别？**
A：专为微信公众号设计。微信没有 RSS，本 Skill 直接获取公众号发文数据，还能看到阅读数、点赞数等微信独有的互动指标。

**Q：文章内容可以改写或仿写吗？**
A：日报展示的是标题+简介+数据。如需对文章做摘要改写或风格仿写，可将拉取到的数据配合 LLM 进一步处理。

**Q：额度用完了怎么办？**
A：前往 [redfox.hk/login](https://www.redfox.hk/login) 注册获取免费 API Token。

---

## 获取方式

本 Skill 可在以下平台找到：

- [SkillHub](https://skillhub.cn)
- [ClawHub](https://clawhub.com)
- [GitHub](https://github.com)
- [GitHub](https://github.com)