@pipeworx/bonanza

Connect: https://gateway.pipeworx.io/bonanza/mcp · Install: one-click buttons

Tools: 3

Search Bonanza marketplace listings via the “Bonapitit” API (api.bonanza.com/docs) — an eBay-Trading-API-compatible read/write API. Orders are seller-scoped on this API (need a logged-in user’s auth token), so this pack is search + item detail only. No sold-price data.

Tools

• bonanza_search(keywords, entries_per_page?, page_number?, sort_order?) — keyword search (findItemsByKeywords).
• bonanza_search_by_category(category_id, entries_per_page?, page_number?) — category browse (findItemsByCategory).
• bonanza_get_item(item_id) — single listing detail (getSingleItem).

Auth

BYO key only (_apiKey), requires an API key. Register a free devID/certID at https://api.bonanza.com/accounts/new — a business-identity account with a ~1-2 day manual approval. Pass ?_apiKey=<devID> or <devID>:<certID> (colon-joined; certID is accepted but unused by these three read calls).

Registering requires creating a Bonanza API account (business name, website, password) and waiting for manual approval — a human step this pack’s author cannot perform on Bruce’s behalf. See the open Needs Bruce item for platform registration; this pack ships BYOK-gated in the meantime and its request shape has not been verified against a live response (see Data sources).

Data sources

• https://api.bonanza.com/docs — Bonapitit reference. The docs site is a client-rendered SPA; the actual wire format (base URL, headers, body encoding) is NOT visible in the static HTML and had to be reconstructed from the open-source PHP SDK: https://github.com/Shoplo/bonapitit-bonanza-php-sdk.

Traps for the next person:

• Base URL is https://api.bonanza.com/api_requests/standard_request for every call below (secure/write calls use secure_request instead and also need a user auth token — out of scope here).
• The request body is application/x-www-form-urlencoded with exactly ONE field: the call name (lower-camel, e.g. findItemsByKeywords) whose value is the JSON-serialized request object. This is not a JSON body and not a REST-ish query string — easy to get wrong.
• Auth headers are X-BONANZLE-API-DEV-NAME / X-BONANZLE-API-CERT-NAME (Bonanza’s old internal name, “Bonanzle”) — not X-BONANZA-*.
• This pack has never been called against a live Bonanza response. Registering an account needs a password and business details Bruce has to enter himself; until that key exists, treat the exact response field names as unverified against the community SDK/docs, not against a real payload.

Tools

• bonanza_search — Search active Bonanza marketplace listings by keyword (Bonapitit findItemsByKeywords). Requires a Bonanza API devID. No sold data — orders are seller-scoped on this API.
• bonanza_search_by_category — Search active Bonanza marketplace listings within a category ID (Bonapitit findItemsByCategory). Requires a Bonanza API devID.
• bonanza_get_item — Get a single Bonanza listing by item ID (Bonapitit getSingleItem). Requires a Bonanza API devID.