l-margiela/olx-mcp
View on GitHub ↗OLX MCP server. 100% vibe-coded AI slop
20 ★5 forksTypeScriptUpdated 23d ago
What you need to know
Minimal MCP server that searches and inspects OLX classified listings across 5 domains (Portugal, Poland, Bulgaria, Romania, Ukraine) using Playwright browser automation — search with filters, listing details, and seller info.
Install
npx olx-mcp (in client config) npm install -g olx-mcp
Usage
- •Add an mcpServers entry with command npx and args ["olx-mcp"], then restart Claude Desktop.
- •Ask e.g. 'Can you search for apartments in Lisboa on OLX Portugal with a maximum price of 1000 euros?'.
- •Request listing details with listingId, includeImages and includeSellerInfo options.
- •Debug with the MCP Inspector: npx @modelcontextprotocol/inspector node dist/index.js.
Key features
- ✓Multi-domain search across olx.pt, olx.pl, olx.bg, olx.ro, olx.ua.
- ✓Filter by category, location, price range; sort by relevance, date, price-asc, price-desc.
- ✓Listing details incl. seller info and optional image URLs.
- ✓Playwright-based reliable web scraping.
Best for
Quickly finding and inspecting second-hand listings across five European OLX markets from a chat agent.
Caveats
- ⚠Self-described as '100% AI slop'; a hobby web-scraping tool.
- ⚠Depends on scraping OLX sites, so it can break if site structure changes; no API.
- ⚠MIT licensed.
Platforms: LocalClients: Claude Desktop · Any MCP client
Reviewed 2026-08-18
Topics
- Stars
- 20★
- Forks
- 5
- Language
- TypeScript
- License
- MIT
- Created
- 2025-09-02
- Last push
- 2026-08-12