weread-skills (Tencent) for Claude Code: search and manage WeChat Reading from chat
weread-skills lets your agent look up books, your shelf, notes and reading stats in WeChat Reading (微信读书).
- Installs
- 53.4K
- on skills.sh
- Stars
- 273
- on GitHub
- Files
- 8
- besides SKILL.md
- Updated
- Oct 2026
- last repo commit
weread-skills is a skill for WeChat Reading published in Tencent's wechatreading repo. Ask in plain language, such as "看看我的书架" or "我这个月读了多久", and the agent searches the book store, shows your shelf and book details, lists your notes and highlights, browses public reviews, summarizes reading time and recommends books.
It needs a WeChat Reading API key in the WEREAD_API_KEY environment variable. SKILL.md's request example is a curl POST to https://i.weread.qq.com/api/agent/gateway with that key. SKILL.md is written in Chinese. It tells the agent to read the matching guide file before it calls an endpoint, and to include its own version number in each request.
Good for
- WeChat Reading users who want to query their shelf and reading stats from an agent
- Readers who want to export notes and highlights from a book
- Anyone who wants book recommendations based on their reading history
Install weread-skills
Claude Code
- 1
Copy this prompt.
Install the weread-skills skill in Claude Code. Run this command: npx skills add Tencent/WeChatReading -g Then check that it loaded and tell me how to use it.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires Node.js.
From the project README. Source.
What's in the skill
When it loads
微信读书助手 — 搜索书籍、管理书架、查看笔记划线、浏览书评、阅读统计、发现推荐好书
Sections in SKILL.md
- 支持的能力
- 接口调用规范
- 统一入口
- 鉴权
- 请求格式
- 请求 few-shot
- 响应格式
- 通用规则
- 书籍跳转链接
Key facts
- Source repo
- tencent/wechatreading
- Installs on skills.sh
- 53,354 as of 2026-11-02
- GitHub stars
- 273 (whole repo) as of 2026-11-02
- Last repo commit
- 2026-10-10
- skills.sh audits
- Gen Agent Trust Hub pass, Socket pass, Snyk pass
- Language
- SKILL.md is in Chinese
What it includes
Search the book store; guide in search.md.
Try: “帮我搜一下三体”
Runs code ·
搜索书籍 (search)Book details, chapter list and your reading progress; guide in book.md.
Try: “这本书有多少章”
Runs code ·
书籍信息 (book)Show your shelf, including audiobooks and article saves; guide in shelf.md.
Try: “看看我的书架”
Runs code ·
书架管理 (shelf)Reading time, days, preferences and summaries; guide in readdata.md.
Try: “我这个月读了多久”
Runs code ·
阅读统计 (readdata)Your note counts, highlights, thoughts and bookmarks; guide in notes.md.
Try: “导出我的划线”
Runs code ·
笔记划线 (notes)Popular highlights per book or chapter and the thoughts under them; guide in notes.md.
Try: “看看这章有什么热门划线”
Runs code ·
章节热门划线 (popular highlights)Public reviews of a book; guide in review.md.
Try: “三体这本书有什么点评？”
Runs code ·
书籍点评 (review)Personal and similar-book recommendations; guide in discover.md.
Try: “给我推荐几本书”
Runs code ·
推荐好书 (discover)
From the official docs
Permissions
Medium risk
The skill sends your WeChat Reading API key and your requests to Tencent's gateway through curl. Keep the key in an environment variable, and review any upgrade steps the server returns before you let the agent run them.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
The server can tell the agent to upgrade the skill
SKILL.md says that if a response contains upgrade_info, the agent must pause immediately, follow upgrade_info.message to upgrade, then retry, and must not ignore the field. Those steps come from the server at run time, so check what they run before approving them. github.com
Your key goes in every request
Each curl call carries the key in an Authorization header, plus your queries, to i.weread.qq.com. Use a key you can revoke and do not paste it into chat. github.com
Runs curl commands
SKILL.md shows curl POST calls to one gateway URL. The skill bundles no scripts of its own. github.com
Technical details
| Talks to | i.weread.qq.com |
|---|---|
| Sign-in and keys | The key is read from the WEREAD_API_KEY environment variable. The README says it is tied to your user identity. |
| Scopes |
|
Questions
How do I install the weread-skills skill?
Use the install box above. The README gives one command, the skills CLI. After installing, create your API key on the WeRead page the README links, then set it as the WEREAD_API_KEY environment variable in the terminal that starts your agent.
Does weread-skills need an API key?
Yes. SKILL.md sends a WeChat Reading API key (format wrk-xxxxxxxx) with every request. The README says the key is tied to your user identity. If the variable is not set, the skill tells you to export it.
What does it send, and where?
Each request is a POST to https://i.weread.qq.com/api/agent/gateway with your API key in an Authorization header, the endpoint name, your parameters and the skill version. Anything you ask about, such as book titles or your notes, goes through that gateway.
Can it change my bookshelf or notes?
The capability list in SKILL.md and the README covers searching, viewing and exporting, and the eight guide files document no add, delete or edit endpoint. You can ask the agent to print the available endpoints with the /_list call described in SKILL.md.
Does weread-skills work in the Claude app?
The README documents only the skills CLI. The skill calls curl with an environment variable, which needs a shell. Use Claude Code or another agent that runs shell commands. No Claude app upload route is documented.
Is weread-skills safe to install?
It bundles no scripts, only Markdown guides, but it has the agent run curl against a Tencent service with your API key. SKILL.md also says that if a response contains upgrade_info, the agent must pause and follow the instructions in upgrade_info.message, so the server can steer the agent mid-session. Read the safety notes below, keep the key out of chat, and check any upgrade steps before approving them.
Information
updated Nov 2, 2026
- Repository
- tencent/wechatreading
- Folder
skills
Sources
Docs, issue trackers and discussions this page is built from.
Show all 3Hide
- tencent/wechatreading README · github.com
- weread-skills SKILL.md · github.com
- weread-skills on skills.sh · skills.sh