前言¶
很多人把书读在微信读书里，划线、想法、进度都在账号里，但和 Cursor、Claude Code 等 Agent 对话时，模型拿不到这些数据。自己写爬虫或逆向接口成本高，也不稳定。下面介绍 SkillHub 上的社区 Skill weread-skills（坐标 @user_c54b5ab8/weread-skills-pro）：按通用 SKILL.md 约定，让 Agent 通过微信读书 Agent API Gateway 访问书城搜索、书架、笔记、书评和阅读统计，而不是每次手工复制粘贴。
这是什么¶
weread-skills 的定位是「微信读书助手」——搜索书籍、管理书架、查看笔记划线、浏览书评、阅读统计、发现推荐好书（与 SkillHub 简介一致）。
- 发布与来源：SkillHub 分类为
knowledge-management，来源标注为community，发布者为user_c54b5ab8。 - 实现方式：Skill 包内的
SKILL.md写明，能力通过POST https://i.weread.qq.com/api/agent/gateway统一入口调用；Agent 按文档中的接口名与参数规范发起请求。 - 鉴权：SkillHub 标签含
requires_api_key=true；文档要求使用环境变量WEREAD_API_KEY（格式wrk-xxxxxxxx），请求头为Authorization: Bearer $WEREAD_API_KEY。Key 与微信读书用户身份绑定，需用户身份的接口会自动注入，无需手传vid。
SkillHub 页面展示版本为 v1.0.0；当前安装包内 SKILL.md 头部 version 字段为 1.0.3，调用网关时 body 需携带与之一致的 skill_version（见下文示例）。
核心功能¶
以下能力均来自安装包内 SKILL.md 的「支持的能力」表及配套说明文件（search.md、book.md、shelf.md、readdata.md、notes.md、review.md、discover.md）：
| 能力 | 说明 |
|---|---|
| 搜索书籍 | 在书城按关键词搜索 |
| 书籍信息 | 详情、章节目录、阅读进度 |
| 书架管理 | 查看个人书架（含有声专辑等条目规则见 shelf.md） |
| 阅读统计 | 时长、天数、偏好与统计摘要 |
| 笔记划线 | 个人划线、想法/点评、书签等 |
| 章节热门划线 | 书籍/章节热门划线及划线下想法 |
| 书籍点评 | 公开点评浏览 |
| 推荐好书 | 个性化或相似推荐 |
文档还约定：用户只说书名时，应先调 /store/search 解析 bookId 再执行后续操作；列表结果宜编号展示；时间戳、阅读时长等有统一展示格式；可为内容拼接 weread:// 深度链接以便在 App 内打开。
安装与启用¶
1、安装 SkillHub CLI（若尚未安装）¶
按 SkillHub 安装文档 检查并安装：
command -v skillhub && skillhub --version
未安装时可执行文档中的安装脚本（完整安装或 --cli-only 仅装 CLI）。
2、安装 weread-skills¶
安装时必须用 --dir 指向当前 Agent 会加载的 skills 目录，否则默认落到 ./skills/ 可能不会被识别。
skillhub install @user_c54b5ab8/weread-skills-pro --dir <你的 skills 目录>
常见路径（同官方安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可将下面提示词发给 Agent，让其按文档完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_c54b5ab8/weread-skills-pro`。
3、配置 API Key¶
- 在 微信读书 Skill 页面 按指引获取 API Key（页面说明 Key 用于连接账号，数据仅本人可见）。
- 在运行 Agent 的环境中设置：
export WEREAD_API_KEY=<你的 apikey>
SKILL.md 规定：未设置时应提示用户完成上述 export。
安装或更新 Skill 后，按你所用客户端的要求重启或刷新 Agent，使新 Skill 生效。
典型用法¶
自然语言（推荐给日常阅读场景）¶
启用 Skill 后，可直接用文档中的用户示例驱动 Agent，例如：
- 「帮我搜一下三体」
- 「看看我的书架」
- 「我这个月读了多久」「今年读了几本书」
- 「看看我在三体里的笔记」「导出我的划线」
- 「三体这本书有什么点评？」
- 「给我推荐几本书」
Agent 应先阅读 SKILL.md 及对应能力的 *.md，再按规范调用网关。
直接调用网关（核对连通性）¶
SKILL.md 提供的搜索示例如下（skill_version 需与包内 SKILL.md 的 version 一致，当前为 1.0.3）：
curl -X POST "https://i.weread.qq.com/api/agent/gateway" \
-H "Authorization: Bearer $WEREAD_API_KEY" \
-H "Content-Type: application/json" \
-d '{"api_name": "/store/search", "keyword": "三体", "count": 10, "skill_version": "1.0.3"}'
注意：业务参数须与 api_name、skill_version 平铺在 JSON 顶层，不要包在 params 对象内，否则分页等参数可能不被转发。需要接口清单时，可请求 {"api_name": "/_list"}（见 SKILL.md）。
适用场景与注意¶
适合谁
- 已在微信读书长期阅读、希望 Agent 能查书架、进度、笔记和统计的用户。
- 希望在对话里做「找书 → 看书评 → 对照自己划线」而不反复切换 App 的场景。
限制与注意
- 依赖有效的
WEREAD_API_KEY与网络访问i.weread.qq.com；Key 泄露等同于账号阅读数据暴露，勿提交到仓库或日志。 - 社区来源 Skill，使用前可在 SkillHub 查看评分与下载量（页面当前显示评分 100000、下载 1451 次，以页面实时数据为准）。
- 若网关回包含
upgrade_info，SKILL.md要求按指引升级 Skill 后再继续，勿忽略版本更新提示。 - 微信读书官网另提供
npx skills add Tencent/WeChatReading -g等安装方式；本文聚焦 SkillHub 坐标@user_c54b5ab8/weread-skills-pro的安装路径，二者产品能力描述相近，但分发渠道不同，按你实际使用的工具链选一种即可。
结尾¶
weread-skills 把微信读书里分散的书架、笔记和阅读数据，收敛成 Agent 可执行的 SKILL.md 与网关调用规范，适合作为个人知识管理类 Skill 使用。安装与详情见 SkillHub： weread-skills 页面 ，资源地址 https://api.skillhub.cn/user_c54b5ab8/weread-skills-pro 。
