Secondhand MCP

🚀 中古MCP

モデルコンテキストプロトコル (MCP) サーバーで、AIアシスタントが中古市場を検索できるようにします。Facebookマーケットプレイス、eBay、Depop、Poshmarkで中古品を検索でき、価格、カテゴリ、商品の状態、サイズ、色でフィルタリングし、写真、説明、売り手情報を含む詳細なリスティング情報を取得できます。

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

⚠️ 重要なメモ

セットアップをスキップしたいですか？ Secondhand MCP Cloud を試してみてください。Claude.aiとChatGPTに30秒で接続するホスト型バージョンです。インストールやChromeは必要ありません。無料プランもあります。

✨ 主な機能

サポートされている市場

🚀 クイックスタート

セットアップ

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"
      }
    }
  }
}

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、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. アプリケーションを作成して、クライアントIDとクライアントシークレットを取得します。
3. それらをMCP設定に EBAY_CLIENT_ID と EBAY_CLIENT_SECRET として追加します。

💻 使用例

search_marketplace

マーケットプレイス全体で商品を検索します。

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

get_listing_details

検索結果から取得したIDを使用して、特定のリスティングの詳細を取得します。

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

list_marketplaces

すべての有効なマーケットプレイスとその状態をリストします。

🔧 技術詳細

動作原理

• Facebookマーケットプレイス — 位置、価格、クエリでリスティングを検索します。都市名を座標に解決します。ログインやブラウザは必要ありません。
• eBay — OAuth 2.0クライアント資格情報を使用した公式のeBay Browse APIを使用します。トークンはキャッシュされ、自動的に更新されます。
• 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がないため、ページのスクレイピングに依存しています。
• レート制限: 短時間に大量のリクエストを行わないでください。

📄 ライセンス

MIT