用途:这是驱动 booksy-pp-cli 二进制的技能,面向 Booksy 波兰市场(pl.booksy.com)的顾客侧,用于在终端或智能体中搜索理发店/沙龙、比较价格与评分、查询空闲时段并预约。不适用于 Booksy Biz 商家端管理、批量爬取全部商家,也不适用于波兰以外地区。
安装与验证:先安装 CLI,可用 npx -y @mvanhorn/printing-press-library install booksy --cli-only;若失败可回退到 Go 安装(需 Go 1.26.6 或更新):go install github.com/mvanhorn/printing-press-library/library/commerce/booksy/cmd/booksy-pp-cli@latest。安装后用 booksy-pp-cli --version 验证,并确保安装目录在 $PATH 中。
主要能力:businesses 搜索与查看商家资料、评价;discover 解析城市/地点、查询建议与热门项目;availability 按日期范围列出某服务的可约时段;services 列出可预约服务及价格、时长与 service-variant id;earliest 找最早可约时段;compare 对比多个商家的评分、评价数与最低匹配服务价格;cheapest 按城市搜索并按最低匹配服务价格排序;book 端到端预约,默认只预览服务、人员、时间与价格,加 --confirm 才真正提交。me 命令需 BOOKSY_ACCESS_TOKEN,可查看账户主页与资料。
使用方式:公开命令(搜索、商家、评价、建议)无需登录。认证操作需从 booksy.com 的 x-access-token 请求头取值,通过 booksy-pp-cli auth set-token <token> 或 BOOKSY_ACCESS_TOKEN 环境变量设置。任意命令可加 --agent,展开为 --json --compact --no-input --no-color,支持 --select 裁剪字段、--dry-run 预览请求。可用 booksy-pp-cli which "<能力描述>" 查找命令,用 doctor 检查配置。
限制:仅面向波兰市场与顾客侧;不用于创建、更新、删除等变更请求(预约提交除外);不用于批量抓取。路径可通过 --home 或 BOOKSY_HOME 等环境变量重定位。资料未提供具体收费、价格或效果信息。