SuperAPI AI 工具集

weread-skills

通用与其它

查看项目

更新于 10-16 09:44

技能介绍

用途:为智能体提供微信读书相关能力,包括在书城搜索书籍、查看书籍详情/章节目录/阅读进度、查看书架、阅读统计(时长、天数、偏好)、个人笔记与划线(划线、想法/点评、书签数量)、书籍或章节热门划线及划线下的想法、书籍公开点评,以及个性化推荐与相似推荐。

主要能力对应说明文件:搜索 search.md,书籍信息 book.md,书架 shelf.md,阅读统计 readdata.md,笔记与热门划线 notes.md,书籍点评 review.md,推荐 discover.md。调用前需先阅读对应说明文件,确认参数、字段含义、单位与计数口径。

使用方式:统一入口 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。示例: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"}'。发送 {"api_name": "/_list"} 可查看全部可用接口及参数定义。

关键规则:不可把业务参数包在 params/data/body 中,否则分页会失效;回包 errcode 非 0 表示错误,需给出中文提示;回包若含 upgrade_info 必须按 message 指引升级后再继续;用户输入书名时先调 /store/search 获取 bookId;书架数量按 books.length + albums.length + (mp 非空 ? 1 : 0) 计算;时间戳转为 YYYY-MM-DD,阅读时长由秒转为“X小时Y分钟”;展示书籍等内容时使用回包 readerLink 作为 打开阅读,无 readerLink 但有 deepLink 时用 查看详情,两者都无不要自行拼接链接。

限制:具体接口参数、字段与回包结构以对应说明文件为准;资料未提供收费方式、价格、平台范围等信息。