SuperAPI AI 工具集

verychic-mcp

verychic-mcp 是一个非官方的只读 MCP 服务器,用于访问 VeryChic 限时特卖酒店优惠。它支持从任意 MCP 客户端搜索和筛选优惠(按目的地、国家、价格、折扣、星级、航班、主题或距离),并可查看指定日期的可用性和价格。该工具只读、匿名、无需账号,内置保守的请求频率限制(请求间隔至少 1 秒),不会预订或登录。

访问官网

工具介绍

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。