WeChatReading skill
Shelf, highlights and reading stats from WeChat Reading in a chat with your agent: the official Tencent skill
- 282 ★ on the repository
- Last commit
Extended access
Why this level
- The API key is tied to the user's identity and opens the shelf, notes and reading statistics
- Every request goes to a Tencent server with the key in the Authorization header
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/wechatreadingDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The API key is tied to the user's identity and opens the shelf, notes and reading statistics
- Every request goes to a Tencent server with the key in the Authorization header
This is third-party code. Review the repository files before installing.
What it does
The skill connects an agent to WeChat Reading (微信读书) through the Agent API gateway with the `WEREAD_API_KEY` key, and the agent gets reader data back. Available are bookstore search, book details and table of contents, the bookshelf, notes and highlights, popular chapter highlights, public reviews, reading statistics and recommendations. The main SKILL.md sets the calling rules, and details for each group sit in separate files: `search`, `book`, `shelf`, `notes`, `readdata`, `review`, `discover`. Before a request the agent reads the matching file instead of guessing what fields mean. It shows reading time in hours and minutes and converts timestamps to dates.
Who it is for. WeChat Reading users who keep a library and notes in the service and want to ask an agent about them in plain language.
Good fit when
- Highlights and notes from a book need to become a summary
- You want to know how much you read this month and this year
- A book has to be found by title with author, rating and a reading link shown at once
- You want similar books for one you finished, plus recommendations based on your shelf
- You are curious which passages of a chapter readers highlight most
Not a fit when
- You have no WeChat Reading account: the API key is tied to a service user
- You need to change the shelf or notes: the described capabilities are for reading and viewing
- Your agent supports only MCP: the catalog has the third-party mcp-server-weread for it
Example request
Find the book 三体 in WeChat Reading and show my highlights from itLimitations
The skill calls the gateway `https://i.weread.qq.com/api/agent/gateway`, so it needs access to Tencent servers and a key from the service site. Documentation and gateway replies are in Chinese. Every request carries the skill version, and if a reply contains `upgrade_info` the skill requires stopping and updating. The versions differ: the README says 1.0.4 and SKILL.md says 1.0.5. The agent takes reading links (`readerLink`) and book page links (`deepLink`) from the gateway reply and never builds them itself.
How to disable. Delete the installed `weread-skills` skill from the agent's skills directory and remove `WEREAD_API_KEY` from the environment. You can revoke the key on the service page where you got it.
FAQ
Where do I get the API key?
On https://weread.qq.com/r/weread-skills. The key looks like `wrk-xxxxxxxx` and goes into the `WEREAD_API_KEY` variable. It is tied to your user, so the user ID is added to requests automatically.
How can I see all available methods?
Send the gateway a request with `api_name` set to `/_list`; the reply lists methods with their parameters.
What happens when a new skill version comes out?
The gateway adds an `upgrade_info` field to the reply. The skill tells the agent to pause, run the stated update and then repeat the user's request.
How many books are on the shelf and how does the skill count them?
By the SKILL.md rule the number is the length of the `books` list plus the length of `albums` plus one if `mp` is not empty. Albums, meaning audiobooks, count as shelf books.
What can I search for in the store?
E-books, audiobooks, web novels, authors and full-text fragments across the corpus.
Discussion
No questions or reviews yet.
Related
SkillsA reading advisor for agents on top of WeRead: picks from shelf and notes, learning paths, note digests and year reviews.
An MCP server for WeChat Reading: your AI agent gets your bookshelf, notes, highlights and top reviews
Readwise skills help agents triage a reading inbox, discuss books and connect highlights across saved sources
A skill processes your WeChat favorites on a Mac and builds an HTML report with search, filters and activity charts.
A Claude Code and Cursor skill that reads dating-app chat screenshots and drafts replies matched to the stage of the relationship.
Skill linking an agent to the 得到大脑 notes service: saves links and images, searches by meaning, files notes in knowledge bases.
README in short
A short README in Chinese: the install command, getting a key, example phrases for the agent, a table of seven capabilities linking to files, and the version number. Detailed request rules live in SKILL.md and the files of the skills directory.
README badge
Original SKILL.md
--- name: weread-skills description: 微信读书助手 — 搜索书籍、管理书架、查看笔记划线、浏览书评、阅读统计、发现推荐好书 version: 1.0.5 --- # WeRead — 微信读书助手 通过 Agent API Gateway 调用微信读书接口，提供搜索、书架、笔记、书评等能力。 ## 支持的能力 | 能力 | 说明 | 用户示例 | 详细说明 | |------|------|----------|----------| | 搜索书籍 | 在书城搜索 | "帮我搜一下三体" | `search.md` | | 书籍信息 | 查看书籍详情、章节目录、阅读进度 | "这本书有多少章" "我读到哪了" | `book.md` | | 书架管理 | 查看书架 | "看看我的书架" | `shelf.md` | | 阅读统计 | 阅读时长、天数、偏好分析、阅读统计摘要 | "我这个月读了多久" "今年读了几本书" | `readdata.md` | | 笔记划线 | 查看个人笔记数量与内容，包括划线、想法/点评、书签数量 | "看看我在三体里的笔记" "导出我的划线" "在这本书有多少笔记" | `notes.md` | | 章节热门划线 | 查看书籍/章节热门划线、划线热度及划线下想法 | "看看这章有什么热门划线" "这段话下面有什么想法" | `notes.md` | | 书籍点评 | 查看书籍的公开点评 | "三体这本书有什么点评？" "看看推荐的点评" | `review.md` | | 推荐好书 | 个性化推荐/相似推荐 | "给我推荐几本书" | `discover.md` | 根据用户意图参考对应说明文件了解接口参数、回包结构和工作流。 --- ## 接口调用规范 ### 统一入口 ``` POST https://i.weread.qq.com/api/agent/gateway ``` ### 鉴权 - Header：`Authorization: Bearer $WEREAD_API_KEY` - `WEREAD_API_KEY` 从环境变量获取，格式 `wrk-xxxxxxxx` - 若未设置，提示用户：`export WEREAD_API_KEY=<你的apikey>` - API Key 绑定用户身份（vid），需要用户身份的接口会自动注入，无需手动传 vid ### 请求格式 - **Method**：POST