服务与工具
微信读书
微信读书个人书架、笔记划线、阅读统计、书城搜索与推荐（需扫码获取 wrk- API Key；skill_version=1.0.4）
16 个可用工具
store_
书城搜索。必须显式传 scope：找书=10，泛搜=0，网文=16，听书/专辑=14，作者=6，全文=12，书单=13，公众号=2，文章=4。 回包 results[].scope 可能不等于请求 scope（电子书分组常为 17）。 Search the WeRead store. Always send scope; do not wrap args in params. If the gat…
book_
书籍基本信息：书名、作者、评分、简介、ISBN 等。Book details by bookId. If the gateway returns upgrade_info, treat it as an error and follow upgrade_info.message.
shelf_
同步个人书架。总数=books.length+albums.length+(mp 非空?1:0)；albums 是有声书/专辑，必须计入。 Sync personal shelf. Count albums and a non-empty mp entry as shelf items. If the gateway returns upgrade_info, treat it as an err…
user_
有笔记的书概览。分页只用 count+lastSort（上一页最后一条 sort），禁止 offset/limit，禁止包进 params。 单本笔记数=reviewCount+noteCount+bookmarkCount；noteCount 是划线数不是总数。 Notebook overview. Page with lastSort only. If the gateway returns …
book_
书籍热门划线（含原文与人数）。服务端固定前 20 条，不支持分页。 Popular highlights (text + count). Server returns top 20 only. If the gateway returns upgrade_info, treat it as an error and follow upgrade_info.message.
book_
单本书划线原文（已过滤书签 type=0）。不能导出书签内容。 Personal highlights for one book; bookmarks are counted elsewhere, not exported. If the gateway returns upgrade_info, treat it as an error and follow upgrade_info.messa…
book_
章节目录。chapterUid 供 underlines / bestbookmarks 使用。Chapter list for a book. If the gateway returns upgrade_info, treat it as an error and follow upgrade_info.message.
book_
阅读进度。book.progress 是 0-100 整数（1=1%，不是 100%）；时长单位秒。 Reading progress 0-100 integer percent; recordReadingTime is seconds. If the gateway returns upgrade_info, treat it as an error and follow upgrade_in…
book_
个性化「为你推荐」，与 App 首页一致。翻页用上一页最后一条 searchIdx 作 maxIdx。 Personalized recommendations (same as the WeRead home feed). If the gateway returns upgrade_info, treat it as an error and follow upgrade_info.messa…
review_
单本书个人想法与点评。参数名是 bookid（小写）。 Personal thoughts/reviews on a book. The official field is lowercase bookid. If the gateway returns upgrade_info, treat it as an error and follow upgrade_info.message.
book_
某条划线下的公开想法。reviews 是对象数组，这是官方允许的业务对象字段。 Public thoughts under highlight ranges. reviews is a top-level array field. If the gateway returns upgrade_info, treat it as an error and follow upgrade_info.me…
book_
相似书推荐。必须显式传 count 与 maxIdx（首次 12 和 0）；翻页带上 sessionId。 Similar books. count and maxIdx are required; first call count=12 maxIdx=0. If the gateway returns upgrade_info, treat it as an error and follow u…
book_
章节划线热度（人数/得分，无原文）。chapterUid 来自 book_chapterinfo。 Chapter underline heat stats without text. If the gateway returns upgrade_info, treat it as an error and follow upgrade_info.message.
readdata_
阅读统计。mode=weekly/monthly/annually/overall（默认 monthly）。 totalReadTime / readTimes 单位是秒，禁止当成分钟。 Reading stats. Durations are seconds. baseTime is a unix timestamp for a historical period. If the gateway…
review_
书籍公开点评（不是个人笔记）。reviewListType: 0全部 1推荐 2不行 3最新 4一般。 评分 20/40/60/80/100 = 1–5 星。Public book reviews, not personal notes. If the gateway returns upgrade_info, treat it as an error and follow upgrade_inf…
review_
单条想法详情（含评论/点赞）。Single review / thought detail. If the gateway returns upgrade_info, treat it as an error and follow upgrade_info.message.