用途:pp-goodreads 通过 goodreads-pp-cli 二进制驱动 Goodreads 的读写操作,并为智能体提供 MCP 接口(goodreads-pp-mcp)。主要能力:读取首页动态、好友与请求、书籍详情、评论、Kindle 笔记与高亮、通知、推荐、赠书、书架、话题、用户资料等;写入方面支持评分(rating set/clear,走 AppSync GraphQL 的 RateBook/UnrateBook)、评论(review create,legacy 表单)、书架增删与调整(shelf create 等)。
使用方式:先安装 CLI,npx -y @mvanhorn/printing-press-library install goodreads --cli-only,验证 goodreads-pp-cli --version;失败时可用 go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/goodreads/cmd/goodreads-pp-cli@latest(需 Go 1.26.6+)。MCP 默认 stdio,可 goodreads-pp-mcp --transport http --addr :7777,注册用 claude mcp add goodreads-pp-mcp -- goodreads-pp-mcp。命令统一支持 --agent(等价 --json --compact --no-input --no-color --yes)、--dry-run 预览,输出为 {meta, results} 信封。
认证:读取与 legacy 表单写入使用 GOODREADS_GOODREADS_COOKIE_SESSION(_session_id2);评分写入另需 GOODREADS_GRAPHQL_TOKEN(绑定 AppSync JWT);表单写入需 GOODREADS_AUTHENTICITY_TOKEN 提供 Rails CSRF。
限制:写操作默认被阻止,须设置 GOODREADS_PP_ALLOW_WRITES=1 并获批准后执行;赠书报名尚未上线(live 执行被拒,仅 --dry-run 预览);MCP 的原始端点镜像需 GOODREADS_MCP_ENDPOINT_MIRRORS=1 开启。反馈默认仅本地存储,除非显式配置端点与发送。资料未提供定价、平台支持范围等细节。