mp2rss-mp

Original：🇨🇳 Chinese

Translated

WeChat Official Account subscription and article management (based on the Mp2rss service, which converts Official Accounts to RSS) — subscribe to / list / unsubscribe from WeChat Official Accounts, query the historical articles of a given Official Account, and fuzzy-search subscribed sources by keyword. Matches: “Subscribe to this Official Account <article URL>”, “Convert this Official Account to RSS”, “Subscribe <mp.weixin.qq.com/s/...>”, “Which Official Accounts have I subscribed to?”, “List my Official Account RSS feeds”, “What has this Official Account posted recently?”, “Historical articles of <Official Account>”, “Pull the articles for <Official Account>”, “Unsubscribe from <Official Account>”, “Remove <Official Account> from my subscriptions”, “Search my subscribed Official Accounts for <keyword>”, and “mp2rss mp list / search / subscribe / remove / articles”. When subscribing, the input is the URL of “any article from the Official Account” (mp.weixin.qq.com/s/...), not the Official Account name itself. ⚠️ Handles only “WeChat Official Account” semantics; requests mentioning “X account / Twitter / xUserId / long-form articles / posts” should be routed to mp2rss-x and must not come here.

3installs

Sourceareyoubugcoder/mp2rss-cli

Added on2026-10-12

NPX Install

npx skill4agent add areyoubugcoder/mp2rss-cli mp2rss-mp

SKILL.md Content (Chinese)

View Translation Comparison →

mp2rss-mp Skill

Manage WeChat Official Account subscriptions and articles through the Mp2rss CLI — subscribe to / list / unsubscribe from WeChat Official Accounts and query historical articles for a single Official Account by mpId.

Prerequisites

The
```
mp2rss
```
binary is installed (see the Prerequisites of
```
mp2rss-auth
```
)

You are logged in:

mp2rss auth status

displays

loggedIn: true

(on first use, run

mp2rss auth login

)

Commands

List subscriptions

mp2rss mp list [-q <keyword>] [-p <page>] [--page-size <n>] [-o json]

Flag	Default	Description
`-q, --query`	—	Fuzzy-search by Official Account name
`-p, --page`	1	Page number
`--page-size`	20	Number of items per page (maximum 50)
`-o, --output`	table	`table` / `json`

bash

mp2rss mp list
mp2rss mp list -q 财经
mp2rss mp list -p 2 --page-size 50
mp2rss mp list -o json | jq '.items[].mpName'

JSON shape:

json

{
  "items": [
    {
      "sourceType": "mp",
      "mpId": 123456,
      "mpName": "某公众号",
      "mpAvatarUrl": "https://...",
      "createdAt": 1705000000000,
      "mpLastArticleAt": 1705000050000
    }
  ],
  "total": 42,
  "page": 1,
  "pageSize": 20
}

Search subscriptions

mp2rss mp search <keyword> [-p <page>] [--page-size <n>] [-o json]

This is syntactic sugar for

mp2rss mp list -q <keyword>

, with the same flags and output as

list

.

bash

mp2rss mp search 财经
mp2rss mp search 财经 -o json

Subscribe to a WeChat Official Account

mp2rss mp subscribe <article-url> [-o json]

⚠️ Pass an article URL (

https://mp.weixin.qq.com/s/...

), not an Official Account name, QR code, or Official Account homepage link. Copy the link from any article on the Official Account; Mp2rss will parse the account that owns the article and subscribe the entire Official Account to your Feed.

bash

mp2rss mp subscribe https://mp.weixin.qq.com/s/abcDEFghIJKlmnop
mp2rss mp subscribe https://mp.weixin.qq.com/s/abc -o json

JSON shape:

json

{
  "ok": true,
  "articleUrl": "https://mp.weixin.qq.com/s/..."
}

Unsubscribe

mp2rss mp remove <mpId> [-y] [-o json]

Unsubscribe by mpId.

-y

skips the interactive confirmation (suitable for scripted calls).

bash

mp2rss mp remove 123456
mp2rss mp remove 123456 -y
mp2rss mp remove 123456 -y -o json

JSON shape:

json

{
  "ok": true,
  "mpId": 123456
}

Obtain the mpId from

items[].mpId

in

mp2rss mp list -o json

.

List articles of an Official Account

mp2rss mp articles <mpId> [-p <page>] [--page-size <n>] [-o json]

Query historical articles for an Official Account by mpId.

Flag	Default	Description
`-p, --page`	1	Page number
`--page-size`	100	Number of items per page (maximum 100)
`-o, --output`	table	`table` / `json`

bash

mp2rss mp articles 123456
mp2rss mp articles 123456 -p 2 --page-size 100
mp2rss mp articles 123456 -o json | jq '.items[].title'

JSON shape:

json

{
  "items": [
    {
      "mpId": 123456,
      "articleId": "article-id",
      "title": "文章标题",
      "summary": "文章摘要",
      "coverImageUrl": "https://...",
      "originalUrl": "https://mp.weixin.qq.com/s/...",
      "contentMarkdown": "# Markdown 正文",
      "publishedAt": 1705000000000,
      "updatedAt": 1705000010000
    }
  ]
}

⚠️ The article list has no pagination fields (no

total

/

page

/

pageSize

); an empty

items

is treated as the end of the current page.

Agent Usage Notes

Always add
```
-o json
```
when parsing batch output
mpId
is a number (int64): watch for precision issues when parsing in JavaScript / jq, and use string mode if necessary
All time fields are Unix timestamps in milliseconds (number)

Field names consistently use camelCase:

mpId

/

mpName

/

mpAvatarUrl

/

mpLastArticleAt

/

articleId

/

originalUrl

/

contentMarkdown

/

publishedAt

Most common mistake when subscribing: when a user says “Subscribe to this Official Account <X>”,
```
<X>
```
must be an
```
mp.weixin.qq.com/s/...
```
article link. If a valid article URL cannot be recognized, first ask the user for the link to any article rather than trying immediately
Before unsubscribing, first run
```
mp2rss mp list -q <name>
```
to confirm the mpId and avoid removing the wrong account
The article list has no pagination fields, so use
```
--page-size
```
to control the maximum number of results returned at once (maximum 100); to continue with the next page, use
```
-p
```
Error JSON shape:
```
{"error":{"message":"...","code":<int>}}
```
;
```
code
```
should preferentially use the HTTP status code (from upstream), otherwise fall back to the CLI exit code (argument / authentication errors)
Rate limiting: the server allows 60 requests per minute for each Feed Key. The CLI automatically spaces adjacent requests to ≥ 1.2s and waits and retries once according to
```
Retry-After
```
; if the request is still rejected, the envelope includes
```
"kind":"rate_limited"
```
, and the message contains the estimated unlock time—do not retry immediately; make calls sequentially when iterating over multiple mpIds
Exit codes:
```
0
```
success;
```
1
```
generic error (network);
```
2
```
argument error;
```
3
```
authentication failure → guide the user to run
```
mp2rss auth login
```
(see the
```
mp2rss-auth
```
skill);
```
4
```
resource not found (incorrect mpId or expired article URL);
```
5
```
upstream unavailable

mp2rss-mp

NPX Install

Tags

SKILL.md Content (Chinese)

mp2rss-mp Skill

Prerequisites

Commands

List subscriptions

Search subscriptions

Subscribe to a WeChat Official Account

Unsubscribe

List articles of an Official Account

Agent Usage Notes