Skip to content
Skills Library
Marketing & content · Conversion & formats

wechat-article-reader

/wechat-article-reader

Read WeChat Official Account (微信公众号) articles from mp.weixin.qq.com links as Markdown. Use whenever a task involves an mp.weixin.qq.com URL, or a web fetch returned "环境异常" / "完成验证后即可继续访问" for a WeChat article.

Licence
MIT
Last repository change
30.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
3
Deprecation

No signals detected. Repository changed on 30.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Read WeChat Official Account (微信公众号) articles from mp.weixin.qq.com links as Markdown. Use whenever a task involves an mp.weixin.qq.com URL, or a web fetch returned "环境异常" / "完成验证后即可继续访问" for a WeChat article.

Triggers from the description

环境异常完成验证后即可继续访问
Original author description

Read WeChat Official Account (微信公众号) articles from mp.weixin.qq.com links as Markdown. Use whenever a task involves an mp.weixin.qq.com URL, or a web fetch returned "环境异常" / "完成验证后即可继续访问" for a WeChat article.

How it works

  1. Read an article
  2. Several articles
  3. When it fails
  4. Finding articles
Original SKILL.md headings · 44 lines, 339 words
SKILL.md preview
---
name: wechat-article-reader
description: Read WeChat Official Account (微信公众号) articles from mp.weixin.qq.com links as Markdown. Use whenever a task involves an mp.weixin.qq.com URL, or a web fetch returned "环境异常" / "完成验证后即可继续访问" for a WeChat article.
---

# Reading WeChat (微信公众号) articles

Built-in web fetch tools run on cloud servers, and WeChat answers them with a
"环境异常" verification page. Fetch the article locally with `wechat-article-reader`
instead. Do not try WebFetch on mp.weixin.qq.com first.

## Read an article

```bash
wxread "<mp.weixin.qq.com url>"
```

If `wxread` is not installed, install it once with `uv tool install git+https://github.com/Rudy-114/wechat-article-reader`
(or `pip install git+https://github.com/Rudy-114/wechat-article-reader`), or run it without installing:
`uvx --from git+https://github.com/Rudy-114/wechat-article-reader wxread "<url>"`.

Useful flags:
- `--no-images`: drop image links to save tokens when images don't matter.
- `--json`: structured output (title, account, author, publish_time, markdown, images, source_url).
- `-o file.md --images ./img`: save the article and download its images. Use this when you need to look at the images, since mmbiz.qpic.cn links often can't be viewed directly.

The output starts with a header (title, 公众号, 作者, 发布时间, 原文链接) followed by the body.

## Several articles

Run them one at a time with a short pause (`sleep 1`) between requests. Bursts trigger WeChat's verification.

## When it fails

The error is printed to stderr as `error[<status>]: <reason>`:

| status | meaning | what to do |
|---|---|---|
| `verify_required` | WeChat wants a human check (proxy/VPN, server IP, or too many requests) | Tell the user. Suggest turning off the proxy/VPN, waiting a few minutes, or running `wxread --browser "<url>"` (needs `wechat-article-reader[browser]`) and completing the check in the window. Never try to solve or bypass the check yourself. |
| `deleted` / `blocked` | Article removed by publisher / by WeChat | Report it; look for a reposted copy elsewhere if the user needs the content. |
| `expired` | Temporary link (`timestamp`/`signature` params) expired | Ask for, or search for, the permanent link. |
| `invalid` | Truncated or malformed URL | Check the URL was copied completely. |
| `invalid_url` | Not an mp.weixin.qq.com link | Use your normal web tools. |

## Finding articles

This tool only reads. To find articles, use your search tool with `site:mp.weixin.qq.com <keywords>`, then read the result URLs with the command above.

Versions

The database has no other skills named wechat-article-reader.

Database snapshot: 13.11.2026 · package version 3fba842042bb (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 98wechat-article-downloader
    Download, filter, archive, analyze, and export WeChat public-account (微信公众号) articles from mp.weixin.qq.com. Use for one public article, latest N articles, a date-bounded or resumable full history, merging history downloads into a flat archive with an exception report, common…
  • 100weixin-article-to-obsidian-cn
    当用户需要把 mp.weixin.qq.com 微信公众号文章抓取为 Obsidian Markdown,并将图片本地化到 vault assets 目录时使用。
  • 100weixin-article-to-obsidian
    Use when saving a Weixin Official Account article from mp.weixin.qq.com into an Obsidian vault as Markdown with locally downloaded images and vault-style asset links.
  • 100wechat-official-batch-download
    Use this skill when the user wants to batch download, archive, verify, or build a corpus from WeChat Official Account articles, or needs to fetch articles as writing references. Especially when using mp.weixin.qq.com links, down.mptext.top/dashboard, wechat-article-exporter,…
  • 100wechat-official-account
    Generate articles, manage drafts, publish to «发表记录», send customer-service messages, manage menus and pull stats on a WeChat Official Account (微信公众号 / 服务号 / 订阅号) via the WeChat MP server-side API. Use when the user mentions 公众号, 服务号, 订阅号, mp.weixin.qq.com, AppID/AppSecret of a…
  • 95wechat-article-ego
    Save one WeChat Official Account (公众号 / mp.weixin.qq.com) article draft through the visible editor in Ego Lite. Not WeChat Channels. Login-check first. Soft-fail with exit 2 when ego-browser is missing, the console is logged out, or --expect-account does not match. If more than…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.