用途:pp-metacritic 技能驱动 metacritic-pp-cli 二进制,读取 Metacritic(Fandom 旗下)未公开的内部 JSON API,覆盖游戏、电影、剧集三类媒体,以及搜索、筛选、标题详情和评论。音乐(专辑)走另一套查询形态,资料明确暂未纳入。
主要能力:composer <slug> 返回某标题的完整详情(Metascore、用户评分、摘要、发行数据);finder browse-titles 提供分页可排序的媒体标题列表,finder list-filters 返回该媒体的筛选维度(类型、平台、流媒体、产品类型),finder search-titles 为跨游戏、电影、剧集与人物全文搜索;reviews list-critic 与 reviews list-user 分别列出媒体与用户评论。标题详情、筛选、评论端点用 {mediaType}(games、movies、shows)选媒体,browse 端点用 mcoTypeId(1 剧集、2 电影、13 游戏)。不支持自然语言时可用 which "<能力描述>" 定位命令。
使用方式:先安装 CLI,npx -y @mvanhorn/printing-press-library install metacritic --cli-only,或回退 go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/metacritic/cmd/metacritic-pp-cli@latest(需 Go 1.26.6 以上),再用 metacritic-pp-cli --version 验证并确保安装目录在 PATH。鉴权执行 metacritic-pp-cli auth setup,然后 export METACRITIC_API_KEY="<your-key>",或写入 ~/.config/metacritic-pp-cli/config.toml,并用 doctor 校验。任意命令可加 --agent(等价 --json --compact --no-input --no-color --yes);--select 收敛字段,--dry-run 预览请求,--deliver 可路由 stdout、file:<path>、webhook:<url>。也可安装 MCP:go install .../cmd/metacritic-pp-mcp@latest,再 claude mcp add metacritic-pp-mcp -- metacritic-pp-mcp。
限制:只读,禁止用于创建、更新、删除、发布、评论、点赞、邀请、下单、发送等任何改变远端状态的操作。API Key 为站点前端共享的公开只读 key。读取与同步结果包在 meta/results 信封中,需解析 .results 与 .meta.source。退出码含义见资料(0 成功、2 用法错误、3 未找到、4 需鉴权、5 API 错误、7 限流、10 配置错误)。反馈默认仅存本地 ~/.local/share/metacritic-pp-cli/feedback.jsonl。