Verychic MCP

VeryChic MCP

通过任意 MCP 客户端查找、筛选并查询 VeryChic 酒店优惠价格

浏览当前限时特惠，按目的地、国家、价格、折扣、星级、航班、主题或邻近地点筛选（并对结果排序），然后查看优惠的日期可订情况和价格。只读、匿名，无需账户。

只读且匿名。 此服务只会搜索和读取优惠，不会预订、登录，也不使用任何凭据。客户端内置了较为保守的速率限制（请求间隔 ≥ 1 s）。使用条款请参阅免责声明。

演示

将托管的 VeryChic MCP 服务作为自定义连接器添加到 Claude Desktop，然后询问西班牙 600 欧元以下的优惠：

▶ 观看 MP4 视频

快速开始

将服务添加到 MCP 客户端配置中。安装 uv 后，无需克隆或安装：

{
  "mcpServers": {
    "verychic": {
      "command": "uvx",
      "args": ["verychic-mcp"]
    }
  }
}

此命令会通过 stdio 运行服务，Claude Desktop 和 Claude Code 均使用此方式。你也可以直接运行：

uvx verychic-mcp          # stdio (default)
uvx verychic-mcp --help   # all options

相同的 command/args 键值对适用于所有 stdio 客户端；区别仅在于外层配置。以下配置适用于本地客户端（stdio）。对于 claude.ai 或 Cowork 这类通过 HTTPS 连接的云端客户端，请参阅在 Claude.ai 或 Cowork 中使用。

claude mcp add verychic -- uvx verychic-mcp

{
  "mcpServers": {
    "verychic": {
      "command": "uvx",
      "args": ["verychic-mcp"]
    }
  }
}

{
  "servers": {
    "verychic": {
      "command": "uvx",
      "args": ["verychic-mcp"]
    }
  }
}

{
  "mcpServers": {
    "verychic": {
      "command": "uvx",
      "args": ["verychic-mcp"]
    }
  }
}

工具

每次调用均为只读且匿名，客户端内置了较为保守的速率限制。

verychic_search_offers

返回符合你传入的所有筛选条件的优惠（筛选条件以 AND 组合）。

verychic_offer_details

返回一项优惠的完整内容；对于酒店，还会返回逐日可用情况和价格。

示例

可以向助手询问：

• “浏览当前的 VeryChic 优惠。”
• “搜索西班牙境内价格低于 600 欧元的 VeryChic 优惠。”
• “查找至少打 6 折、价格最低优先的五星级水疗酒店。”
• “显示巴黎（48.8566, 2.3522）300 公里范围内的 VeryChic 优惠，按距离从近到远排序。”
• “获取 ORCHESTRA 酒店优惠 44983 的详情和按日期列出的价格。”
• “这家酒店在 2027 年 2 月和 3 月的价格是多少？”助手会传入 months: ["02/2027", "03/2027"]，以查询默认时间范围之外的价格。
• “这家酒店哪个月最便宜？”availabilities_by_month 会直接给出答案—— 每月一行，包含库存信息，因此即使 months 时间范围较大，结果也易于查看。
• “获取 ORCHESTRA_TO 套餐优惠 301375 的详情。”旅游运营商套餐会将 航班与酒店捆绑，因此不会像单一酒店那样提供逐日价格。 工具仍会返回优惠内容和优势，并设置 availabilities_supported: false，这样空的 availabilities 表示“此类优惠不支持”，而不是“没有可订日期”。

优惠包含 source（酒店为 ORCHESTRA，套餐为 ORCHESTRA_TO）和 external_id。两者都会由 verychic_search_offers 返回，因此助手可以自行将它们 传给 verychic_offer_details。

verychic_search_offers 的结果是优惠对象列表（此处展示一项，内容已精简）：

{
  "source": "ORCHESTRA",
  "external_id": 36509,
  "name": "Sofitel New York ****",
  "destination": "New York, États-Unis",
  "country": "États-Unis",
  "price": 182,
  "currency": "EUR",
  "discount": 57.0,
  "sales_mode": "FLASH",
  "offer_end_date": "2026-06-24T23:55+0200",
  "image": "https://.../sofitel-new-york.jpg",
  "advantages": ["Petit-déjeuner inclus", "VeryFlexible : réservez en toute sérénité !"],
  "offer_url": "https://www.verychic.fr/p/36509/etats-unis-new-york-hotel-sofitel-new-york"
}

对于酒店，verychic_offer_details 会添加 gallery、included_added_values、cheapest_price、宾客评分、 按月汇总的价格，以及逐日的 availabilities：

{
  "offer": {
    "source": "ORCHESTRA", "external_id": 44983, "name": "Hotel Kaktus Playa *****",
    "rating": 8.5, "opinion_count": 67,
    "rating_location": 8.1, "rating_room": 9.2, "rating_service": 8.9,
    "rating_food": 9.1, "rating_public_area": 9.1,
    "...": "..."
  },
  "cheapest_price": 169,
  "availabilities_supported": true,
  "availabilities_by_month": [
    { "month": "06/2026", "min_price": 169, "currency": "EUR", "dates_available": 5 }
  ],
  "availabilities": [
    { "date": "20/06/2026", "price": 169, "currency": "EUR", "nights": 1, "days": 2 },
    { "date": "21/06/2026", "price": 169, "currency": "EUR", "nights": 1, "days": 2 }
  ]
}

在 Claude.ai 或 Cowork 中使用

与快速开始中的本地客户端不同，claude.ai 和 Cowork 等云端客户端只能通过 HTTPS 连接远程 MCP 服务，无法连接本地进程。若要在那里使用 VeryChic MCP，请以 streamable-http 模式自行托管 （verychic-mcp --transport streamable-http，并置于 HTTPS 后），然后将其添加为自定义连接器， 并粘贴带有 /mcp 路径的部署 URL。

为方便使用，我们部署了一个公共实例，地址为 https://verychic-mcp.fly.dev/mcp。将其添加为 claude.ai/Cowork 中的自定义连接器，或将其接入支持远程 MCP 的本地客户端：

{
  "mcpServers": {
    "verychic": {
      "url": "https://verychic-mcp.fly.dev/mcp"
    }
  }
}

该实例仅尽力维护，随时可能暂停或受到速率限制——除快速试用外，请使用上文的 uvx 命令运行自己的实例，或托管 streamable-http 模式。

列入 Anthropic 官方连接器目录（与 Booking 或 Tripadvisor 并列）不在计划范围内。该目录仅面向通过审核的合作伙伴集成，而此类工具无法通过此类审核。

工作原理

VeryChic Web 应用会调用一个公开的 JSON API，地址位于 https://api.verychic.com/verychic-endpoints/v1（以及 search.verychic.com）。此服务 会使用类似浏览器的 TLS 指纹（curl_cffi）重放相同的调用，将响应解析为类型化对象，并将其作为 MCP 工具提供。整个过程无需登录。唯一易变的请求参数 channelVersion 会在启动时从实时网站读取；若读取失败，则回退到已知值。

开发

git clone https://github.com/jordantete/verychic-mcp.git && cd verychic-mcp
pip install -e ".[dev]"
pytest                  # offline tests, run against recorded fixtures
pytest -m network       # optional smoke test against the live API, low volume
ruff check verychic_mcp tests

发布由标签驱动。推送 vX.Y.Z 标签后，会运行测试、构建软件包，并通过 GitHub Actions 使用可信发布将其发布到 PyPI，因此无需在任何地方存储令牌。

免责声明

VeryChic MCP 与 VeryChic 或 VeryChic SAS 无任何关联，也未获其认可或与其合作。 这是一个供个人使用的独立社区工具，它读取 VeryChic 的公开 Web API，方式与浏览器相同。您有责任遵守 VeryChic 的销售条款， 尤其是关于知识产权以及数据库制作者 sui generis 权利的第 9 条。 使用风险由您自行承担，且仅限个人和低频浏览。请勿批量提取或重新分发 VeryChic 的数据。

许可证

MIT。请参阅 LICENSE。