概览 · 接口文档 · SellerDexMCP
概览
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 --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": {}
}
}'请求头
| # | 参数 | 说明 |
|---|---|---|
| 1 | Content-Type | application/json |
| 2 | Accept | application/json, text/event-stream |
| 3 | secret-key | 用户中心「密钥管理」中创建的密钥,形如 sk_live_xxx |
返回结构
成功时,结果位于 result.structuredContent;result.content[0].text 是同一结构的 JSON 字符串,便于 Agent 直接读取。业务失败(如参数校验不通过)时 result.isError 为 true,此时没有 structuredContent,content[0].text 内为 {"code":"SERVICE_ERROR","message":"失败原因"}。协议层错误(工具名不存在、密钥无效等)直接返回顶层 error 对象。
{
"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
}
}公共返回参数
| # | 字段 | 类型 | 说明 |
|---|---|---|---|
| 1 | code | String | 业务状态码,OK 表示成功 |
| 2 | message | String | 提示信息 |
| 3 | data | Object | 业务数据,不同工具的结构见各自页面 |
参数类型均为 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 团队整理编写,示例数据为演示用途。接口返回的销量、销售额、趋势等预测类数据均为算法估算,可能存在延迟或误差,仅供参考,不构成任何经营决策建议。文中涉及的第三方名称与商标归其各自权利人所有,仅用于说明数据字段或兼容性,不构成任何授权或认可。