Wechat Reader

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 工作流中处理微信文章链接（摘要、翻译、知识库入库）
• 内容监控或竞品分析流水线
• 任何自动化流程中出现微信链接、需要稳定读取的场景

不适合你的情况： 偶尔读一篇微信文章——直接复制粘贴更快。这个工具是为微信链接频繁出现在自动化流程中、需要每次都能读通的场景设计的。

> [English version](./README_EN.md)

使用入口

• 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-mcp

Python 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_article
• wechat_open_article
• wechat_list_tabs
• wechat_read_current_tab
• wechat_get_status
• wechat_setup

CLI

setup

wechat-reader setup
wechat-reader setup --json

tabs

wechat-reader tabs --wechat-only
wechat-reader tabs --wechat-only --json

open

wechat-reader open "https://mp.weixin.qq.com/s?..." \
  --strategy launch \
  --channel chrome \
  --json

read

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

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: xiguawang
• Source: xiguawang/wechat-reader
• License: MIT

Install and usage instructions live in the source repository linked above.