Bonanza

@pipeworx/bonanza

「Bonapitit」API（api.bonanza.com/docs）を使って、Bonanzaマーケットプレイスの出品を検索します。eBay Trading API互換の読み書き可能なAPIです。
このAPIでは注文は販売者ごとに限定され（ログインユーザーの認証トークンが必要です）、このパックで利用できるのは検索と商品詳細のみです。販売済み価格のデータはありません。

Pipeworx の一部です。AI エージェントを1875以上のライブデータソースに接続するMCPゲートウェイです。これは独立した非公式のインテグレーションであり、上流プロバイダーとは提携、推奨、公開のいずれもしていません。

ツール

• bonanza_search(keywords, entries_per_page?, page_number?, sort_order?) — キーワード検索（findItemsByKeywords）。
• bonanza_search_by_category(category_id, entries_per_page?, page_number?) — カテゴリー閲覧（findItemsByCategory）。
• bonanza_get_item(item_id) — 単一出品の詳細（getSingleItem）。

認証

BYOキーのみ（_apiKey）で、APIキーが必要です。https://api.bonanza.com/accounts/new で無料のdevID/certIDを登録してください。ビジネス身元情報が必要なアカウントで、手動承認には約1～2日かかります。?_apiKey=<devID> または <devID>:<certID>（コロン区切り。certIDは受け付けられますが、この3つの読み取り呼び出しでは使用されません）を渡します。

BYO方式は暫定措置ではなく、確定した方針です。プラットフォーム登録に関する判断は2026-09-06（fleet #1278）に確定しており、Pipeworxはプラットフォーム用devIDの費用負担も登録も行わないため、呼び出し元は常に独自のキーを用意します。キーなしで呼び出すと「requires an API key」として拒否され、登録URLが提示されます。リクエスト形式はライブレスポンスに対して検証されていません（「データソース」を参照）。実際のdevIDを持つ最初の呼び出し元が、ライブで動作を確認します。

データソース

• https://api.bonanza.com/docs — Bonapititのリファレンスです。ドキュメントサイトはクライアント側でレンダリングされるSPAです。実際のワイヤー形式（ベースURL、ヘッダー、本文のエンコード方式）は静的HTMLからは確認できず、オープンソースのPHP SDKから再構成する必要がありました。https://github.com/Shoplo/bonapitit-bonanza-php-sdk

次に作業する人への注意点：

• 以下のすべての呼び出しで、ベースURLは https://api.bonanza.com/api_requests/standard_request です（セキュア／書き込み呼び出しでは代わりに secure_request を使用し、ユーザー認証トークンも必要です。ここでは対象外です）。
• リクエスト本文は application/x-www-form-urlencoded で、フィールドは正確に1つだけです。呼び出し名（ローワーキャメルケース。例：findItemsByKeywords）をフィールド名とし、その値にJSONシリアライズしたリクエストオブジェクトを設定します。これはJSON本文でもREST風のクエリ文字列でもありません。間違えやすいので注意してください。
• 認証ヘッダーは X-BONANZLE-API-DEV-NAME / X-BONANZLE-API-CERT-NAME です（Bonanzaの旧内部名「Bonanzle」）。X-BONANZA-* ではありません。
• このパックは、Bonanzaのライブレスポンスに対して一度も呼び出されていません。 アカウント登録にはパスワードと事業情報が必要で、Bruce本人が入力する必要があります。そのキーが用意されるまでは、正確なレスポンスフィールド名はコミュニティSDK／ドキュメントをもとに確認されたものの、実際のペイロードに対しては未検証として扱ってください。

クイックスタート

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

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

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

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

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

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

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

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

MCP クライアントをお持ちでない場合は、HTTP 経由で呼び出せます

curl -X POST https://gateway.pipeworx.io/v1/tools/bonanza_search \
  -H 'Content-Type: application/json' \
  -d '{"keywords":"vintage brass lamp","entries_per_page":10}'

最初の呼び出しにはアカウントは不要です。ツールの詳細を確認するには、GET https://gateway.pipeworx.io/v1/tools/bonanza_search を使用します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を使用します。

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

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

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

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

npx -y @pipeworx/mcp-bonanza

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

ask_pipeworx の使用

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

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

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

詳細情報

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

ライセンス

MIT