Soldgraph について
Soldgraphは、Claude、Cursor、VS CodeなどのMCPクライアント向けマーケットプレイスデータサービスです。eBay、Poshmark、Mercari、Depop、Vinted、TCGplayerなどの売却済み・出品中の商品を検索し、カード価格を確認できます。
主な機能
- 01売却済み商品の検索
- 02出品中商品の検索
- 03カード価格の確認
- 04複数マーケットプレイスに対応
- 05HTTP接続
活用シーン
- 01複数市場での販売状況の比較
- 02トレーディングカード価格の確認
- 03コーディングクライアントからの商品検索
MCP 対応
Soldgraphは https://api.soldgraph.com/mcp で Streamable HTTP のMCPサーバーを提供し、Bearerキー認証を使用します。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://api.soldgraph.com/mcpclaude mcp add --transport http soldgraph-soldgraph https://api.soldgraph.com/mcp{"mcpServers":{"soldgraph-soldgraph":{"type":"http","url":"https://api.soldgraph.com/mcp"}}}Cursor で開く{"servers":{"soldgraph-soldgraph":{"type":"http","url":"https://api.soldgraph.com/mcp"}}}VS Code で開く{"mcpServers":{"soldgraph-soldgraph":{"type":"http","url":"https://api.soldgraph.com/mcp"}}}{"mcpServers":{"soldgraph-soldgraph":{"serverUrl":"https://api.soldgraph.com/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
https://api.soldgraph.com/mcp認証が必要ツール
19| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| q | string | はい | 検索キーワード。1~200 文字で、マーケットプレイスの検索ボックスに入力する形式で指定します。モデル、サイズ、グレード、エディションなどを具体的に指定してください。 |
| page | integer | いいえ | 取得するソースページです。エンドポイントが cursor に対応している場合、2 ページ目以降では cursor も必要です。 |
| sort | enum | いいえ | 結果の並び順です。省略すると eBay のベストマッチになります。recently_sold は販売日時の新しい順です。price_asc と price_desc は価格と送料の合計で並べ替えます。best_match | recently_sold | price_asc | price_desc |
| count | enum | いいえ | 1 ページあたりの行数:200、120、60、または 40。eBay から取得できる最大件数を指定するには 200 を送信します。省略した場合は 40 になります。件数にかかわらず、検索ごとに 1 回のリクエストが発生します。任意。40 | 60 | 120 | 200 |
| fields | enum | いいえ | summary はほとんどのエージェントが必要とするフィールドを返し、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 のように、1 つ以上をカンマ区切りで指定します。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 | いいえ | 出品形式は 1 種類のみ指定できます: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をご覧ください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。