优惠券一键采集

如果你只想要 最简单的“输入（如何调用）”和“输出（能拿到什么）”，直接针对3个核心接口，按“调用方式+返回结果示例”的极简格式写即可，不用额外复杂配置。以下是每个接口的输入输出内容，直接复制就能用：

一、接口1：获取MCP元信息（/.well-known/ai-plugin.json）

输入（怎么调用）

• 请求方法：GET（无需点任何按钮，直接访问地址就行）
• 请求地址：https://mcpcounpon.onrender.com/.well-known/ai-plugin.json
  （直接在浏览器地址栏粘贴、或用Postman/curl打开这个地址）
• 额外输入：无（不用填参数、不用传密码，直接访问）

输出（会拿到什么）

返回 JSON格式的MCP服务基本信息，示例（实际内容以接口返回为准）：

{
  "schema_version": "v1",
  "name_for_human": "优惠券一键采集",
  "name_for_model": "mcpcoupon",
  "description_for_human": "一键获取外卖、打车、购票的最新优惠券列表",
  "description_for_model": "提供公共优惠列表查询接口，返回JSON格式的优惠券数据",
  "api": {
    "type": "openapi",
    "url": "https://mcpcounpon.onrender.com/openapi.yaml"  // 关联的OpenAPI文档地址
  },
  "logo_url": "https://mcpcounpon.onrender.com/logo.png"  // 服务图标（若有）
}

二、接口2：获取OpenAPI规格（/openapi.yaml）

输入（怎么调用）

• 请求方法：GET
• 请求地址：https://mcpcounpon.onrender.com/openapi.yaml
  （同样直接粘贴到浏览器/工具访问）
• 额外输入：无

输出（会拿到什么）

返回 YAML格式的接口说明文档（告诉别人所有接口的规则），示例：

openapi: 3.0.0
info:
  title: 优惠券一键采集API
  version: 1.0.0
paths:
  /api/mcp/jutuike/public_promo_list:
    get:
      summary: 获取公共优惠列表
      responses:
        '200':
          description: 成功返回优惠券列表
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    promo_id: { type: string, description: 优惠券ID }
                    title: { type: string, description: 优惠券标题 }
  /api/mcp/jutuike/get_promo:
    get:
      summary: 获取单个优惠券详情
      parameters:
        - name: actId
          in: query
          required: true
          schema: { type: string, description: 优惠券活动ID }

三、接口3：获取公共优惠列表（/api/mcp/jutuike/public_promo_list）

输入（怎么调用）

• 请求方法：GET
• 请求地址：https://mcpcounpon.onrender.com/api/mcp/jutuike/public_promo_list
  （核心接口，直接访问拿优惠券数据）
• 额外输入：无（不用传任何参数，直接返回所有公共优惠）

输出（会拿到什么）

返回 JSON格式的优惠券列表（最实用的结果），示例：

[
  {
    "promo_id": "wm12345",
    "title": "外卖满30减8元",
    "type": "外卖优惠",
    "discount": "满30减8",
    "start_time": "2025-10-24 00:00:00",
    "end_time": "2025-10-31 23:59:59",
    "url": "https://xxx.com/coupon/wm12345",  // 领券链接
    "platform": "美团外卖"
  },
  {
    "promo_id": "dc67890",
    "title": "打车首单立减10元",
    "type": "打车优惠",
    "discount": "首单减10",
    "start_time": "2025-10-24 00:00:00",
    "end_time": "2025-11-05 23:59:59",
    "url": "https://xxx.com/coupon/dc67890",
    "platform": "滴滴出行"
  }
]

通用注意点（极简版）

1. 所有接口 不用登录/输密码（无需鉴权），直接访问地址就有结果；
2. 输入只有“访问地址”，没有其他复杂操作；
3. 输出要么是JSON（元信息、优惠券），要么是YAML（接口说明），直接复制就能用在前端/客户端。