verychic-mcp 是一个非官方的、只读的 MCP(Model Context Protocol)服务器,用于访问 VeryChic 的限时特卖酒店优惠。它让用户可以从任何支持 MCP 的客户端中查找、筛选和查询 VeryChic 酒店优惠的价格与可用性。
用途 该服务器面向个人、低频率的浏览需求,帮助用户在 AI 助手中直接浏览 VeryChic 当前的限时特卖优惠,并按条件筛选和查看价格。它只搜索和读取优惠信息,不会预订、不会登录,也不使用任何凭据。
主要能力
- 浏览当前 VeryChic 限时特卖优惠。
- 按目的地、国家、价格、折扣、星级、航班、主题或距离进行筛选,并可对结果排序。
- 读取某个优惠的详细内容,对于酒店类优惠还可查看逐日可用性和价格。
- 支持按月份查询价格,例如传入 months: ["02/2027", "03/2027"] 可查看默认窗口之外的价格。
- 提供 availabilities_by_month,每月一行显示库存,便于在较宽的月份窗口内低成本读取。
工具
- verychic_search_offers:返回匹配所有传入筛选条件的优惠(筛选条件以 AND 组合)。
- verychic_offer_details:返回单个优惠的完整内容,对于酒店还会返回逐日可用性和价格。
使用方式 将服务器添加到 MCP 客户端配置中。安装 uv 后无需克隆或安装任何内容,即可通过 uvx 运行。该服务器通过 stdio 运行,适用于 Claude Desktop 和 Claude Code 等本地客户端。相同的命令/参数组合适用于所有 stdio 客户端,只是外层配置不同。
对于 claude.ai 或 Cowork 等云客户端,它们只能通过 HTTPS 连接远程 MCP 服务器,无法连接本地进程。此时需要自行以 streamable-http 模式托管(verychic-mcp --transport streamable-http,置于 HTTPS 之后),并作为自定义连接器添加,粘贴带有 /mcp 路径的部署 URL。官方也提供了一个公共实例 https://verychic-mcp.fly.dev/mcp 供快速试用,但该实例为尽力而为,可能随时暂停或限流;超出快速试用范围时建议自行运行实例。
示例提问
- “浏览当前 VeryChic 优惠。”
- “搜索西班牙 600 欧元以下的 VeryChic 优惠。”
- “查找至少 40% 折扣的五星级水疗酒店,按价格从低到高排序。”
- “显示巴黎(48.8566, 2.3522)300 公里内的 VeryChic 优惠,按距离从近到远排序。”
- “获取 ORCHESTRA 酒店优惠 44983 的详细信息和带日期的价格。”
- “这家酒店 2027 年 2 月和 3 月多少钱?”
- “这家酒店哪个月最便宜?”
- “获取 ORCHESTRA_TO 套餐优惠 301375 的详细信息。”
数据模型 优惠带有 source(酒店为 ORCHESTRA,套餐为 ORCHESTRA_TO)和 external_id,两者都由 verychic_search_offers 返回,助手可自行将其传给 verychic_offer_details。verychic_search_offers 的结果是优惠对象列表。verychic_offer_details 额外返回 gallery、included_added_values、cheapest_price、住客评分、按月价格汇总,以及酒店的逐日可用性。
技术实现 VeryChic 网页应用与 https://api.verychic.com/verychic-endpoints/v1(以及 search.verychic.com)下的公共 JSON API 通信。该服务器使用类似浏览器的 TLS 指纹(curl_cffi)重放这些调用,将响应解析为类型化对象,并作为 MCP 工具暴露。所有操作无需登录。唯一易变的请求参数 channelVersion 在启动时从实时站点读取,读取失败时回退到已知值。
发布方式 发布由标签驱动。推送 vX.Y.Z 标签会运行测试、构建包,并通过 GitHub Actions 使用可信发布发布到 PyPI,因此不存储任何令牌。
适用场景 适合个人用户在 AI 助手中快速浏览和比较 VeryChic 酒店优惠,例如按预算、目的地、星级或折扣筛选,并查看特定日期的价格。
限制与免责声明
- 该工具与 VeryChic 或 VeryChic SAS 无关联、未获其认可,也不存在任何联系。它是一个独立的社区工具,仅供个人使用,以浏览器的方式读取 VeryChic 的公共 Web API。
- 用户需自行遵守 VeryChic 的销售条款,尤其是关于知识产权的第 9 条和数据库制作者的独特权利。
- 使用风险自负,仅限个人和低频率浏览。不得用于批量提取或再分发 VeryChic 的数据。
- 内置保守的请求频率限制(请求间隔至少 1 秒)。
- 公共实例为尽力而为,可能随时暂停或限流。
- 该工具不会出现在 Anthropic 官方连接器目录中,该目录保留给通过审核的合作伙伴集成。
- 套餐类优惠(ORCHESTRA_TO)将航班与酒店捆绑,不提供逐日价格;此时 availabilities_supported 设为 false,空的 availabilities 表示“该优惠类型不支持”,而非“没有可用日期”。
许可证 MIT,详见 LICENSE。