Shopgoodwill

ShopGoodwill Auctions

shopgoodwill.com の開催中オークション、落札価格が確定した終了済みオークション、各商品の詳細を検索できます。Goodwill の加盟組織が運営するオンラインオークションサイトで、170 を超える地域の販売者がカメラ、ジュエリー、時計、美術品、電子機器、楽器、コレクターズアイテムを出品しています。

Pipeworx の一部です。AI エージェントを 1683 以上のライブデータソースに接続する MCP ゲートウェイです。

終了済みオークションの検索では、実際の落札価格（最終落札価格と入札数）が返されます。対象期間は過去約 90 日です。

ツール

ツール	返される内容
shopgoodwill_search	キーワード検索に一致する開催中の出品情報：現在の入札額、入札数、即決価格、カテゴリー、終了時刻、出品 URL。価格の上下限、カテゴリー ID、即決価格のみのフィルター、ページネーション（最大 40 件／ページ）を指定できます。
shopgoodwill_sold_search	キーワード検索に一致する終了済みオークションと、終了時の最終価格。num_bids > 0 の行は final_price で落札され、入札数が 0 の行は落札されていません。days_back はアーカイブの対象期間である約 90 日まで指定できます。
shopgoodwill_item	item_id で指定した 1 件の出品情報の詳細：説明、現在の入札額／最低入札額、入札履歴（入札者名はサイトによってマスクされています）、販売者である Goodwill 組織、送料・手数料、画像、終了時刻。

タイムスタンプにはタイムゾーンの表示がなく、米国太平洋時間です（サイトの慣例）。

認証

不要です。検索エンドポイントと商品詳細エンドポイントは、認証情報なしで応答します。

データソース

• ShopGoodwill の購入者向け API：https://buyerapi.shopgoodwill.com/api/Search/ItemListing （検索、開催中および終了済み）と https://buyerapi.shopgoodwill.com/api/itemDetail/GetItemDetailModelByItemId/{id} （商品詳細） — shopgoodwill.com のウェブアプリが使用するものと同じ JSON バックエンドです。
• コミュニティ製クライアント scottmconway/shopgoodwill-scripts に記載されているリクエスト形式です。

上流側の仕様（2026-09-05 時点で確認）

• 検索リクエストの本文が間違っているか不完全な場合、エラーなく 200 が返り、行数は 0 になります — lowPrice／highPrice は空でなく、"0"／"999999" のような文字列である必要があります。
• pageSize は黙って 無視されます — どのページも必ず 40 行です（5 または 100 を指定しても 40 行が返され、エラーはありません）。ページネーションには page を使用します。ツールの per_page はクライアント側で適用されます。
• 終了済みオークションのアーカイブは、指定した closedAuctionDaysBack の値にかかわらず、過去 約 90 日 までさかのぼります。
• 存在しない商品 ID を指定すると、本文が空の 404 が返されます。

クイックスタート

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

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

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

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

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

または、Pipeworx のフルゲートウェイに接続して、このパックのツールだけでなく、すべてのパックのツールを直接一覧表示できます：

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

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

MCP クライアントがない場合は、HTTP 経由で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/shopgoodwill_search \
  -H 'Content-Type: application/json' \
  -d '{"query":"nikon","per_page":5}'

最初の呼び出しではアカウントは不要です。任意のツールを確認できます：GET https://gateway.pipeworx.io/v1/tools/shopgoodwill_search。ツールを検索できます：POST https://gateway.pipeworx.io/v1/tools/search_packs と {"query":"..."} を指定します。

単独で実行する場合（ゲートウェイアカウント不要）

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

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

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

npx -y @pipeworx/mcp-shopgoodwill

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

ask_pipeworx を使う

ツールを直接呼び出す代わりに、平易な英語で質問できます。これは上記のパックエンドポイントでも、ゲートウェイ全体でも動作します：

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

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

詳細

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

ライセンス

MIT