mp2rss-x

Original：🇨🇳 Chinese

Translated

Viewing X (Twitter) account subscriptions and retrieving content (based on the Mp2rss service, which converts X accounts into RSS) — list subscribed X accounts and fetch paginated post and article feeds by xUserId. Matches requests such as “Which X accounts am I subscribed to?”, “List my X subscriptions”, “What has this X account posted recently?”, “Fetch the posts for <xUserId>”, “Articles for <xUserId>”, “X account <id> articles”, and “mp2rss x list / posts / articles”. ⚠️ The CLI exposes only three read-only operations; searching for, subscribing to, and unsubscribing from X accounts are available only through the Web console (<https://mp2rss.bugcode.dev>). Neither the CLI nor the Open API provides endpoints for these operations — when users request such actions, direct them to the Web console instead of looking for `x subscribe / x remove / x search`, which do not exist.

1installs

Sourceareyoubugcoder/mp2rss-cli

Added on2026-10-12

NPX Install

npx skill4agent add areyoubugcoder/mp2rss-cli mp2rss-x

SKILL.md Content (Chinese)

View Translation Comparison →

mp2rss-x Skill

Provides read-only access to X (Twitter) feeds through the Mp2rss CLI — list subscribed X accounts and fetch posts and long-form articles by xUserId.

Prerequisites

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

You are logged in:

mp2rss auth status

displays

loggedIn: true

(run

mp2rss auth login

before first use)

The X account you want to work with has already been subscribed to via the Web console (the CLI does not support
```
subscribe
```
)

Scope boundaries (important)

Operation	Supported by CLI	Where to do it
`x list` — List subscribed X accounts	✅	This skill
`x posts` — Fetch the post feed	✅	This skill
`x articles` — Fetch the long-form article feed	✅	This skill
`x subscribe` — Subscribe to a new X account	❌	https://mp2rss.bugcode.dev Web console
`x remove` — Unsubscribe from an X account	❌	https://mp2rss.bugcode.dev Web console
`x search` — Search for X accounts	❌	https://mp2rss.bugcode.dev Web console

When users say “Subscribe to this X account” / “Add xxx from X” / “Search for xxx on X,” do not attempt to construct commands such as
mp2rss x subscribe
(they do not exist); simply tell the user to use the Web console.

Commands

List subscribed X accounts

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

Flag	Default	Description
`-q, --query`	—	Fuzzy search by displayName / username (only effective when supported by the server; otherwise, it falls back to filtering X items on the client)
`-p, --page`	1	Page number
`--page-size`	20	Number of items per page (maximum 50)
`-o, --output`	table	`table` / `json`

bash

mp2rss x list
mp2rss x list -q claude
mp2rss x list -p 2 --page-size 50
mp2rss x list -o json | jq '.items[].xDisplayName'

Calls

GET /open-api/subscriptions?sourceType=x

internally; if the server does not recognize

sourceType

, the CLI client falls back to removing mp items.

JSON shape:

json

{
  "items": [
    {
      "sourceType": "x",
      "xUserId": "44196397",
      "xUsername": "elonmusk",
      "xDisplayName": "Elon Musk",
      "xAvatarUrl": "https://...",
      "xVerified": true,
      "xLastItemAt": 1705000050000,
      "createdAt": 1705000000000
    }
  ],
  "total": 12,
  "page": 1,
  "pageSize": 20
}

List posts (post feed)

mp2rss x posts <xUserId> [-p <page>] [--page-size <n>] [-o json]

Retrieves the post feed of a subscribed X account in pages, sorted by

postedAt DESC

.

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

bash

mp2rss x posts 44196397
mp2rss x posts 44196397 -p 2 --page-size 50
mp2rss x posts 44196397 -o json | jq '.items[].content'

JSON shape:

json

{
  "items": [
    {
      "postId": "1234567890",
      "content": "推文正文",
      "media": [{"url": "https://...", "type": "image"}],
      "retweetedPost": null,
      "quotedPost": null,
      "threadPosts": [],
      "postedAt": 1705000000000
    }
  ],
  "total": 87,
  "page": 1,
  "pageSize": 20
}

Field descriptions:

```
media
```
— Images or videos attached to the post;
```
type
```
can be a value such as
```
image
```
/
```
video
```
```
retweetedPost
```
/
```
quotedPost
```
— Nested objects for the original post (may be
```
null
```
)
```
threadPosts
```
— Follow-up posts by the same author in the same thread (may be an empty array)
An unsubscribed
```
xUserId
```
returns 404
```
X account is not subscribed
```
(exit code
```
4
```
)

List articles (X Articles feed)

mp2rss x articles <xUserId> [-p <page>] [--page-size <n>] [-o json]

Retrieves the long-form article feed (X Articles) of a subscribed X account in pages, sorted by

publishedAt DESC

.

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

bash

mp2rss x articles 44196397
mp2rss x articles 44196397 -p 2 --page-size 50
mp2rss x articles 44196397 -o json | jq '.items[].title'

JSON shape:

json

{
  "items": [
    {
      "url": "https://x.com/.../article/...",
      "title": "长文标题",
      "description": "长文摘要",
      "contentMarkdown": "# Markdown 正文（可能为 null）",
      "coverUrl": "https://...",
      "publishedAt": 1705000000000
    }
  ],
  "total": 3,
  "page": 1,
  "pageSize": 20
}

An unsubscribed
```
xUserId
```
returns 404
```
X account is not subscribed
```
(exit code
```
4
```
)
```
contentMarkdown
```
is the original Markdown content supplied by the upstream provider and may be
```
null
```

Agent Usage Notes

xUserId
is a string (the native numeric ID on the X platform, serialized as a string); do not parse it as a number.
```
mpId
```
on the
```
mp2rss mp
```
side is int64
Use
```
-o json
```
consistently when parsing bulk output
All time fields are Unix timestamps in milliseconds (number):
```
createdAt
```
/
```
xLastItemAt
```
/
```
postedAt
```
/
```
publishedAt
```

Field names consistently use camelCase:

xUserId

/

xUsername

/

xDisplayName

/

xAvatarUrl

/

xVerified

/

xLastItemAt

/

sourceType

/

postId

/

coverUrl

/

contentMarkdown

Nonexistent subcommands:
```
x subscribe
```
/
```
x remove
```
/
```
x search
```
— when users request these actions, direct them to the Web console at https://mp2rss.bugcode.dev; do not look for alternatives in the CLI
Both
```
x posts
```
and
```
x articles
```
include pagination metadata (
```
total
```
/
```
page
```
/
```
pageSize
```
). This differs from
```
mp articles
```
(which has no pagination fields); use
```
total
```
to determine whether another page exists
```
--page-size
```
has a maximum of 50 across all three commands; exceeding it returns
```
参数错误
```
(exit code
```
2
```
)
Rate limiting: the x and mp commands share a quota of 60 requests per minute per Feed Key. The CLI automatically spaces requests by at least 1.2 seconds and waits according to
```
Retry-After
```
for one retry. If the request is still rejected, the envelope contains
```
"kind":"rate_limited"
```
; do not retry immediately
For
```
x list -q <kw>
```
,
```
-q
```
performs a server-side fuzzy search by displayName / username. If the server does not recognize it, the CLI falls back to client-side filtering by
```
sourceType=x
```
(meaning
```
-q
```
has no effect, but no error is reported)
Standard flow for obtaining an
```
xUserId
```
: first run
```
mp2rss x list -o json
```
, retrieve
```
items[].xUserId
```
, and then pass it to
```
x posts
```
/
```
x articles
```
Error JSON shape:
```
{"error":{"message":"...","code":<int>}}
```
; prioritize the HTTP status code for
```
code
```
when supplied by the upstream service, and otherwise fall back to the CLI exit code (parameter / authentication errors)
Exit codes:
```
0
```
success;
```
1
```
generic error (network);
```
2
```
invalid parameters (including an out-of-range
```
--page-size
```
);
```
3
```
authentication failure → direct the user to run
```
mp2rss auth login
```
(see the
```
mp2rss-auth
```
skill);
```
4
```
resource not found (
```
xUserId
```
is unsubscribed or does not exist);
```
5
```
upstream service unavailable

mp2rss-x

NPX Install

Tags

SKILL.md Content (Chinese)

mp2rss-x Skill

Prerequisites

Scope boundaries (important)

Commands

List subscribed X accounts

List posts (post feed)

List articles (X Articles feed)

Agent Usage Notes