shopping-mcp

Claude（または任意のMCPクライアント）が公式Browse APIを通じてeBayの出品を検索できるようにするMCPサーバーです。

*「100ドル未満のメカニカルキーボード、即決のみ、送料無料で探して」*と尋ねると、アシスタントが実際に検索してくれます。

eBay results for "mechanical keyboard" — showing 3 of about 41,208 matches

1. Keychron K8 Pro Wireless Mechanical Keyboard - Brown Switches — $79.99
   total $79.99 · free shipping · New · was $99.00 (19% off)
   seller keeb_supply · 99.6% positive (8421 ratings) · top rated, ships from US
   Item v1|335894120043|0 · https://www.ebay.com/itm/335894120043

2. Ducky One 3 TKL Mechanical Keyboard RGB Hot-Swappable — $84.50
   total $92.45 · $7.95 shipping · New
   seller pc_parts_direct · 98.9% positive (3310 ratings) · accepts offers
   Item v1|326770118254|0 · https://www.ebay.com/itm/326770118254

できること——そして意図的にやらないこと

すべてのツールは読み取り専用です。 このサーバーは出品の検索と閲覧のみを行います。入札、カートへの追加、注文、支払いはできません。購入したいときは、出品リンクを渡すので、ご自身でチェックアウトしてください。

公式eBay Browse API上に構築されています——スクレイピングも、ブラウザ自動化も、Cookieの再利用もありません。レイアウト変更で壊れることも、eBayの利用規約に違反することもありません。

Related MCP server: ebay-mcp

ツール

search_ebayについて知っておくべきことが2つあります。これはeBayに存在するもので、固定価格カタログにはないものです：

• buying_optionはauction、buy_it_now、accepts_offersにフィルタリングします。

• sort: "ending_soonest" — buying_option: "auction"と組み合わせると、まもなく終了するオークションを見つける方法になります。

APIキーの取得

1. developer.ebay.com/my/keysにサインインします。

2. アプリケーションを作成し、Productionキーセットを開きます。

3. **App ID（Client ID）とCert ID（Client Secret）**をコピーします。

以上です。このサーバーはOAuthクライアント・クレデンシャル・フローを使用するため、ユーザートークン、リダイレクトURI、または「RuName」は不要です。

新しい開発者アカウントでは、キーページが開く前にeBayの本人確認を通過する必要がある場合があります——通常、約1営業日かかります。

インストール

git clone https://github.com/Kirat5690/shopping-mcp.git

cd shopping-mcp && npm install && npm run build

クライアントに接続する

Claude Code

claude mcp add shopping --env EBAY_CLIENT_ID=your-app-id --env EBAY_CLIENT_SECRET=your-cert-id -- node /absolute/path/to/shopping-mcp/dist/index.js

Claude Desktop

claude_desktop_config.jsonを編集します：

• macOS — ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows — %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "shopping": {
      "command": "node",
      "args": ["C:\\path\\to\\shopping-mcp\\dist\\index.js"],
      "env": {
        "EBAY_CLIENT_ID": "your-app-id",
        "EBAY_CLIENT_SECRET": "your-cert-id",
        "EBAY_MARKETPLACE_ID": "EBAY_US"
      }
    }
  }
}

クライアントを再起動し、check_ebay_connectionを実行して認証情報が機能することを確認してください。

設定リファレンス

数値に関する注意事項

• ランキング対象となるのは総額（商品価格＋送料）です。 価格での並べ替えは商品価格プラス送料を使用するため、安い商品でも送料が高い場合は技術的な理由で勝つことはありません。eBay自身の価格ソートは必ずしもこれを実行しません。

• 総額がない出品もあります。 eBayが送料をチェックアウト時に計算すると報告する場合、配達先住所が判明するまで総額は存在せず、出品には推測ではなくその旨が記載されます。

• 通貨換算はありません。 価格はeBayが返すとおり、マーケットプレイスの通貨で表示されます。

• 出品は個別の販売であり、カタログエントリではありません。 ほぼ同一のタイトルを持つ2つの結果でも、状態、バンドル内容、地域が異なる場合があります。同じ商品として扱う前に確認する価値があります。

• find_dealsは宣伝された割引のみを認識します。 eBayの取り消し線付き「元値」価格でフィルタリングするため、割引を宣伝したことがない本当に安い出品は表示されません。

開発

npm test

テストスイートはeBayの認証情報なしで実行されます。金額と総額のロジック、出力フォーマット、およびstdioでサーバーを起動してツール登録、スキーマ検証、未設定の認証情報パスを検証するエンドツーエンドのMCPプロトコルテストをカバーしています。

npm run watch      # recompile on change
npm run typecheck  # types only, no emit

構成：

src/
  index.ts     server entry point and stdio wiring
  tools.ts     MCP tool definitions
  ebay.ts      Browse API client and OAuth token cache
  config.ts    environment parsing and marketplace table
  money.ts     price parsing, landed totals, ranking
  format.ts    human-readable output
  http.ts      fetch with timeout and retry

範囲に関する注記

以前のバージョンでは、Product Advertising APIを通じたAmazonもサポートしていました。これはv0.2.0で削除されました：PA-APIには承認済みのAmazonアソシエイトアカウントが必要であり、アカウントが対象となる売上を上げない場合、Amazonはアクセスを失効させます——ほとんどの人がサーバーを起動するにはハードルが高すぎます。

AmazonクライアントとそのAWS SigV4署名は、承認済みアカウントをお持ちで復元したい場合は、タグv0.1.0-amazonのgit履歴に保存されています。

ライセンス

MIT — LICENSEを参照してください。

eBayとは提携、承認、またはスポンサー関係にありません。eBay APIの使用はeBay API License Agreementに準拠します。