Secondhand MCP

Model Context Protocol (MCP) サーバーで、AIアシスタントが中古マーケットプレイスを検索できるようにします。Facebook Marketplace、eBay、Depop、Poshmarkで中古品を検索し、価格、カテゴリ、状態、サイズ、色でフィルターをかけ、写真、説明、出品者情報を含む詳細な出品情報を取得できます。

Claude Desktop、Claude Code、Cursor、およびMCP互換のクライアントで動作します。

[!TIP] セットアップをスキップしたいですか？ Secondhand MCP Cloud をお試しください。30秒でClaude.aiとChatGPTに接続できるホスト版です。インストールやChromeは不要です。無料枠あり。

サポートされているマーケットプレイス

Related MCP server: BopMarket MCP Server

セットアップ

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json に追加：

{
  "mcpServers": {
    "secondhand": {
      "command": "npx",
      "args": ["-y", "secondhand-mcp"],
      "env": {
        "EBAY_CLIENT_ID": "your-ebay-client-id",
        "EBAY_CLIENT_SECRET": "your-ebay-client-secret",
        "EBAY_MARKETPLACE_ID": "EBAY_US"
      }
    }
  }
}

Claude Code

~/.claude/.mcp.json に追加：

{
  "mcpServers": {
    "secondhand": {
      "command": "npx",
      "args": ["-y", "secondhand-mcp"],
      "env": {
        "EBAY_CLIENT_ID": "your-ebay-client-id",
        "EBAY_CLIENT_SECRET": "your-ebay-client-secret",
        "EBAY_MARKETPLACE_ID": "EBAY_US"
      }
    }
  }
}

eBay、Depop、Poshmarkはすべてオプションです。eBay APIキーがない場合やChromeがインストールされていない場合、それらのマーケットプレイスは自動的に無効になり、残りは引き続き動作します。

Depop & Poshmark / Chromeの要件

DepopとPoshmarkはヘッドレスブラウザを必要とします。システムにGoogle ChromeまたはChromiumがインストールされている場合、両方とも自動的に有効になります。設定は不要です。Chromeが見つからない場合は、静かにスキップされます。

macOSでは、初めてDepopまたはPoshmarkを検索する際に、Node.jsがChromeを制御することを許可するよう求めるシステムプロンプトが表示される場合があります。これは予期される動作です。puppeteerがChromeをヘッドレスモードで起動する必要があるためです。一度許可すると、再度尋ねられることはありません。

ブラウザはバックグラウンドで非表示の状態で実行され、実際にDepopまたはPoshmarkを検索したときだけ起動します。

設定

マーケットプレイスの選択

デフォルトではすべてのマーケットプレイスが有効になっています。アクティブにするものを制限するには、MARKETPLACES環境変数を設定します（カンマ区切り）：

{
  "env": {
    "MARKETPLACES": "facebook,ebay"
  }
}

有効な値：facebook、ebay、depop、poshmark

eBay APIキー

eBayは公式のBrowse APIを使用しています。無料のeBayデベロッパーアカウントが必要です：

1. developer.ebay.comでアカウントを作成

2. アプリケーションを作成し、Client IDとClient Secretを取得

3. MCP設定にEBAY_CLIENT_IDおよびEBAY_CLIENT_SECRETとして追加

eBayマーケットプレイス / 地域

デフォルトでは、サーバーはUSのeBayサイトを対象としています。別の地域のマーケットプレイスを検索するには、EBAY_MARKETPLACE_ID環境変数を設定します：

{
  "env": {
    "EBAY_MARKETPLACE_ID": "EBAY_DE"
  }
}

一般的な値：

完全なリストはeBay APIドキュメントで確認できます。

ツール

search_marketplace

マーケットプレイス間でアイテムを検索します。

マーケットプレイスごとに返されるデータ：

get_listing_details

検索結果のIDを使用して、特定の出品の詳細情報を取得します。

マーケットプレイスごとに返されるデータ：

list_marketplaces

有効なすべてのマーケットプレイスとそのステータスを一覧表示します。

search / fetch（ディープリサーチ）

便利なペア。ChatGPT Deep Researchツールコントラクトに従います。厳密な名前で、それぞれ単一の文字列引数を取ります：

• search(query) — 有効なすべてのマーケットプレイスを一度に検索し、{ results: [{ id, title, text, url }] }を返します。idはmarketplace:listingIdの形式です。

• fetch(id) — searchの結果IDの完全な出品詳細を{ id, title, text, url, metadata }として返します。

これらの標準的なツール名を期待するリサーチスタイルのクライアントに便利です。フィルター検索にはsearch_marketplaceを使用してください。

仕組み

Facebook Marketplace — ロケーション、価格、クエリで出品を検索します。都市名を座標に変換します。ログインやブラウザは不要です。

eBay — OAuth 2.0クライアント認証情報を使用した公式のeBay Browse APIを使用します。トークンはキャッシュされ、自動的に更新されます。対象の地域マーケットプレイスはEBAY_MARKETPLACE_ID（デフォルト：EBAY_US）で制御されます。

Depop — ヘッドレスブラウザを使用して出品を検索し、カテゴリ、状態、サイズ、色のフィルターをサポートします。ブラウザインスタンスはリクエスト間で共有されます。

Poshmark — ヘッドレスブラウザを使用して出品を検索し、状態、サイズ、色、並び順、価格のフィルターをサポートします。Poshmarkはロケーションベースではありません。すべてのアイテムは国内配送されます。

開発

git clone https://github.com/jlsookiki/secondhand-mcp.git
cd secondhand-mcp
npm install
npm run build

マーケットプレイスの追加

1. src/marketplaces/に新しいファイルを作成

2. BaseMarketplaceを拡張し、search()と必要に応じてgetListingDetails()を実装

3. src/marketplaces/index.tsのallMarketplacesにコンストラクタを追加

制限事項

• Facebook: Facebookがフロントエンドを変更すると動作しなくなる可能性があります

• eBay: デベロッパーAPIキーが必要（無料枠あり）

• Depop: Chrome/Chromiumのインストールが必要。Facebook/eBayよりも遅い（検索あたり約5秒）

• Poshmark: Chrome/Chromiumのインストールが必要。公式APIがないためページスクレイピングに依存

• レート制限: あまりに多くのリクエストを短時間に行わないでください

License

MIT