wechat-reader-mcp
Provides a structured interface for reading WeChat public account articles, handling authentication via existing browser sessions, and returning statuses like ok, captcha_required, and rate_limited.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@wechat-reader-mcp read this WeChat article: https://mp.weixin.qq.com/s/ABC123"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
wechat-reader
面向 AI Agent 的微信公众号阅读工具,提供 CLI、MCP server 和 Python API,可复用用户已登录、已验证的浏览器会话。
wechat-reader 适合这样的场景:用户已经有一个真实浏览器窗口可以手动完成微信验证,而 agent 需要一个结构化、可重试、可诊断的阅读接口。

谁需要这个工具
如果你的 AI agent 或自动化流程需要可靠地读取微信公众号文章,这个工具就是为你准备的。
问题: 微信文章链接对程序化访问极不友好。用 curl、requests、web_fetch 直接抓取,经常拿到空白页、验证码页或登录墙——而且是静默失败,你的 agent 甚至不知道自己拿到的是垃圾。
这个工具的不同之处:
复用真实浏览器会话,像人一样读取文章
返回结构化状态(
ok、captcha_required、rate_limited),agent 知道到底发生了什么需要验证时,告诉 agent 去请求用户操作——而不是静默返回无用内容
典型使用场景:
AI agent 工作流中处理微信文章链接(摘要、翻译、知识库入库)
内容监控或竞品分析流水线
任何自动化流程中出现微信链接、需要稳定读取的场景
不适合你的情况: 偶尔读一篇微信文章——直接复制粘贴更快。这个工具是为微信链接频繁出现在自动化流程中、需要每次都能读通的场景设计的。
Related MCP server: crawl-mcp
使用入口
wechat-reader:直接在终端里读取、打开、诊断微信文章页面wechat-reader-mcp:把同样的能力暴露给 Claude、Codex 等支持 MCP 的宿主wechat_reader:在你自己的 Python 工具里直接调用
快速开始
要求 Python 3.11+。
安装
git clone https://github.com/xiguawang/wechat-reader.git
cd wechat-reader
uv sync
uv run playwright install chromium如果你不使用 uv,也可以退回到:
pip install -e .
python -m playwright install chromium通过 CLI 读取文章
wechat-reader read "https://mp.weixin.qq.com/s?..." --json检查本机浏览器环境
wechat-reader setup启动 MCP Server
wechat-reader-mcpPython API
from wechat_reader import read_article_sync
result = read_article_sync("https://mp.weixin.qq.com/s?...", strategy="auto", timeout=30)
print(result.status, result.title)你会得到什么
attach、launch、playwright、auto四种浏览器策略ok、captcha_required、rate_limited等结构化状态CLI 下的 JSON / Markdown 输出
可直接接入 agent 的 MCP server
可嵌入你自己工具链的 Python API
截图
验证完成后的成功读取
需要用户先完成验证的阻塞状态
MCP Server
项目内置了一个 stdio MCP server:
wechat-reader-mcp当前暴露的 tools:
wechat_read_articlewechat_open_articlewechat_list_tabswechat_read_current_tabwechat_get_statuswechat_setup
CLI
setup
wechat-reader setup
wechat-reader setup --jsontabs
wechat-reader tabs --wechat-only
wechat-reader tabs --wechat-only --jsonopen
wechat-reader open "https://mp.weixin.qq.com/s?..." \
--strategy launch \
--channel chrome \
--jsonread
wechat-reader read "https://mp.weixin.qq.com/s?..." \
--strategy auto \
--timeout 30 \
--json如果输入的是微信验证包装链接,例如 mp/wappoc_appmsgcaptcha?...&target_url=...,工具会先解包到真实文章 URL,再做 tab 匹配和导航,避免把已验证页面重新带回验证码入口。
限制说明
wechat-reader 不是一个承诺“稳定绕过微信风控”的通用抓取器。
微信风控可能随时变化
某些链接仍然需要用户先手动完成验证
“操作频繁”是真实运行状态,不是这个工具能彻底消除的问题
受限沙箱环境下,CDP attach 可能出现本地
EPERM移动端更适合“移动端发起,桌面端 bridge 执行”的模式
许可证
MIT
Available Tools
6 toolswechat_get_statusGet WeChat Page StatusA
Inspect the current status of a WeChat article URL or the current WeChat tab without requiring a full successful read.
Inputs: url, tab_id, cdp_url, channel, +6 more. Returns: url, hint, title, author, +7 more
wechat_list_tabsList WeChat TabsARead-onlyIdempotent
List attachable browser tabs, filtered to WeChat tabs by default.
Inputs: cdp_url, wechat_only. Returns: tabs
wechat_open_articleOpen WeChat ArticleA
Open a WeChat article URL and return structured page status without requiring full extraction.
Inputs: url (required), cdp_url, channel, timeout, +5 more. Returns: url, hint, title, author, +7 more
wechat_read_articleRead WeChat ArticleA
Read a WeChat article URL through the local browser bridge and return structured article data or status.
Inputs: url (required), cdp_url, channel, timeout, +5 more. Returns: url, hint, title, author, +7 more
wechat_read_current_tabRead Current WeChat TabB
Read the first attachable WeChat tab, or a specific tab by tab_id.
Inputs: tab_id, cdp_url, channel, timeout, +5 more. Returns: url, hint, title, author, +7 more
wechat_setupDiagnose Bridge SetupARead-onlyIdempotent
Return local browser bridge diagnostics and setup guidance.
Returns: setup
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Most tools have distinct purposes: reading from a URL vs. reading from a tab, listing tabs, and setup are clear. However, wechat_open_article and wechat_get_status both return status information without full extraction, which could cause confusion in selection.
All tool names follow a consistent wechat_ + verb + noun pattern (e.g., wechat_read_article, wechat_list_tabs, wechat_get_status). Even wechat_setup is a common single-word exception that fits the scheme and doesn't disrupt predictability.
Six tools is well within the ideal 3-15 range. Each tool serves a clear purpose in the article-reading workflow (setup, list tabs, open, read, status), and none are redundant.
The tool set covers the core lifecycle for reading WeChat articles through a browser bridge: setup, tab discovery, opening URLs, reading from URL or tab, and status checks. No critical operations are missing for the stated scope.
Maintenance
Related MCP Connectors
Read WeChat public account articles via MCP. 99.89% anti-scraping success, 50-87% token compression.
Free remote MCP server for fetching public web pages through a rotating proxy pool.
MCP server for MailTempo's public free temporary email inboxes.
Zenrows MCP server: Fetch, Extract, Batch, and Browser Sessions for AI agents
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceExtracts title, author, and content (in Markdown format) from WeChat official account articles via URL, supporting both MCP stdio and HTTP server modes.1-
- AlicenseNot gradedqualityDmaintenanceMCP server to crawl WeChat articles, download images, and convert to Markdown, designed for Cursor IDE and AI tools.48 npm38MIT
- AlicenseNot gradedqualityDmaintenanceMCP server that enables AI agents to fetch and summarize WeChat public articles, supporting export to HTML, Markdown, Obsidian, Notion, and OneNote.5MIT
- FlicenseNot gradedqualityDmaintenanceMCP server for WeChat automation, supporting message sending, chat history retrieval, and contact list management via SSE protocol.5-