Goodreads (Read + Write)

完整的Goodreads集成:读取书架、搜索书籍、通过RSS获取详情/评论,并通过Playwr执行操作(评分、加入书架、撰写评论、编辑日期、进度)。

安装

概览

什么是Goodreads (Read + Write)

Goodreads Skill 是一个功能完整的 Goodreads 集成工具,支持通过 RSS 订阅和 Playwright 浏览器自动化技术实现对用户书库的读写操作。该工具无需登录即可读取用户的书架信息、最近活动及书籍搜索数据;而涉及评分、添加至书架、撰写评论等操作时,则需通过一次性的浏览器登录建立持久会话。其核心设计兼顾了轻量访问与深度交互:读模式利用 RSS 流快速获取结构化数据,写模式则借助 stealth 反检测机制模拟真实用户行为,确保在 Goodreads 平台上的操作安全且稳定。所有输出均以 JSON 格式返回,便于开发者集成到自动化流程中。无论是追踪阅读进度、批量管理书单,还是自动记录读书心得,该工具都能提供高效、可靠的解决方案。

核心功能特点

  1. 支持读取用户书架(当前阅读、已读、想读)并返回书名、作者、ISBN、评分等详细信息
  2. 可通过关键词搜索书籍,获取书籍 ID、标题、作者及链接
  3. 能查看单本书籍的详情页内容,包括简介、出版信息、分类标签和封面图片
  4. 可检索某本书的公开评论列表(受限于 React 渲染机制,数量可能有限)
  5. 支持对书籍进行评分(1-5星)、切换书架状态(如标记为‘已读’或‘正在阅读’)
  6. 允许编辑阅读时间范围、更新个人评分、添加或修改书评内容
  7. 可更新阅读进度(按页数或百分比),适用于跟踪进行中书籍的状态

适用场景

对于热衷于电子书阅读并希望系统化管理个人书库的用户而言,Goodreads Skill 提供了极大的便利。例如,一位读者每天使用 Kindle 阅读,可在读完一本书后迅速通过命令行将其从‘正在阅读’移至‘已读’,并附上简短评语,整个过程无需打开网页界面即可完成。此外,它非常适合构建自动化阅读日志系统——比如每周自动生成‘本周读完’的书单报告,或根据阅读习惯推荐相似主题的书籍。对于图书管理员或读书社群运营者来说,该工具还可用于批量导入新书到‘想读’清单,或统计成员近期活跃度。另一个典型场景是学生群体:准备考试时快速查找相关领域的经典著作,获取内容简介和他人评价,辅助学习决策。由于所有操作均基于真实浏览器环境执行并通过 RSS 验证结果,因此既保证了数据的准确性,又避免了因频繁请求导致账号受限的风险。