weread-skillslisted
Install: claude install-skill kuangketongxue/kuang-skills
# WeRead — 微信读书助手
> **来源与改动**(Apache-2.0 §4 要求标注修改):本 skill 复制自
> [Tencent/WeChatReading](https://github.com/Tencent/WeChatReading) v1.0.4,Copyright © 2026 Tencent,
> Apache-2.0 License(完整文本见 [`LICENSE`](./LICENSE))。
> 本文件相对原版有改动:① 内部文档引用路径 `*.md` → `references/*.md`(对齐 kuang-skills 仓约定);
> ② 「鉴权」节补充 API key 从 `~/.claude/.secrets/weread.env` 读取的约定(对齐本仓 web-search skill)。
> 其余内容、接口规范、字段说明均为 Tencent 原文,未改动。
通过 Agent API Gateway 调用微信读书接口,提供搜索、书架、笔记、书评等能力。
## 支持的能力
| 能力 | 说明 | 用户示例 | 详细说明 |
|------|------|----------|----------|
| 搜索书籍 | 在书城搜索 | "帮我搜一下三体" | `references/search.md` |
| 书籍信息 | 查看书籍详情、章节目录、阅读进度 | "这本书有多少章" "我读到哪了" | `references/book.md` |
| 书架管理 | 查看书架 | "看看我的书架" | `references/shelf.md` |
| 阅读统计 | 阅读时长、天数、偏好分析、阅读统计摘要 | "我这个月读了多久" "今年读了几本书" | `references/readdata.md` |
| 笔记划线 | 查看个人笔记数量与内容,包括划线、想法/点评、书签数量 | "看看我在三体里的笔记" "导出我的划线" "在这本书有多少笔记" | `references/notes.md` |
| 章节热门划线 | 查看书籍/章节热门划线、划线热度及划线下想法 | "看看这章有什么热门划线" "这段话下面有什么想法" | `references/notes.md` |
| 书籍点评 | 查看书籍的公开点评 | "三体这本书有什么点评?" "看看推荐的点评" | `references/review.md` |
| 推荐好书 | 个性化推荐/相似推荐 | "给我推荐几本书" | `references/discover.md` |
根据用户意图参考对应说明文件了解接口参数、回包结构和工作流。
---
## 接口调用规范
### 统一入口
```
POST https://i.weread.qq.com/api/agent/gateway
```
### 鉴权
- Header:`Authorization: Bearer $WEREAD_API_KEY`
- `WEREAD_API_KEY` 自动从 `~/.claude/.secrets/weread.env` 读取(本仓不含真 key,`.env.example` 为占位符模板);文件不存在时回退到同名 shell 环境变量
- key 格式 `wrk-xxxxxxxx`,获取地址 https://weread.qq.com/r/weread-sk