概览 · 接口文档 · SellerDexMCP

概览

统一通过 MCP 端点 https://mcp.sellerdexmcp.com/mcp 以 JSON-RPC 调用( tools/list 取工具清单、tools/call 执行工具),鉴权用请求头 secret-key;客户端配置步骤见接入方式。

调用方式

所有数据接口统一通过 MCP 端点 https://mcp.sellerdexmcp.com/mcp 提供(Streamable HTTP,JSON-RPC 2.0)。先用 tools/list 获取工具清单与各工具参数的 JSON Schema,再用 tools/call 执行具体工具。鉴权使用请求头 secret-key,密钥在用户中心「密钥管理」中创建;客户端(Codex、WorkBuddy 等)的配置步骤见「接入方式」页。

快速开始:查询剩余额度

下面的示例调用 user_quota 工具查询当前账号的剩余额度与速率限制,该工具免费、不扣减额度。

curl
curl --location 'https://mcp.sellerdexmcp.com/mcp' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json, text/event-stream' \
--header 'secret-key: 您的密钥' \
--data '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "user_quota",
    "arguments": {}
  }
}'

请求头

#参数说明
1Content-Typeapplication/json
2Acceptapplication/json, text/event-stream
3secret-key用户中心「密钥管理」中创建的密钥,形如 sk_live_xxx

返回结构

成功时,结果位于 result.structuredContent;result.content[0].text 是同一结构的 JSON 字符串,便于 Agent 直接读取。业务失败(如参数校验不通过)时 result.isError 为 true,此时没有 structuredContent,content[0].text 内为 {"code":"SERVICE_ERROR","message":"失败原因"}。协议层错误(工具名不存在、密钥无效等)直接返回顶层 error 对象。

json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"code\":\"OK\",\"message\":\"成功\",\"data\":{\"credits\":5000,\"rateLimitQpm\":50}}"
      }
    ],
    "structuredContent": {
      "code": "OK",
      "message": "成功",
      "data": { "credits": 5000, "rateLimitQpm": 50 }
    },
    "isError": false
  }
}

公共返回参数

#字段类型说明
1codeString业务状态码,OK 表示成功
2messageString提示信息
3dataObject业务数据,不同工具的结构见各自页面

参数类型均为 JSON 类型:String / Integer / Float / Boolean / List / Object。个别字段本身是 JSON 字符串(如 overviews、fbaItems),类型标注为 String 并在描述中注明;数组元素的对象字段以缩进表示层级。

协议层错误

#error.code说明
1-32602工具名不存在或请求方法不支持,例如 Unsupported tool: xxx
2-32000密钥无效、已禁用或缺少密钥

注意事项

同一查询条件,只支持获取TOP2K的数据,这是底层服务的限制,与WEB端限制一致,拉取数据时可以考虑按照排名、BSR、搜索量、销量等进行分段获取,来规避这个问题

可用次数查询

调用 user_quota 工具可获取当前剩余额度,已使用额度=累计获得额度-剩余额度。额度不按月结算,是一次性资源包,用完续购,未用完的部分一直有效,直至服务终止。并发每分钟 50 次,请勿频繁调用(注意:查询前每个模块需先请求 1 次进行初始化)。

各接口调用示例

左侧每个接口页面都给出了该工具的请求参数说明,以及可直接复制的 tools/call 示例。请求参数表中的字段即为 tools/call 的 arguments。

本接口文档由 SellerDexMCP 团队整理编写,示例数据为演示用途。接口返回的销量、销售额、趋势等预测类数据均为算法估算,可能存在延迟或误差,仅供参考,不构成任何经营决策建议。文中涉及的第三方名称与商标归其各自权利人所有,仅用于说明数据字段或兼容性,不构成任何授权或认可。