Ebid

@pipeworx/ebid

eBid MCP — eBid.net のオンラインマーケットプレイスおよびオークションサイトから、公式 eBid Trading API v2 を介して、出品情報、終了した出品の検索、入札履歴、カテゴリを取得します。eBid は20か国以上（us、uk、ca、au、de、fr、…）のサイトを運営しています。eBay と比べると小規模なマーケットプレイスのため、出品情報や価格の二次的な情報源として扱ってください。

Pipeworx の一部です。AI エージェントを1878以上のライブデータソースに接続するMCPゲートウェイです。独立した非公式の統合であり、上流プロバイダーとは提携しておらず、承認も受けておらず、公開もされていません。

ツール

• ebid_search(keyword?, site?, category_id?, min_price?, max_price?, condition?, buy_now_only?, closed?, username?, country?, search_descriptions?, sort?, start?, rows?) — 現在の出品を検索します。終了した出品を検索するには closed: true を指定します（実際の落札価格はこちらに記録されています）。1ページあたり最大75件（APIの上限）です。
• ebid_listing(listing_id, site?, ship_to?) — 配送料を ship_to 宛てに計算した、1件の出品情報をすべて取得します。
• ebid_listing_bids(listing_id, site?) — 入札履歴を取得します。終了したオークションでは、最高入札額が実際の落札価格です。
• ebid_categories(category_id?, site?) — カテゴリごとの商品件数を含むカテゴリツリーを取得します。

認証

• BYOのみ： eBid API のコマンドはすべて、ログイン不要と説明されている読み取りコマンドも含め、AppId/AppKey のペアがないと上流で拒否されます（エラー003）。eBid開発者ポータル https://ebid.3scale.net/ で無料登録し、両方を1つの引数として渡してください：_apiKey: "AppId:AppKey"。
• 登録しただけでは、呼び出せるとは限りません。 eBid は登録時にアプリケーションの AppId と AppKey を発行しますが、アプリケーションは別途有効化されます。そのため、新しく発行されたペアは認証されても応答せず、すべてのコマンドでエラー116 application is not active が返ります。Pipeworx はこのようなペアを保有しているため（fleet #1284、発行日2026-09-07）、このパックはBYOのみのままです。ライブ呼び出しが成功するまでは、ルーターが必ず失敗するパックを選び続けることのないよう、PLATFORM_EBID_KEY は意図的に宣言していません。

4種類の認証情報エラーの見分け方

eBid はすべてHTTP 200で報告し、そのうち3種類はコード116を共有しています。2026-09-07に api.ebid.net/trading に対してライブで確認しました。

送信した内容	コード	上流の説明
AppIdなし	003	AppID not received. Please check your credentials are correctly formatted
eBidが発行していないAppId	116	application with id="…" was not found
実在するAppIdと誤ったAppKey	116	application key "…" is invalid
実在し、対応しているが未有効化のペア	116	application is not active

このパックでは、それぞれに固有のメッセージを割り当てています。呼び出し元にキーを渡すよう伝えるのは最初のエラーだけです。残り3つは、すでにキーが渡されており、解決策は別にあることを意味します。

データソース

• https://api.ebid.net/trading — eBid Trading API v2。単一エンドポイントに対し、本文にコマンドを含めたJSON POSTを送信します。ドキュメント：https://ebid.3scale.net/doc-json。
• エラーはHTTP 200と Error 配列で返されます。このパックはステータス行ではなく、上流のコードと説明を表示します。

クイックスタート

MCPクライアント（Claude Desktop、Cursor、Windsurfなど）に追加します。

{
  "mcpServers": {
    "ebid": {
      "url": "https://gateway.pipeworx.io/ebid/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/ebid/mcp の tools/list は、上の表にあるツールに加えて、共有 Pipeworx メタツール（ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツール群）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、パック固有のツールに加えて、共有ツールがおよそ30個表示されます。接続の initialize 応答に正確な範囲が記載されており、その日の状況を確認する際の正式な情報源となります。

これは意図的な仕様であり、偶然の多重化ではありません。メタツールを使うと、このパックの対象外の質問にも、カタログ全体を横断してルーティングする ask_pipeworx 経由で回答できます。そのため、MCP サーバーを追加する必要はありません。現在、メタツールを含めずにパックのエンドポイントをマウントする方法はありません。追加のスキーマがもたらすコンテキストコストが、ルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、Pipeworx のフルゲートウェイに接続すると、このパックのツールだけでなく、すべてのパックのツールが直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も、同じゲートウェイと同じ1878以上のデータソースにつながります。異なるのは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも ask_pipeworx ですべてのツールにアクセスできます。

MCP クライアントをお持ちでない場合：HTTP で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/ebid_search \
  -H 'Content-Type: application/json' \
  -d '{"keyword":"lego","site":"uk"}'

最初の呼び出しにアカウントは必要ありません。ツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/ebid_search を実行します。ツールを見つけるには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイとの往復通信も不要です。

{
  "mcpServers": {
    "ebid": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-ebid"]
    }
  }
}

または、直接実行して起動を確認できます。

npx -y @pipeworx/mcp-ebid

stdin/stdout 経由で MCP と通信し、このパックのツールのみを対象に initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共有メタツールはありません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx の使用

ツールを直接呼び出す代わりに、自然な英語で質問できます。上記のパックエンドポイントでも、フルゲートウェイでも利用できます。

ask_pipeworx({ question: "your question about Ebid data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

さらに詳しく

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT