Olx MCP

🚀 OLX MCP Server

為什麼要自己在所在地區搜索電子垃圾呢，Claude 可以幫你完成這項工作！這是一款 100% 由人工智能驅動的實用工具。

✨ 主要特性

• 🌍 多領域支持：可在 5 個 OLX 域名（葡萄牙、波蘭、保加利亞、羅馬尼亞、烏克蘭）上進行搜索。
• 🔍 搜索列表：支持使用類別、位置、價格範圍和排序等過濾器進行搜索。
• 📋 列表詳情：可獲取特定列表的詳細信息，包括賣家信息。
• 🎭 瀏覽器自動化：使用 Playwright 進行可靠的網頁數據抓取。

📦 安裝指南

📋 Claude 桌面端配置

1. 找到你的 Claude 桌面端配置文件：
   • 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 桌面端，以加載新配置。

🔄 替代方案：全局安裝

如果你想進行全局安裝，請執行以下命令：

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）：每頁顯示的項目數
• 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 文件。