中文

mpget

CLI tool and MCP server for searching and fetching WeChat Official Account articles via Sogou.

Designed for agent integration — structured JSON output, MCP server support, and one-command skill injection for Claude Code.

Features

• CLI + MCP dual interface — use as a command-line tool or as an MCP server for AI agents
• Agent Skill — mpget init injects a skill file into .claude/skills/ with version sync
• Multi-page search — automatic pagination with configurable max pages and rate limiting
• Article content extraction — fetches and cleans WeChat article body text
• Album article listing — list all articles in an official account's album (with real mp.weixin.qq.com links)
• Structured JSON output — all results to stdout, errors to stderr with typed exit codes

Install

npm install -g mpget

Requires Node.js >= 18.

Usage

CLI

# Search articles
mpget search "key"

# Search with pagination
mpget search "key" -p 2

# Multi-page search (up to 5 pages, 1s interval)
mpget search "key" -a -m 5

# Fetch article content
mpget content "https://mp.weixin.qq.com/s/xxx"

# List articles in an account's album (needs __biz and album_id from an article page)
mpget album "MzkxMTY4NTAyNQ==" "4371775694981152789" -c 10

# Fetch the whole album
mpget album "MzkxMTY4NTAyNQ==" "4371775694981152789" --all

Search options:

Option	Description	Default
-p, --page <n>	Page number	1
-a, --all	Fetch all pages	false
-m, --max <n>	Max pages when --all	10
--no-resolve	Skip resolving real mp.weixin.qq.com links	false

MCP Server

mpget mcp

Starts a stdio-based MCP server exposing three tools:

• search — query, page, all, maxPages, resolve (default: resolve real links)
• album — biz, albumId, count, beginMsgid, beginItemidx
• content — url, referer

Compatible with any MCP-capable agent (Claude, Cursor, etc.).

Agent Skill (Claude Code)

mpget init

Injects a skill template into .claude/skills/mpget.md. The skill includes version sync — the agent checks mpget --version against the skill header on each use.

Output

All commands output JSON to stdout. Errors go to stderr as structured JSON.

Search result:

{
  "results": [
    {
      "title": "Article Title",
      "link": "https://weixin.sogou.com/link?url=...",
      "realUrl": "https://mp.weixin.qq.com/s?src=11&...",
      "publishTime": "2025-01-01",
      "account": "Account Name"
    }
  ],
  "total": 10,
  "page": 1
}

Content result:

{
  "content": "Article body text..."
}

Exit codes:

Code	Meaning
0	Success
1	Anti-spider triggered or network error
2	Invalid arguments

Tech Stack

• TypeScript, Node.js >= 18
• commander — CLI framework
• cheerio — HTML parsing
• @modelcontextprotocol/sdk — MCP server
• Native fetch — no extra HTTP dependencies

License

LGPL-3.0