用途:这是驱动 boardgamegeek-pp-cli 二进制的技能,用于只读查询 BoardGameGeek 官方 XMLAPI2(https://boardgamegeek.com/xmlapi2)数据库,覆盖桌游、RPG 与电子游戏。客户端把 XML 归一化为 JSON,便于 --json/--select 与 MCP 工具使用。
主要能力:searches 全文搜索;thing 查询游戏/扩展/配件完整详情(含统计与排名);hot 实时热度榜;user 公开资料;collection 用户收藏(可按 own、rated、played、wishlist、want、trade 等 0/1 状态过滤);plays 游玩记录;family 系列/主题分组;guild 公会及成员。仅只读,无写入或变更端点。
安装与验证:npx -y @mvanhorn/printing-press-library install boardgamegeek --cli-only;验证 boardgamegeek-pp-cli --version。若 npx 失败,可用 Go 1.26.6+ 直接安装:go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/boardgamegeek/cmd/boardgamegeek-pp-cli@latest。需确保安装目录在 $PATH。
授权:自 2025-07-02 起 BGG 要求注册应用并在每个请求带 Authorization: Bearer 头(在 https://boardgamegeek.com/applications 注册并创建令牌)。可用 boardgamegeek-pp-cli auth setup 获取步骤,再 auth set-token YOUR_TOKEN_HERE,或设置 BGG_TOKEN 环境变量;用 doctor 验证。
用法:任意命令加 --agent(等价 --json --compact --no-input --no-color --yes)。可用 --select 裁剪字段,--dry-run 预览,--deliver 输出到 stdout、file:<path> 或 webhook:<url>。输出包裹在 meta/results 信封中,解析 .results 取数据、.meta.source 判断实时或本地。可用 which "<能力描述>" 查找命令。
限制:仅只读,不得用于创建、更新、删除、发布、评论、点赞、邀请、下单、发消息等变更操作。collection 等大查询首次可能返回 HTTP 202 排队提示,需重试。退出码 0 成功、2 用法错误、3 未找到、4 需认证、5 API 错误、7 限流、10 配置错误。MCP 安装:go install .../boardgamegeek-pp-mcp@latest,再 claude mcp add boardgamegeek-pp-mcp -- boardgamegeek-pp-mcp。