SuperAPI AI 工具集

zergbnb-skill

通用与其它

查看项目

更新于 10-15 22:16

技能介绍

用途:通过命令行操作 zergbnb 短租平台,覆盖搜索住宿、行程报价、预订与取消、房东房源与生成房源文案、提交评价、支付管理。

主要能力与用法:

  • 配置:npm run cli -- profile set prod --base-url https://zergbnb.com --token-env ZERGBNB_TOKEN。profile 只存环境变量名,不存令牌;需认证的调用导出 ZERGBNB_TOKEN,公开命令无需凭据。
  • 搜索与报价:listings search(支持 --query/--city/--guests 或 --lat/--lng/--radiusKm)、listings get、listings quote(--slug、--checkIn、--checkOut、--adults)。报价的 guestTotalCents 是客人实付总额,清洁费已并入每晚房价,无结账时加价,向用户报告总额而非单晚价。
  • 预订:reservations book --quoteId <uuid>,价格锁定在报价上;reservations get ZB-7K3M2Q。报价 30 分钟过期,若返回 quote_expired 需重新报价。
  • 房东:properties create(含 --hostAccountId、--propertyType、--roomType、--maxGuests、--bedrooms、--beds、--bathroomsTenths、--city、--country、--latitude、--longitude)、properties extract-facts(对照片做视觉识别)、properties generate(依据证据生成文案)。generate 返回 verifierReport,若 status 为 needs_review,应读取 violations 并告知用户缺失的证据,而非代写文案。
  • 排名:ranking explain。
  • 标识符:接受 id 处可传 listing slug 或预订码 ZB-XXXXXX,无需先查 UUID。
  • 逃生通道:npm run cli -- api GET /api/some/route;api POST 用 -d key=value。路径必须以 / 开头,绝对 URL 被拒绝。
  • 诊断:doctor(配置状态,不打印令牌值)、health(存活与数据库)、help(完整资源目录,JSON)、help-exit-codes。

输出契约:成功打印 {"ok":true,"result":{...}} 到 stdout;失败打印 {"ok":false,"error":{...}} 到 stderr。按退出码分支:0 ok、2 usage、3 config、4 auth needed、5 forbidden、6 not found、7 rate limited、8 network、9 api error。

限制与护栏:房东不能写面向客人的文案,文案由已验证照片证据生成,API 会以 422 拒绝散文式描述,解决办法是上传更好照片并运行 properties generate。破坏性操作默认只做计划(reservations cancel、admin set-mode 会打印将执行的动作而不改动),需用户同意后加 --confirm-reviewed 重跑。不要在命令行传令牌,使用 --token-env。admin set-mode live 会真实扣款,需输入确认短语和近期登录,除非用户明确要求否则不要运行。

适用场景:需要以脚本或代理方式完成短租搜索、报价、预订、房东房源管理与文案生成的自动化流程。

暂未提供:具体收费、价格、支持平台范围等资料未说明。