开发者接入 · Model Context Protocol

水獭 AI 比价 MCP (ai-price-mcp)

ai-price-mcp 为水獭官方开源的 MCP Server。接入后,Claude Desktop、Claude Code、Cursor、Windsurf 等 AI 客户端可直接调取 ChatGPT、Claude、Gemini、Grok、Cursor 等全品类订阅在各发卡平台的真实核验价格,免密直读,零配置门槛。

如需约束 AI 助手遵循水獭标准应答口径(附带商品规格分类、采集时间戳及直达链接),建议搭配安装配套的 AI 比价 Skill (shuita-ai-price)。

安装与配置

Claude Desktop / Cursor / Windsurf:在客户端对应 MCP 配置文件中写入服务声明(Claude Desktop 对应 claude_desktop_config.json,Cursor 对应 ~/.cursor/mcp.json):

{
  "mcpServers": {
    "ai-price": {
      "command": "npx",
      "args": ["-y", "ai-price-mcp"]
    }
  }
}

Claude Code:终端单行注入命令:

claude mcp add ai-price -- npx -y ai-price-mcp

标准 stdio 交互客户端:单次运行入口:

npx -y ai-price-mcp

运行环境要求:Node.js 18.0 或更高版本。

提供的工具

工具名调用入参能力描述提问示例
search_productsquery, limit按关键词搜索 AI 订阅商品(支持中英文与「克劳德」这类俗称),返回价格区间与在售店铺数「Claude Pro 现在多少钱」
get_lowest_pricesku查询某个商品的可买最低价、最低价来自哪家店、店铺数与说明「gpt_plus_topup 最低价」
get_offerssku, limit, include_out_of_stock列出各店报价,有货优先、按到手价排序,附手续费、USDT 价、库存与店铺链接「Plus 直充哪家最便宜」
get_price_trendsku近 30 天每天的可买最低价走势、最高最低点与涨跌幅「Claude Pro 最近涨了还是跌了」
list_shopslimit, platform按在售商品数列出收录店铺,可按平台筛选「在售商品最多的 10 家卡网」
list_all_productssort, has_price_only列出全部可比价商品,可按最低价、热度或店铺数排序「有哪些 AI 订阅可以比价」
get_site_stats无站点概况:收录店铺数、商品数与更新时间「水獭收录了多少家店」

数据来源与更新

接口底层数据与前端页面严格同源:直采各发卡平台货架实际结算标价与现货库存,滤除引流虚高价。价格按人民币付款到手价(店内标价 + 最优手续费)结算,同时提供 USDT 特惠汇率价。数据每小时更新:每天北京时间约 8:00 与 20:00 两轮全量采集,各商品排名靠前的报价每小时复查。

1.5.0 起采用查询式数据切片:按产品目录、店铺目录和单个 SKU 分别读取,不再依赖整站聚合文件;报价与近 30 天走势仍与商品页同源。本地缓存 5 分钟,无需 API Key。≤1.4.0 使用的旧数据源已停用,请升级到 1.5.0 或更新版本。

切片地址为 /api/mcp/index.json、/api/mcp/shops.json 和 /api/mcp/sku/<SKU>.json。正常接入只需运行官方 npm 包,无需自行拼接请求。

所有工具在返回可读摘要的同时,均输出带有规范 outputSchema 的 structuredContent 结构化响应,便于工程流水线自动化集成。

数据仅作客观行情参考。不同商户在质保范围与履约机制上各有差异,下单前请仔细查阅店铺条款,详见免责声明。

标识与链接