readgzh
ReadGZH MCP
Documentation
ReadGZH — WeChat Article Reader for AI
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.
- 🌐 Site:
- 📖 Docs:
- 💳 Pricing:
- 🔑 Dashboard / API Key:
Why ReadGZH
WeChat articles can't be read by Claude, ChatGPT, Cursor, or other AI tools — `mp.weixin.qq.com` blocks bots. ReadGZH solves this with a cloud reader you can call from any AI client.
- ☁️ Cloud-based — no WeChat desktop install, no local script
- 💰 Shared cache — previously read articles cost 0 credits for everyone
- 🖼️ CDN image proxy — permanent image links, no expiry
- 📱 Image-post (图文) support — full coverage of WeChat's gallery format
- 🤖 AI summaries — structured JSON via `?mode=summary` (Pro)
- 🔌 MCP, OpenAPI, REST — works with Claude Desktop, Cursor, ChatGPT, custom agents
Quick Start
Use it from your AI client (MCP)
ReadGZH is a remote MCP server — no install. Add to your MCP client config:
{
"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):
{
"mcpServers": {
"readgzh": {
"url": "https://api.readgzh.site/mcp-server",
"headers": { "Authorization": "Bearer rgz_..." }
}
}
}Use it from code (REST)
curl -X POST https://api.readgzh.site/rd \
-H "Content-Type: application/json" \
-H "Authorization: Bearer rgz_..." \
-d '{"url":"https://mp.weixin.qq.com/s/xxxx"}'Full API spec:
Tools (MCP)
| Tool | Purpose |
|---|---|
| `readgzh.read` | Read & extract a WeChat article from a URL |
| `readgzh.search` | Search cached articles by keyword |
| `readgzh.list` | List recently cached articles |
| `readgzh.get` | Fetch a cached article by slug |
Pricing
- Free — 30 credits/day for registered users · 10/IP/day anonymous
- Lite — ¥9/month · 300 reads/month
- Pro — ¥39/month · 2000 reads/month + AI summary
Each fresh read = 3 credits. Cached re-reads = 0. Details:
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 .
Contact
- Support:
- Issues: GitHub Issues
- Built with ❤️ on Lovable
Frequently asked questions
What is readgzh?
readgzh is ReadGZH MCP
How do I install readgzh?
Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.
Is readgzh open source?
Yes — it is hosted on GitHub at https://github.com/sweesama/readgzh and has 3 stars.
Related MCP tools
Model Context Protocol Servers
The Open-Source Multimodal AI Agent Stack: Connecting Cutting-Edge AI Models and Agent Infra
A MCP for Claude Desktop / Claude Code / Windsurf / Cursor to build n8n workflows for you
MCP server to provide Figma layout information to AI coding agents like Cursor
The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.
Instant is the best backend for AI-coded apps. You get auth, permissions, storage, presence, and streams — everything you need to ship apps your users will love.
Run your own MCP server? See who uses it and what to fix.
Measure it with TrackMCP