API & MCP 接入指南

1. 抓取文章

提交微信文章链接，系统自动抓取内容并缓存，返回文章 ID 和短链接。

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

{
  "success": true,
  "articleId": "abc123-...",
  "slug": "s/article-title",
  "cached": false,
  "data": {
    "title": "文章标题",
    "author": "作者名",
    "content": "文章纯文本内容...",
    "publishTime": "2025-01-01",
    "sourceUrl": "https://mp.weixin.qq.com/s/..."
  }
}

2. 读取已缓存文章

通过 slug 或 ID 获取已缓存的文章内容（返回 HTML）。

# 通过 slug
GET https://api.readgzh.site/rd?s=article-title

# 通过 ID
GET https://api.readgzh.site/rd?id=abc123-...

2.1 长文分页读取（?part=N）

长文章会自动拆分为约 40KB 的分块。通过 part 参数逐段读取。 响应头 X-Total-Parts 和 X-Current-Part 指示总块数和当前块。

# 读取第 1 部分
GET https://api.readgzh.site/rd?s=article-title&part=1

# 读取第 2 部分
GET https://api.readgzh.site/rd?s=article-title&part=2

2.2 AI 智能摘要（?mode=summary）Pro

添加 mode=summary 参数，返回 AI 生成的 300-500 字结构化摘要（JSON 格式）。 摘要结果会自动缓存，后续请求直接返回。此功能为 Pro 专属。

GET https://api.readgzh.site/rd?s=article-title&mode=summary \
  -H "Authorization: Bearer sk_live_你的Pro_Key"

{
  "success": true,
  "title": "文章标题",
  "author": "作者名",
  "summary": "📌 核心观点：...
📋 关键要点：...
🏷️ 标签：...",
  "content_url": "https://readgzh.site/article-slug",
  "total_parts": 3,
  "content_length": 12000
}

3. 一步到位（推荐）

GET 请求直接传入微信链接，自动抓取并返回可读 HTML。适合让 AI 直接访问。

GET https://api.readgzh.site/rd?url=https://mp.weixin.qq.com/s/xxxxx

返回精简的 HTML 页面，无需额外处理即可被 AI 直接读取。

1. 创建或编辑 GPTs

1. 打开 ChatGPT GPTs 编辑器
2. 点击「Configure」→「Actions」→「Create new action」
3. 在 Schema 输入框中选择「Import from URL」

2. 导入 OpenAPI 规范

粘贴以下 URL 导入 API 定义：

https://readgzh.site/.well-known/openapi.yaml

3. 配置鉴权

1. Authentication Type 选择「API Key」
2. Auth Type 选择「Bearer」
3. 粘贴你的 API Key（sk_live_...，可在 控制台 创建）

4. 设置 GPTs 指令

在 GPTs 的 Instructions 中添加以下内容：

当用户分享微信公众号文章链接（mp.weixin.qq.com）时，
使用 readgzh.read action 读取文章全文内容，
然后根据用户需求进行总结、翻译或分析。

5. 测试

保存后，在 GPTs 对话中发送一个微信文章链接，GPTs 会自动调用 ReadGZH 读取全文。

一键安装

如果你使用 Cursor，点击下面的按钮可直接添加 ReadGZH MCP：

手动配置

Claude Desktop / Cline / Continue 等支持 MCP 的客户端，添加以下配置即可：

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

配置文件位置：Claude Desktop（macOS）~/Library/Application Support/Claude/claude_desktop_config.json， Cursor ~/.cursor/mcp.json， Cline 在 VS Code 设置中搜索 cline.mcpServers。

可用工具

使用示例

配置完成后，你可以在 Claude 中这样使用：

方式一：通过 MCP 接入（推荐）

OpenClaw 原生支持 MCP 协议。只需在 OpenClaw 的 MCP 配置中添加 ReadGZH 服务即可：

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

配置完成后，OpenClaw 会自动发现 ReadGZH 提供的文章读取、搜索、列表等工具。

方式二：一键安装 Skill

如果 ReadGZH 已发布到 ClawHub，可直接一键安装：

clawhub install readgzh

或者手动下载安装：

mkdir -p ~/.openclaw/workspace/skills/readgzh
curl -o ~/.openclaw/workspace/skills/readgzh/SKILL.md \
  https://readgzh.site/.well-known/SKILL.md

安装后重启 OpenClaw，当用户提到「微信」「公众号」或分享 mp.weixin.qq.com 链接时，Skill 会自动触发。

配置 API Key（可选）

如需使用带鉴权的 API（更高配额），在 Skill 配置中添加 API Key：

api_key: "sk_live_你的Key"

使用示例

Coze（扣子）

1. 在 Coze 中创建或编辑 Bot，进入「插件」→「创建插件」
2. 选择「通过 URL 导入」，粘贴 OpenAPI 规范地址：

https://readgzh.site/.well-known/openapi.yaml

3. 鉴权方式选择「Bearer Token」，填入你的 API Key
4. 保存后即可在 Bot 对话中发送微信链接，自动调用 ReadGZH

Dify

1. 进入 Dify 应用编辑器，添加「自定义工具」
2. 选择「从 URL 导入 OpenAPI Schema」，粘贴：

https://readgzh.site/.well-known/openapi.yaml

3. 在鉴权设置中选择「API Key (Bearer)」，填入 Key
4. 工具会自动解析出 ReadGZH 提供的文章读取操作

FastGPT

1. 在 FastGPT 应用中添加「HTTP 插件」
2. 请求方式选择 GET，URL 填入：

https://api.readgzh.site/rd?url={{微信文章链接}}

3. 添加 Header：Authorization: Bearer sk_live_你的Key
4. 返回类型选择「文本」，即可获取文章 HTML 内容

获取 API Key

1. 前往 开发者控制台，使用邮箱验证码、Google 或 Apple 登录
2. 点击「创建 Key」生成一个 sk_live_... 格式的密钥
3. 每天点击「领取今日积分」获取 30 积分
4. 需要更多积分？查看订阅套餐，Lite ¥9/月起

使用方式

在请求中添加 Authorization 头：

curl "https://api.readgzh.site/rd?url=https://mp.weixin.qq.com/s/xxxxx" \
  -H "Authorization: Bearer sk_live_你的Key"

错误响应