OLX MCP Server

Why search for e-waste in your area by yourself if Claude can do it for you?

100% AI slop.

Features

• 🌍 Multi-Domain Support: Search across 5 OLX domains (Portugal, Poland, Bulgaria, Romania, Ukraine)
• 🔍 Search Listings: Search with filters for category, location, price range, and sorting
• 📋 Listing Details: Get detailed information about specific listings including seller info
• 🎭 Browser Automation: Reliable web scraping using Playwright

Installation

📋 Claude Desktop Configuration

1. Locate your Claude Desktop config file:

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

2. Add the OLX MCP server to your configuration:

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

3. Restart Claude Desktop to load the new configuration.

🔄 Alternative: Global Installation

If you prefer to install globally:

bashCopy code
npm install -g olx-mcp

Then use this config:

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

📦 Development: From Source

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

Use this config for development:

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

Usage

Once configured, you can use the following tools in your MCP client:

Search Listings

Search for listings on any supported OLX domain with various filters:

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

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

Parameters:

• domain (required): OLX domain ('olx.pt', 'olx.pl', 'olx.bg', 'olx.ro', 'olx.ua')
• query (optional): Search term
• category (optional): Category filter
• location (optional): Location filter
• minPrice (optional): Minimum price
• maxPrice (optional): Maximum price
• page (default: 1): Page number
• limit (default: 20): Items per page
• sortBy (default: 'relevance'): Sort order ('relevance', 'date', 'price-asc', 'price-desc')

Listing Details

Get detailed information about a specific listing from any supported domain:

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

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

Parameters:

• domain (required): OLX domain ('olx.pt', 'olx.pl', 'olx.bg', 'olx.ro', 'olx.ua')
• listingId (required): The ID of the listing
• includeImages (default: false): Include image URLs
• includeSellerInfo (default: true): Include seller information

Development

Scripts

• npm run build - Build the TypeScript project
• npm run dev - Run in development mode with hot reload
• npm start - Run the built server
• npm test - Run tests (when available)
• npm run clean - Clean build artifacts

Troubleshooting

MCP Inspector

For debugging MCP communication, you can use the MCP Inspector:

bashCopy code
npx @modelcontextprotocol/inspector node dist/index.js

License

MIT License - see LICENSE file for details.