📦 Hostex — 民宿API管理

Name: Hostex — 民宿API管理
Rating: 1

v0.1.1

通过 Hostex OpenAPI v3.0 查询并管理度假租赁房源、房型、预订、可用日历、宾客消息、评价与 webhook，默认只读，写操作需显式确认。

1· 1.7k·0 当前·0 累计

by @ansonfreeman (Anson)·MIT-0

API工具自动化云服务数据处理工作流

下载技能包

License

MIT-0

最后更新

2026/2/28

安全扫描

VirusTotal

无害

查看报告

OpenClaw

可疑

high confidence

技能代码与指令符合 Hostex API 客户端，但注册元数据缺少必要环境变量（HOSTEX_ACCESS_TOKEN、HOSTEX_ALLOW_WRITES、HOSTEX_BASE_URL）且来源/主页未知——提供凭据或启用写入前请验证。

评估建议

该包看似直接的 Hostex API 客户端（默认只读，写操作需 HOSTEX_ALLOW_WRITES=true 且 --confirm）。但：1）注册元数据声称无需凭据，而 SKILL.md 与脚本却需要 HOSTEX_ACCESS_TOKEN（及可选的 HOSTEX_ALLOW_WRITES 与 HOSTEX_BASE_URL）——视为红旗，提供凭据前请验证发布者；2）优先使用只读 Hostex PAT；3）运行内置脚本时请在隔离环境执行并检查日志（代码会打码令牌，但错误对象可能泄露片段）；4）启用 HOSTEX_ALLOW_WRITES 将授予修改权限——需分阶段测试并手动确认；5）验证 hostex.io 及未知技能来源（无主页），避免把凭据交给恶意或误植域名。若需更高保障，请要求发布者修正注册元数据，声明 HOSTEX_ACCESS_TOKEN 为主要凭据并提供可验证的来源/主页。...

详细分析 ▾

ℹ 用途与能力

名称/描述、OpenAPI 文件与脚本一致实现 Hostex API 客户端（读取与受控写入）。但注册元数据未列出所需凭据，而 SKILL.md 与脚本需 HOSTEX_ACCESS_TOKEN（及可选的 HOSTEX_ALLOW_WRITES/HOSTEX_BASE_URL）。该元数据不匹配属异常。

✓ 指令范围

SKILL.md 与脚本仅操作 Hostex API 与本地 OpenAPI 缓存；写入受环境标志与显式 --confirm 流程限制。无读取无关文件或向第三方端点外泄数据的指令。

✓ 安装机制

无安装规范（仅指令）。脚本随包提供，无 URL 下载或第三方包装安装，安装机制风险低。

⚠ 凭证需求

技能合理需要 API 令牌（HOSTEX_ACCESS_TOKEN）及可选的 HOSTEX_ALLOW_WRITES 与 HOSTEX_BASE_URL，但注册元数据未声明所需环境变量或主凭据。请求 Hostex PAT 与所述目的相称，但元数据遗漏属不一致，应在授予凭据前解决。

✓ 持久化与权限

always 为 false，技能未请求自动持久权限或修改其他技能。openapi-sync 脚本在 skills/hostex/references 下写入本地 openapi.json 副本，属合理缓存但值得注意。

安全有层次，运行前请审查代码。

License

MIT-0

可自由使用、修改和再分发，无需署名。

查看条款 ↗

运行时依赖

无特殊依赖

版本

latestv0.1.12026/2/3

- 新增支持与文档，用于在一次请求中通过多日期/价格区间更新房源价格。 - 新增支持与示例，通过脚本接口更新房源可订状态（关闭/开启）。

● 无害

安装命令

点击复制

官方npx clawhub@latest install hostex

镜像加速npx clawhub@latest install hostex --registry https://cn.longxiaskill.com

技能文档

# Hostex API Skill (Node) ## 认证 (PAT) - 设置环境变量：HOSTEX_ACCESS_TOKEN - 请求使用请求头：Hostex-Access-Token: - OpenAPI 安全方案名称：HostexAccessToken 默认建议：使用只读 PAT。 ## 日期 / 时区 - 所有日期参数均为 YYYY-MM-DD - 以房源时区解释日期（不使用 UTC 时间戳） ## OpenAPI 权威来源稳定的 OpenAPI JSON： - https://hostex.io/open_api/v3/config.json 使用 scripts/openapi-sync.mjs 可将副本缓存到本地 references/openapi.json。 ## 快捷命令 (scripts) 所有脚本均依赖 HOSTEX_ACCESS_TOKEN。 ### 只读（安全）列出房源： ``bash node skills/hostex/scripts/hostex-read.mjs list-properties --limit 20 ` 列出预订（按入住日期范围）： `bash node skills/hostex/scripts/hostex-read.mjs list-reservations --start-check-in-date 2026-02-01 --end-check-in-date 2026-02-28 --limit 20 ` 列出预订（按预订编号）： `bash node skills/hostex/scripts/hostex-read.mjs list-reservations --reservation-code 0-1234567-abcdef ` 获取可订状态： `bash node skills/hostex/scripts/hostex-read.mjs get-availabilities --start 2026-02-10 --end 2026-02-20 --property-id 123 ` ### 写入（受控）写入操作默认禁用，除非： - HOSTEX_ALLOW_WRITES=true 且你显式传入 --confirm。发送消息： `bash HOSTEX_ALLOW_WRITES=true node skills/hostex/scripts/hostex-write.mjs send-message --conversation-id 123 --text "Hello!" --confirm ` 更新房源价格（单段日期示例）： `bash HOSTEX_ALLOW_WRITES=true node skills/hostex/scripts/hostex-write.mjs update-listing-prices \ --channel-type airbnb \ --listing-id 456 \ --start 2026-02-10 \ --end 2026-02-15 \ --price 199 \ --confirm ` 更新房源价格（一次请求多段日期）： `bash HOSTEX_ALLOW_WRITES=true node skills/hostex/scripts/hostex-write.mjs update-listing-prices \ --channel-type booking_site \ --listing-id 100541-10072 \ --prices "2026-02-03..2026-02-05:599,2026-02-06..2026-02-07:699,2026-02-08..2026-02-09:599" \ --confirm ` 创建预订（直订）（示例）： `bash HOSTEX_ALLOW_WRITES=true node skills/hostex/scripts/hostex-write.mjs create-reservation \ --property-id 123 \ --custom-channel-id 77 \ --check-in-date 2026-02-10 \ --check-out-date 2026-02-12 \ --guest-name "Alice" \ --currency USD \ --rate-amount 200 \ --commission-amount 0 \ --received-amount 200 \ --income-method-id 3 \ --confirm ` 更新房源可订状态（关房/开房）（示例）： `bash # 关房一段日期 HOSTEX_ALLOW_WRITES=true node skills/hostex/scripts/hostex-write.mjs update-availabilities \ --property-ids "11322075" \ --available false \ --start-date 2026-02-03 \ --end-date 2027-02-02 \ --confirm ` ## 操作保护（强制）执行任何写入操作时： 1) 总结变更（谁/什么/何时/金额）。 2) 要求用户显式确认（如输入 CONFIRM）。 3) 若支持，优先使用 --dry-run 预演。 ## 备注 - 分页：接口通常接受 offset + limit`（limit 最大 100）。 - 切勿在日志中打印 token；脚本会自动脱敏。

数据来源：ClawHub ↗ · 中文优化：龙虾技能库