前言¶
很多人把閱讀記錄、劃線和書架留在微信讀書裏，但和 AI 協作時仍要手動複製書名、翻 App 查進度。通用網頁搜索也拿不到你賬號下的書架和筆記。下面介紹 SkillHub 上的「微信讀書官方Skills」：把搜書、書架、筆記劃線、書評、閱讀統計和推薦發現封裝成 Agent 可調用的 Skill，用自然語言驅動，數據走微信讀書 Agent API Gateway。
這是什麼¶
一句話定位：微信讀書助手 Skill，通過統一網關調用微信讀書接口，讓 Agent 完成書城搜索、個人書架與閱讀數據相關操作。
- 上架座標：
@user_0b9d349a/weread-skills-official - SkillHub 頁面：https://www.skillhub.cn/skills/user_0b9d349a/weread-skills-official
- 版本：SkillHub 展示爲 v1.0.0；Skill 包內
SKILL.md會聲明更高版本號，調用接口時 body 中的skill_version須與已安裝 Skill 文檔一致。 - 來源：SkillHub 標記爲 community，發佈者
user_0b9d349a；能力說明與騰訊 WeChatReading 倉庫中的skills/SKILL.md同源（簡介、網關地址、能力表一致）。 - 分類：life-service；標籤含
requires_api_key=true，使用前需配置微信讀書 API Key。
核心功能¶
以下能力與 SkillHub 簡介及 SKILL.md「支持的能力」表一致，Agent 按意圖選用對應說明文件（如 search.md、shelf.md、notes.md 等）再發起網關請求。
| 能力 | 說明 |
|---|---|
| 搜索書籍 | 書城搜索，可按用戶意圖搜書名等 |
| 書籍信息 | 詳情、章節目錄、閱讀進度 |
| 書架管理 | 查看書架（含電子書、有聲書等條目規則見 Skill 文檔） |
| 筆記劃線 | 個人筆記、劃線、想法/書籤；章節熱門劃線 |
| 閱讀統計 | 閱讀時長、天數、偏好與統計摘要 |
| 書籍點評 | 瀏覽書籍公開點評 |
| 推薦好書 | 個性化或相似推薦 |
接口統一入口：
POST https://i.weread.qq.com/api/agent/gateway
鑑權：Authorization: Bearer $WEREAD_API_KEY，Key 格式爲 wrk-xxxxxxxx，綁定微信讀書用戶身份；需要用戶身份的接口由服務端注入，無需在參數裏手寫 vid。
安裝與啓用¶
通過 SkillHub 安裝（推薦與上架頁一致）¶
SkillHub 安裝說明見 https://skillhub.cn/install/skillhub.md。先確認本機是否有 skillhub CLI；沒有則按該文檔用官方安裝腳本安裝。安裝 Skill 時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/ 且 Agent 可能無法加載。
command -v skillhub && skillhub --version
skillhub install user_0b9d349a/weread-skills-official --dir <你的 Agent skills 目錄>
常見 skills 目錄（摘自 SkillHub 安裝文檔）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下.agents/skills/
也可將下面提示詞交給 Agent，讓其按 skillhub.md 完成安裝：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_0b9d349a/weread-skills-official`。
從騰訊倉庫安裝（可選）¶
騰訊 WeChatReading 倉庫 README 提供的另一條安裝方式：
npx skills add Tencent/WeChatReading -g
若你主要從 SkillHub 獲取該 Skill，以座標 user_0b9d349a/weread-skills-official 爲準；兩種方式裝好後都需完成下一節 API Key 配置。
配置 API Key¶
- 在 https://weread.qq.com/r/weread-skills 獲取個人 API Key。
- 設置環境變量：
export WEREAD_API_KEY=wrk-xxxxxxxx
未設置時，Skill 會提示用戶先導出該變量。Key 與賬號綁定，勿提交到倉庫或日誌。
典型用法¶
自然語言（安裝並配置 Key 之後）¶
與 Agent 對話即可，倉庫 README 中的示例如下：
幫我搜一下三體
看看我的書架
我這個月讀了多久
導出我在這本書裏的劃線
給我推薦幾本書
這本書有什麼熱門劃線
三體有什麼點評
Agent 加載 Skill 後，會根據意圖選擇 api_name 並調用網關；用戶只給書名時，通常先 /store/search 解析 bookId 再執行後續接口（見 Skill 通用規則）。
直接調用網關（覈對連通性）¶
請求爲 JSON，api_name 與業務參數與 skill_version 平鋪在 body 頂層，不要包在 params 內：
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.5"}'
skill_version 請改爲當前已安裝 SKILL.md 頂部 version 字段的值。回包 errcode 非 0 表示錯誤；可發送 {"api_name": "/_list"} 查看可用接口列表。若回包含 upgrade_info，須按指引升級 Skill 後再繼續。
適用場景與注意¶
適合誰
- 已在微信讀書長期沉澱書架、劃線與閱讀時長，希望用 Cursor / Claude Code 等 Agent 做檢索、彙總、選書，而不反覆開 App 抄數據。
- 願意自行申請並保管
WEREAD_API_KEY的開發者或個人用戶。
限制與注意
- 依賴微信讀書 Agent API Gateway 與有效 API Key；SkillHub 側爲 community 分發，版本號以你本地安裝的
SKILL.md爲準，與 SkillHub 頁展示的 v1.0.0 可能不一致，以網關要求的skill_version爲準。 - 所有個人數據請求經你的 Key 鑑權，僅在可信環境中配置環境變量。
- Skill 對展示格式、分頁參數、書架計數等有詳細約束（如時間戳轉日期、閱讀時長單位秒等），Agent 應遵循
SKILL.md與分能力說明文件，避免誤讀字段。
SkillHub 當前展示評分 100000、下載約 46707 次（以頁面統計爲準），可作爲選 Skill 時的參考，不代表接口 SLA。
結尾¶
「微信讀書官方Skills」把微信讀書賬號內的搜索、書架、筆記、統計、點評與推薦收斂到一套 Agent Skill 與統一網關之上，適合把閱讀數據接進日常 AI 工作流。安裝與詳情見 SkillHub：https://www.skillhub.cn/skills/user_0b9d349a/weread-skills-official ，API 入口說明亦見 https://api.skillhub.cn/user_0b9d349a/weread-skills-official 。
