shopgoodwill_search
Pack: shopgoodwill · Endpoint: https://gateway.pipeworx.io/shopgoodwill/mcp
Search active auctions on shopgoodwill.com, the online auction site run by Goodwill member organizations — cameras, jewelry, watches, art, collectibles, electronics, clothing. Returns live listings with current bid price, bid count, buy-now price, category, end time and listing URL. Sourced from the shopgoodwill.com search API.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
query | string | yes | Search keywords, e.g. “nikon d750” or “sterling silver” |
category_id | number | no | Optional ShopGoodwill category id to narrow results (e.g. 15 = Art, 99 = Books) |
min_price | number | no | Minimum current price in USD |
max_price | number | no | Maximum current price in USD |
buy_now_only | boolean | no | Only listings with a Buy Now price |
page | number | no | Result page, starting at 1 |
per_page | number | no | Max results to return, up to 40 (each source page holds 40 rows; use page to paginate) |
Example call
Arguments
{
"query": "nikon",
"per_page": 5
}
curl
curl -X POST https://gateway.pipeworx.io/shopgoodwill/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"shopgoodwill_search","arguments":{"query":"nikon","per_page":5}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('shopgoodwill_search', {
"query": "nikon",
"per_page": 5
});
Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"shopgoodwill": {
"url": "https://gateway.pipeworx.io/shopgoodwill/mcp"
}
}
}
See Getting Started for client-specific install steps.