ReadGZH

io.github.sweesamaPublished by GitHub account sweesamav1.0.0Updated Nov 2, 2026

Read WeChat public account articles via MCP. 99.89% anti-scraping success, 50-87% token compression.

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingKnowledge & Memory

Overview

AI-generated overview

Hosted MCP server that lets an assistant fetch full text of WeChat Official Account articles as Markdown and search a shared cache of previously read articles.

What you can do
  • Read a WeChat article from its URL and get title, author, publish time and full Markdown text
  • Search cached articles by keyword across titles and content
  • List recently cached articles, or cached articles from one Official Account
  • Retrieve a cached article again by its short slug
When to use it
Useful when you already have a link to a public WeChat Official Account article and want an assistant to read and summarize or compare it without running a local scraper. Also handy for re-reading or searching articles that were read before through the service.
Requirements
Remote MCP endpoint; no local install. An API key sent in the Authorization header is optional for the free tier and required for Pro; anonymous access is limited per IP. A separate OAuth connection is offered for clients that support it. Credits are consumed per fresh read.
Before you install
Article content is sent to a third-party service and stored in a shared cache that other users can read, so do not submit private or restricted material. Fresh reads cost credits (free daily allowance, paid plans). Search and per-account listing cover only the service's cache, not all of WeChat. Summaries and image-post extraction may be inaccurate; verify against the original.

Installation

In SourceWeft

  1. Open ReadGZH in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.sweesama%2Freadgzh/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "readgzh": {
      "type": "http",
      "url": "https://api.readgzh.site/mcp-server"
    }
  }
}

README

ReadGZH — WeChat Article Reader for AI

[License: AGPL v3] [Website] [MCP]

Let AI read full-text WeChat Official Account (微信公众号) articles. Cloud-based, zero-install. Returns title, author, publish time, and clean Markdown content. Supports standard articles and image-post (图文) formats.

Why ReadGZH

AI tools may fail to retrieve the body of a public WeChat Official Account article directly. ReadGZH provides a hosted reader for an existing article URL. Use its readable page with a browsing-capable AI, copy the extracted text, or connect through a compatible MCP client.

  • ☁️ Cloud-based — no WeChat desktop install, no local script
  • 💰 Shared cache — previously read articles cost 0 credits for everyone
  • 🖼️ CDN image proxy — proxies article images for off-platform access; availability is not guaranteed indefinitely
  • 📱 Image-post (图文) support — extracts supported image-post content; verify important image details against the original
  • 🤖 AI summaries — structured JSON via ?mode=summary (Pro)
  • 🔌 MCP, OpenAPI, REST — integration options for compatible clients; availability depends on client features and configuration

Choose the right workflow / 按需求选择

Read the bilingual use-case and limitations guide for direct answers about reading existing links, Markdown, comparing multiple articles, hosted MCP, and the difference between cache search and discovering new articles.

ReadGZH retrieves article content. It is not a complete WeChat search engine, an account subscription service, or a guarantee that an AI assistant will read every supplied link.

中文指南：AI 打不开公众号文章怎么办？

ReadGZH 适合这样的需求：你已经有一篇公开微信公众号文章的链接，希望把正文交给 AI 阅读，又不想安装和维护本地抓取程序。

偶尔读一篇：从网页开始

  1. 打开 ReadGZH，粘贴公众号文章链接。
  2. 获取转换后的页面，把页面链接交给支持网页访问的 AI。
  3. 如果你的 AI 不能打开链接，复制转换页面的正文；重要数字、引用和结论仍需回原文核对。

单篇阅读不需要先配置 MCP。能直接复制原文时，也可以直接把文字交给 AI。

给 Agent 使用：从远程 MCP 开始

ReadGZH 提供远程 MCP 和 REST API，适合不想自行维护浏览器与抓取环境的用户。接入示例见下方 Quick Start 和开发者文档。不同客户端的配置方式可能不同，请按对应客户端说明接入。

哪些情况应考虑其他方案？

  • 希望全过程在本地运行、自己控制读取环境：评估本地读取工具。
  • 想发现尚未提供链接的新文章、追踪公众号更新：先明确搜索或订阅需求。ReadGZH 的缓存搜索不等同于搜索微信全部文章。
  • 内容不适合经过第三方服务或进入共享缓存：不要提交到 ReadGZH。

多篇文章怎么比较？

分别转换每篇文章，保留标题与原文链接，再把正文或可访问页面交给 AI。可以使用：

请先确认你能读取每篇文章的正文。按文章 A、B、C 列出核心结论、证据、适用条件和未回答的问题；每一项注明来自哪篇，未提及就写未提及。不要把不同作者的观点合并成同一个结论。

如果无法读取其中一篇，先补充该篇正文，再开始比较。

使用边界与费用

仅处理你有权使用的公开可访问内容。已经删除、需要授权或读取受限的文章不保证成功。转换成功也不代表 AI 的总结准确。服务有免费额度及付费方案，具体计费以定价页为准。

Quick Start

Use it from your AI client (MCP)

ReadGZH offers two remote MCP connections. Choose the one your client supports:

ConnectionServer URLAuthentication
OAuth (Lovable integration)https://jhnnmmwgdrquwjytvvwu.supabase.co/functions/v1/mcpSign in to ReadGZH and approve the requested access in the Chinese authorization page
Existing API-key connectionhttps://api.readgzh.site/mcp-serverReadGZH API key in the Authorization header; anonymous access has shared-IP limits

中文：新 OAuth 接入适用于支持远程 MCP 与 OAuth 的客户端。在客户端添加上表 OAuth 地址，按页面提示登录并授权。各客户端、账号套餐和管理员设置可能限制自定义 MCP 接入；支持 MCP 不等于所有 AI 都会自动发现或使用 ReadGZH。

OAuth 连接提供 readgzh_read、readgzh_search、readgzh_list、readgzh_list_by_account、readgzh_get 五个工具。首次抓取前，账号需在 控制台 创建有效 API Key；新文章抓取消耗 3 积分，已缓存文章读取为 0 积分。搜索与按公众号列表仅覆盖 ReadGZH 缓存，不是全微信搜索或完整历史。

The following JSON examples use the existing API-key connection and its dot-separated tool names:

json
{  "mcpServers": {    "readgzh": {      "url": "https://api.readgzh.site/mcp-server"    }  }}

Then ask your AI: "Read this for me: https://mp.weixin.qq.com/s/..."

Optional API key (higher quota, bypasses anonymous IP limits):

json
{  "mcpServers": {    "readgzh": {      "url": "https://api.readgzh.site/mcp-server",      "headers": { "Authorization": "Bearer sk_live_..." }    }  }}

Use it from code (REST)

bash
curl -X POST https://api.readgzh.site/rd \  -H "Content-Type: application/json" \  -H "Authorization: Bearer sk_live_..." \  -d '{"url":"https://mp.weixin.qq.com/s/xxxx"}'

Full API spec: https://readgzh.site/.well-known/openapi.yaml

Tools (MCP)

ToolPurpose
readgzh.readRead & extract a WeChat article from a URL
readgzh.searchSearch cached articles by keyword
readgzh.listList recently cached articles
readgzh.list_by_accountList cached articles from an account (not a complete archive)
readgzh.getFetch a cached article by slug

Pricing

  • Free — 30 credits/day for registered users (claim daily) · 10 credits/IP/day anonymous
  • Lite — ¥9/month · 300 credits/month
  • Pro — ¥39/month · 2000 credits/month + AI summary

Each fresh read = 3 credits. Cached re-reads = 0. Details: https://readgzh.site/pricing

Tech Stack

  • React 18 + Vite + TypeScript + Tailwind + shadcn/ui
  • Lovable Cloud (Supabase: Postgres, Auth, Edge Functions, Storage)
  • Cloudflare Worker proxy (api.readgzh.site)
  • Stripe subscriptions
  • MCP via mcp-lite

License

AGPL-3.0. If you self-host or fork ReadGZH as a network service, you must release your modifications under the same license. For commercial licensing without AGPL obligations, contact [email protected].

Contact

Source: README.md at commit 8047943

Tools

5

readgzh.read

Read and extract the full text content of a WeChat Official Account (微信公众号) article via ReadGZH (readgzh.site). Provide a WeChat article URL and get back the title, author, publish time, and full article text in Markdown format. The article will be automatically cached for future reads.

Parametersurlrequired

readgzh.list

List recently cached WeChat articles via ReadGZH. Returns titles, authors, and links. Useful for browsing what articles have been previously read and cached.

Parameterslimit

readgzh.list_by_account

List cached WeChat articles published by one Official Account (公众号) via ReadGZH. IMPORTANT: this only covers articles already cached by ReadGZH — WeChat has no public API for a full account archive, so the result is not exhaustive. Use it to find other articles by the same author after reading one.

Parameterslimitaccountrequired

readgzh.get

Get a cached WeChat article by its short slug/URL path via ReadGZH. Use when you have a slug like 'minicpm-o-4-5' from a previous read.

Parametersslugrequired

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts