Olx MCP

🚀 OLX MCP Server

Claudeがあなたのために電子廃棄物を探してくれるなら、なぜ自分で地域内を探す必要があるのでしょうか？

100% AIによるサービスです。

✨ 主な機能

• 🌍 複数ドメイン対応：5つのOLXドメイン（ポルトガル、ポーランド、ブルガリア、ルーマニア、ウクライナ）を横断して検索できます。
• 🔍 リスティング検索：カテゴリ、場所、価格範囲、並べ替えなどのフィルターを使用して検索できます。
• 📋 リスティング詳細：特定のリスティングに関する詳細情報（売り手情報を含む）を取得できます。
• 🎭 ブラウザ自動化：Playwrightを使用した信頼性の高いウェブスクレイピングが可能です。

📦 インストール

📋 Claude Desktopの設定

1. Claude Desktopの設定ファイルを見つける：

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json
   • Linux：~/.config/Claude/claude_desktop_config.json

2. OLX MCPサーバーを設定に追加する：

{
  "mcpServers": {
    "olx-mcp": {
      "command": "npx",
      "args": ["olx-mcp"]
    }
  }
}

3. Claude Desktopを再起動して、新しい設定を読み込みます。

🔄 代替案：グローバルインストール

グローバルにインストールする場合は、以下のコマンドを実行します。

npm install -g olx-mcp

その後、以下の設定を使用します。

{
  "mcpServers": {
    "olx-mcp": {
      "command": "olx-mcp"
    }
  }
}

📦 開発用：ソースからのインストール

git clone https://github.com/l-margiela/olx-mcp.git
cd olx-mcp
npm install
npm run build

開発用には、以下の設定を使用します。

{
  "mcpServers": {
    "olx-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/olx-mcp/dist/index.js"]
    }
  }
}

💻 使用例

設定が完了したら、MCPクライアントで以下のツールを使用できます。

リスティング検索

サポートされている任意のOLXドメインで、さまざまなフィルターを使用してリスティングを検索できます。

Can you search for "apartments" in "Lisboa" on OLX Portugal with a maximum price of 1000 euros?

Search for "telefon" in "warszawa" on OLX Poland with prices between 100-500 PLN?

パラメーター：

• domain（必須）：OLXドメイン（'olx.pt', 'olx.pl', 'olx.bg', 'olx.ro', 'olx.ua'）
• query（オプション）：検索キーワード
• category（オプション）：カテゴリフィルター
• location（オプション）：場所フィルター
• minPrice（オプション）：最低価格
• maxPrice（オプション）：最高価格
• page（デフォルト: 1）：ページ番号
• limit（デフォルト: 20）：1ページあたりのアイテム数
• sortBy（デフォルト: 'relevance'）：並べ替え順（'relevance', 'date', 'price-asc', 'price-desc'）

リスティング詳細

サポートされている任意のドメインから特定のリスティングの詳細情報を取得できます。

Can you get the details for listing "ABC123" from OLX Portugal?

Show me details for listing "XYZ789" from OLX Poland including images?

パラメーター：

• domain（必須）：OLXドメイン（'olx.pt', 'olx.pl', 'olx.bg', 'olx.ro', 'olx.ua'）
• listingId（必須）：リスティングのID
• includeImages（デフォルト: false）：画像URLを含める
• includeSellerInfo（デフォルト: true）：売り手情報を含める

🔧 技術詳細

スクリプト

• npm run build - TypeScriptプロジェクトをビルドします。
• npm run dev - ホットリロードで開発モードで実行します。
• npm start - ビルドされたサーバーを実行します。
• npm test - テストを実行します（利用可能な場合）。
• npm run clean - ビルドアーティファクトをクリーンアップします。

トラブルシューティング

MCPインスペクター

MCP通信のデバッグには、MCPインスペクターを使用できます。

npx @modelcontextprotocol/inspector node dist/index.js

📄 ライセンス

MITライセンス - 詳細についてはLICENSEファイルを参照してください。