SuperAPI AI 工具集

weread

通用与其它

查看项目

更新于 10-15 21:49

技能介绍

用途:通过 Agent API Gateway 调用微信读书接口,为智能体提供搜索书籍、书架管理、笔记划线、书评、阅读统计与推荐等能力。

主要能力:搜索书籍(书城搜索);书籍信息(详情、章节目录、阅读进度);书架管理(查看书架);阅读统计(时长、天数、偏好分析);笔记划线(划线、想法/点评、书签数量);章节热门划线(热度及划线下想法);书籍点评(公开点评);推荐好书(个性化/相似推荐)。

使用方式:统一入口 POST https://i.weread.qq.com/api/agent/gateway,Header 使用 Authorization: Bearer $WEREAD_API_KEY,API Key 格式 wrk-xxxxxxxx,从环境变量获取,未设置时提示 export WEREAD_API_KEY=<你的apikey>。请求为 POST、Content-Type: application/json,Body 中 api_name 指定接口,业务参数平铺在顶层,每次请求必须带 skill_version。发送 {"api_name": "/_list"} 可查看所有可用接口及参数定义。调用前需先阅读对应能力说明文件(如 readdata.md、shelf.md),bookId 需先经 /store/search 获取。

限制与规范:业务参数不得包在 params、data、body 等对象内,否则分页可能失效;errcode 非 0 表示错误;回包字段经裁剪,字段含义以说明文件为准,不得直接翻译字段名;时间戳需转为 YYYY-MM-DD,阅读时长单位为秒需转为小时分钟;书架数量按 books.length + albums.length + (mp 非空 ? 1 : 0) 计算;若回包出现 upgrade_info 须按指引升级后重试。展示内容时可拼接 weread:// 深度链接跳转 App。具体接口参数、字段与工作流详见各说明文件。