接入文档

灵策 CPS 开放平台把淘宝、京东、拼多多、唯品会、美团的领券下单能力，封装成一个 MCP 服务和一组 REST 接口。 你的智能体调用它，就能给用户返回带优惠券、可直接下单的链接；用户下单后，佣金按单归到你名下。

快速开始

1. 用灵策账号登录 控制台，首次登录自动开通开发者身份。
2. 在「API 密钥」页新建一把密钥，完整密钥只显示这一次，请立即保存。
3. 在「接入模板」页选择你的智能体平台，复制已填好密钥的配置，粘贴进去。
4. 对智能体说一句「帮我找个 300 以内的保温杯」，它会返回带券链接——接通了。

鉴权与密钥

所有调用都要带开发者密钥（以 sk- 开头），二选一：

Authorization: Bearer sk-你的密钥
# 或
X-Lynxce-API-Key: sk-你的密钥

密钥只能调用 CPS 能力：调不了模型、访问不了你的灵策账号数据，也提不了现（提现必须登录控制台操作）。 每个账号最多保留 10 把有效密钥，建议每个智能体平台单独用一把，泄露时只停那一把。

MCP 接入

服务地址（Streamable HTTP，无状态）：

https://api.lynxce.cn/api/mcp/cps

支持自定义请求头的平台（Dify、Cursor、Claude Desktop、自研 Agent 框架等），把密钥放在请求头里：

{
  "mcpServers": {
    "lynxce-cps": {
      "type": "streamableHttp",
      "url": "https://api.lynxce.cn/api/mcp/cps",
      "headers": { "Authorization": "Bearer sk-你的密钥" }
    }
  }
}

只能填一个 URL、不支持自定义请求头的平台，把密钥放进路径：

https://api.lynxce.cn/api/mcp/cps/k/sk-你的密钥

可用工具

REST 接口

基础地址 https://api.lynxce.cn/api/cps/v1，请求体都是 JSON，返回统一为 { "code": 0, "data": ... }。

curl https://api.lynxce.cn/api/cps/v1/products/search \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"降噪耳机","platforms":["jd","pdd"],"limit_per_platform":3}'

链接字段在 data.items[].link；个别条目没带链接时，用它的 material 调 /products/link 补一次。

归因与子标识

一单算谁的，由我们在服务端按密钥认定，写进链接的归因标识形如 dv_你的开发者码。 调用时传的 sub_tag（MCP 里是 user_tag）只会作为子标识拼在后面， 形如 dv_你的开发者码_子标识，方便你区分自己的用户或会话——它决定不了归属。

子标识只保留字母、数字和连字符，总长超过 30 个字符会被截断。京东、唯品会、美团会原样回传子标识；拼多多只认备案的那一个，子标识在拼多多上不生效。

额度与错误

每个开发者默认每天 500 次调用（按北京时间零点重置），控制台概览页可以看到今天用了多少。

MCP 调用超额时不会报错，而是返回一段说明文字，智能体会如实告诉用户，不会编造链接。

分佣规则

• 你分到的金额 = 平台佣金 × (1 − 聚合通道服务费) × 分成比例（默认 70%），向下取整到分。
• 用户付款后订单进入「待结算」；平台结算时按实际佣金补差；结算后再观察 15 天转为「可提现」。
• 订单失效（退款、取消）会自动扣回：还在待结算的从待结算扣，已转可提现的从可提现扣。
• 分成比例以订单入账那一刻为准，之后调整比例不影响已入账的订单。
• 可提现满 100 元可申请提现，首次提现完成实名，运营审核后按月打款。

各平台说明