browser-automationsearch-web

OLX▌

by l-margiela

Integrate with OLX to search property listings, retrieve detailed seller info, and monitor prices for market research ac

Integrates with OLX marketplaces across five European domains using web scraping to search listings with filters and retrieve detailed property information including seller data for market research and price monitoring.

github stars

★ 2

GitHub npm

Covers 5 European OLX domainsNo API key needed

best for

/ Market research and price monitoring
/ Real estate analysis across European markets
/ Automated marketplace monitoring

capabilities

/ Search OLX listings with filters
/ Retrieve detailed listing information
/ Extract seller contact details
/ Filter by price, location, and category
/ Access listings across 5 European domains

what it does

Scrapes OLX marketplace listings across 5 European countries to search and retrieve detailed property/item information including seller data.

about

OLX is a community-built MCP server published by l-margiela that provides AI assistants with tools and capabilities via the Model Context Protocol. Integrate with OLX to search property listings, retrieve detailed seller info, and monitor prices for market research ac It is categorized under browser automation, search web.

how to install

You can install OLX in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.

license

MIT

OLX is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.

readme

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

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
Add the OLX MCP server to your configuration:

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

Restart Claude Desktop to load the new configuration.

🔄 Alternative: Global Installation

If you prefer to install globally:

npm install -g olx-mcp

Then use this config:

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

📦 Development: From Source

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

Use this config for development:

{
  "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:

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?

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:

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

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:

npx @modelcontextprotocol/inspector node dist/index.js

License

MIT License - see LICENSE file for details.