关于 Soldgraph
Soldgraph 是面向 Claude、Cursor、VS Code 等 MCP 客户端的商品交易数据服务,可搜索 eBay、Poshmark、Mercari、Depop、Vinted、TCGplayer 等平台的已售和在售商品,并查询卡牌价格。通过远程 HTTP 端点接入。
主要功能
- 01搜索已售商品
- 02搜索在售商品
- 03查询卡牌价格
- 04覆盖多个交易平台
- 05通过 HTTP 接入
适用场景
- 01比较不同平台的商品成交情况
- 02查询收藏卡牌价格
- 03在编码客户端中检索商品列表
MCP 相关
Soldgraph 提供 Streamable HTTP MCP 服务,地址为 https://api.soldgraph.com/mcp;客户端使用 Bearer 密钥认证。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
服务地址
https://api.soldgraph.com/mcp一键复制安装命令
Claude CodeTerminal
claude mcp add --transport http soldgraph-soldgraph https://api.soldgraph.com/mcpCursor.cursor/mcp.json
{"mcpServers":{"soldgraph-soldgraph":{"type":"http","url":"https://api.soldgraph.com/mcp"}}}在 Cursor 中打开VS Code.vscode/mcp.json
{"servers":{"soldgraph-soldgraph":{"type":"http","url":"https://api.soldgraph.com/mcp"}}}在 VS Code 中打开Claude Desktopclaude_desktop_config.json
{"mcpServers":{"soldgraph-soldgraph":{"type":"http","url":"https://api.soldgraph.com/mcp"}}}Windsurf~/.codeium/windsurf/mcp_config.json
{"mcpServers":{"soldgraph-soldgraph":{"serverUrl":"https://api.soldgraph.com/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
全部服务地址
Streamable HTTP
https://api.soldgraph.com/mcp需要授权工具
19| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| q | string | 是 | 搜索关键字,长度为 1–200 个字符,按在市场搜索框中输入的方式填写。请具体说明:型号、尺寸、等级、版本。 |
| page | integer | 否 | 要获取的源页面。如果端点支持 cursor,则第 2 页及后续页面还需要提供该参数。 |
| sort | enum | 否 | 结果排序方式。不传时使用 eBay 的最佳匹配。recently_sold 按最新成交时间优先。price_asc 和 price_desc 按价格加运费排序。best_match | recently_sold | price_asc | price_desc |
| count | enum | 否 | 每页行数:200、120、60 或 40。发送 200 可获取 eBay 提供的最多结果;省略此项时默认为 40。无论数量多少,每次搜索都计为一次请求。可选。40 | 60 | 120 | 200 |
| fields | enum | 否 | summary 返回大多数 Agent 所需的字段;full 返回 API 提供的所有字段。summary | full |
| country | enum | 否 | 要搜索的 eBay 站点:us(ebay.com)、uk(ebay.co.uk)、ca(ebay.ca)、au(ebay.com.au)、de(ebay.de)、fr(ebay.fr)、it(ebay.it)或 es(ebay.es)。结果、价格、min_price 和 max_price 均使用该站点的货币。任意。us | uk | ca | au | de | fr | it | es |
| condition | array | 否 | eBay 自身的商品状况分组。可发送一个或多个值,以逗号分隔,例如 new,open_box。new 表示全新,open_box 表示开箱或全新(其他),refurbished 表示所有翻新等级,used 表示二手,for_parts 表示仅供零件使用。筛选由 eBay 执行。 |
| max_price | integer | 否 | 最高价格,以该国家/地区货币的整数单位表示(us 使用美元)。任意。可单独发送,不必同时提供 min_price。 |
| min_price | integer | 否 | 最低价格,以该国家/地区货币的整数单位表示(us 使用美元)。任意。不得高于 max_price。可单独发送,不必同时提供 max_price。 |
| category_id | integer | 否 | eBay 数字类别 ID,例如显卡类别的 27386。仅保留该类别中的商品。任意。 |
| buying_format | enum | 否 | 仅限一种刊登类型:auction、buy_it_now(固定价格,也包括接受议价的刊登)或 best_offer(接受议价的刊登)。筛选由 eBay 执行。auction | buy_it_now | best_offer |
| item_location | enum | 否 | 卖家所在地。domestic 仅保留搜索所在国家/地区的卖家;worldwide 包含所有国家/地区。省略时使用 eBay 站点自身的默认值。fr 的默认范围较窄;如需获取更多结果,请发送 worldwide。domestic | worldwide |
详细介绍
Soldgraph MCP 服务
将 Claude、Cursor、VS Code 或任何 MCP 客户端连接到 Soldgraph。这样,助手就能搜索已售和在售商品,并查询卡牌价格,无需编写代码。
- URL:
https://api.soldgraph.com/mcp - 身份验证:
Authorization: Bearer <your API key> - 传输方式: Streamable HTTP
Claude Code
claude mcp add --transport http soldgraph https://api.soldgraph.com/mcp \
--header "Authorization: Bearer $SOLDGRAPH_KEY"
Cursor
~/.cursor/mcp.json,或为单个项目使用 .cursor/mcp.json:
{
"mcpServers": {
"soldgraph": {
"url": "https://api.soldgraph.com/mcp",
"headers": { "Authorization": "Bearer ${env:SOLDGRAPH_KEY}" }
}
}
}
VS Code
.vscode/mcp.json:
{
"inputs": [
{ "type": "promptString", "id": "soldgraph-key", "description": "Soldgraph API key", "password": true }
],
"servers": {
"soldgraph": {
"type": "http",
"url": "https://api.soldgraph.com/mcp",
"headers": { "Authorization": "Bearer ${input:soldgraph-key}" }
}
}
}
其他客户端请参阅:soldgraph.com/docs/guides/mcp。
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。