Begagnad MCP

🚀 Begagnad MCP

このModel Context Protocol (MCP)サーバーは、スウェーデンの2つの最大の中古市場であるBlocketとTraderaを検索するためのものです。AIエージェントに中古市場の商品情報を検索・取得させることができ、タイトル、説明、価格、画像、販売者情報、商品リンクなどの統一されたデータを返します。

🚀 クイックスタート

公開エンドポイントの使用

ライブインスタンスは https://begagnad-mcp.bjesus.workers.dev/sse で利用可能です。Claude Desktopを設定するには、~/.config/Claude/claude_desktop_config.json を編集します。

{
  "mcpServers": {
    "begagnad": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://begagnad-mcp.bjesus.workers.dev/sse"
      ]
    }
  }
}

Claude Desktopを再起動してサーバーを読み込みます。

独自インスタンスのデプロイ

1. 依存関係をインストールします。

npm install

2. Cloudflareにログインします。

wrangler login

3. デプロイします。

npm run deploy

4. デプロイURLを使ってClaude Desktopの設定を更新します。

ローカル開発

npm start

サーバーは http://localhost:8788/sse で実行されます。

設定

Tradera APIの認証情報は、Cloudflareのシークレットとして設定できます。

wrangler secret put TRADERA_APP_ID
wrangler secret put TRADERA_APP_KEY

✨ 主な機能

• search_blocket - Blocket市場を検索します。
  • パラメータ: query (文字列), limit (数値、オプション)
• get_blocket_item - 特定のBlocketの商品詳細を取得します。
  • パラメータ: ad_id (文字列)
• search_tradera - Tradera市場を検索します。
  • パラメータ: query (文字列), page (数値、オプション)
• get_tradera_item - 特定のTraderaの商品詳細を取得します。
  • パラメータ: item_id (文字列)
• search_both - 両方の市場を同時に検索します。
  • パラメータ: query (文字列), blocket_limit (数値、オプション)

💻 使用例

Claudeに以下のような質問をします。

• "OpenWRTがインストールされたLinksysルーターを探して"
• "20000 SEK以下の赤いピックアップトラックを検索して"
• "ストックホルムのヴィンテージ家具を見せて"

📚 ドキュメント

データ形式

統一されたデータ構造を返します。

• 商品ID、タイトル、説明
• 価格 (SEK)、場所
• 画像 (URL)
• 販売者名と評価
• 商品への直接リンク
• ソース市場 (BlocketまたはTradera)

API

• Blocket API: https://blocket-api.se/v1/
• Tradera API: https://api.tradera.com/v3/

📄 ライセンス

MITライセンスのもとで提供されています。