让 AI Agent 帮你管理微信公众号 RSS 订阅 —— 一句话订阅、自然语言查找、按需读历史文章。
本仓库是 Mp2rss 服务的 OpenClaw Agent Skill 包，基于 mp2rss CLI 实现。
| 能力 | 说明 |
|---|---|
| 📡 一键订阅公众号 | 发一个公众号文章链接（mp.weixin.qq.com/s/...），Agent 自动把整个公众号订阅到你的 Feed |
| 📋 自然语言列表与搜索 | 「我订阅了哪些公众号」「搜一下我订阅的财经类」 |
| 🗑️ 取消订阅 | 「把 X 公众号从订阅里删了」，Agent 自动核对 mpId 后删除 |
| 📰 历史文章查询 | 「X 这个号最近发了什么」/「拉一下 X 的文章」 |
| 🔐 登录态管理 | 「我的 Feed Key 是什么」「登录公众号 RSS 服务」 |
| 📤 结构化输出 | 所有命令支持 -o json，Agent 可直接解析做后续处理 |
👤 订阅这个公众号 https://mp.weixin.qq.com/s/abc123xyz
🤖 已订阅「某公众号」到你的 Feed。
👤 我订阅了哪些公众号？
🤖 当前共 42 个订阅。前 20 个：某公众号（最近发文 2 小时前）、另一个号（昨天）……
👤 我订阅的财经类公众号有哪些
🤖 找到 5 个匹配：财经早知道、第一财经……
👤 财经早知道这个号最近发了什么
🤖 最近 10 篇文章：1. xxx 标题（昨天）2. xxx 标题（前天）……
👤 把财经早知道从订阅里删了
🤖 确认删除「财经早知道」（mpId 123456）？已删除 ✓
skill 本身只描述如何调用 CLI，所以必须先装 mp2rss 二进制（任选其一）：
# 方式 A：npm（推荐，跨平台一致）
pnpm add -g @mp2rss/cli
# 方式 B：macOS / Linux 一键脚本
curl -fsSL https://raw.githubusercontent.com/areyoubugcoder/mp2rss-cli/main/scripts/install.sh | sh也可在 Releases 下载对应平台二进制。
# 方式 A：通过 ClawHub（推荐）
openclaw skills install mp2rss
# 方式 B：手动
mkdir -p ~/.openclaw/workspace/skills/mp2rss
cd ~/.openclaw/workspace/skills/mp2rss
curl -sL https://raw.githubusercontent.com/areyoubugcoder/mp2rss-openclaw/main/SKILL.md -o SKILL.md
curl -sL https://raw.githubusercontent.com/areyoubugcoder/mp2rss-openclaw/main/package.json -o package.json
# 视需要再拉 references/ 子文档安装完成后说「登录 mp2rss」，Agent 自动跑 mp2rss auth login 走浏览器 loopback 授权。CI / 无头环境用：
mp2rss auth login -k <feed-key> # 直传
mp2rss auth login --no-browser # 远程模式，仅打印授权 URLFeed Key 可在 https://mp2rss.bugcode.dev/ 登录后查看或重置。配置文件位置 ~/.mp2rss/config.json。
export MP2RSS_FEED_KEY=gk_live_xxxxxxxx
export MP2RSS_API_URL=https://mp2rss.bugcode.dev # 自托管时需要优先级（高 → 低）：CLI flag --api-key > MP2RSS_FEED_KEY env > ~/.mp2rss/config.json。
| 命令 | 说明 |
|---|---|
mp2rss auth login [-k <key>] [--no-browser] |
登录（三种模式：浏览器 / Feed Key 直传 / 远程） |
mp2rss auth status [-o json] |
查登录态、Feed Key 来源、最近登录时间 |
mp2rss auth logout |
清空 Feed Key |
mp2rss mp subscribe <article-url> [-o json] |
订阅；参数必须是 mp.weixin.qq.com/s/... 文章 URL |
mp2rss mp list [-q <kw>] [-p <page>] [--page-size <n>] |
列出订阅 |
mp2rss mp search <keyword> |
mp list -q 语法糖 |
mp2rss mp remove <mpId> [-y] |
取消订阅 |
mp2rss mp articles <mpId> [-p <page>] [--page-size <n>] |
查公众号历史文章 |
完整字段、JSON shape 与 Agent 行为规范见 SKILL.md 和 references/ 子文档。
- 订阅时传的是文章 URL —— 不是公众号名、不是二维码、不是公众号主页。识别不到合法文章 URL 时 Agent 应反问用户索要任意一篇文章链接
mpId是 int64 —— JS 环境解析 JSON 时需先把mpId替换为字符串再JSON.parse，否则精度丢失- 取消订阅前先核对 mpId —— 用
mp list -q/mp search拿到准确 mpId 再删，避免误删 auth login不支持-o json—— 仅输出文本反馈，其它子命令均支持
- Mp2rss 服务 —— 微信公众号 RSS 订阅服务本身
mp2rssCLI —— Go 命令行客户端（Skill 调用的底层）- Mp2rss 文档站 —— CLI 与 API 完整文档