{"id":44032904,"url":"https://github.com/l-margiela/olx-mcp","last_synced_at":"2026-02-07T19:20:58.039Z","repository":{"id":312902992,"uuid":"1049214158","full_name":"l-margiela/olx-mcp","owner":"l-margiela","description":"OLX MCP server. 100% vibe-coded AI slop","archived":false,"fork":false,"pushed_at":"2025-09-03T06:08:37.000Z","size":625,"stargazers_count":2,"open_issues_count":1,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-17T06:52:01.782Z","etag":null,"topics":["mcp","mcp-server","model-context-protocol","model-context-protocol-server","model-context-protocol-servers","olx"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/l-margiela.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-02T16:42:22.000Z","updated_at":"2025-10-13T11:40:28.000Z","dependencies_parsed_at":"2025-09-02T19:06:43.198Z","dependency_job_id":"91ae2eea-9251-4e5b-a5f4-01f575828659","html_url":"https://github.com/l-margiela/olx-mcp","commit_stats":null,"previous_names":["l-margiela/olx-mcp"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/l-margiela/olx-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/l-margiela%2Folx-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/l-margiela%2Folx-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/l-margiela%2Folx-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/l-margiela%2Folx-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/l-margiela","download_url":"https://codeload.github.com/l-margiela/olx-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/l-margiela%2Folx-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29205244,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-07T17:44:10.191Z","status":"ssl_error","status_checked_at":"2026-02-07T17:44:07.936Z","response_time":63,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["mcp","mcp-server","model-context-protocol","model-context-protocol-server","model-context-protocol-servers","olx"],"created_at":"2026-02-07T19:20:56.271Z","updated_at":"2026-02-07T19:20:58.033Z","avatar_url":"https://github.com/l-margiela.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# OLX MCP Server\n\nWhy search for e-waste in your area by yourself if Claude can do it for you?\n\n100% AI slop.\n\n## Features\n\n- 🌍 **Multi-Domain Support**: Search across 5 OLX domains (Portugal, Poland, Bulgaria, Romania, Ukraine)\n- 🔍 **Search Listings**: Search with filters for category, location, price range, and sorting\n- 📋 **Listing Details**: Get detailed information about specific listings including seller info\n- 🎭 **Browser Automation**: Reliable web scraping using Playwright\n\n\u003cimg width=\"739\" height=\"858\" alt=\"Screenshot 2025-09-02 at 22 47 54\" src=\"https://github.com/user-attachments/assets/c6fee7a4-fa84-4ca5-9eb0-7dc8a1ed6c58\" /\u003e\n\n## Installation\n\n### 📋 Claude Desktop Configuration\n\n1. **Locate your Claude Desktop config file:**\n\n   - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n   - **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n   - **Linux**: `~/.config/Claude/claude_desktop_config.json`\n\n2. **Add the OLX MCP server to your configuration:**\n\n```json\n{\n  \"mcpServers\": {\n    \"olx-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"olx-mcp\"]\n    }\n  }\n}\n```\n\n3. **Restart Claude Desktop** to load the new configuration.\n\n### 🔄 Alternative: Global Installation\n\nIf you prefer to install globally:\n\n```bash\nnpm install -g olx-mcp\n```\n\nThen use this config:\n```json\n{\n  \"mcpServers\": {\n    \"olx-mcp\": {\n      \"command\": \"olx-mcp\"\n    }\n  }\n}\n```\n\n### 📦 Development: From Source\n\n```bash\ngit clone https://github.com/l-margiela/olx-mcp.git\ncd olx-mcp\nnpm install\nnpm run build\n```\n\nUse this config for development:\n```json\n{\n  \"mcpServers\": {\n    \"olx-mcp\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/olx-mcp/dist/index.js\"]\n    }\n  }\n}\n```\n\n## Usage\n\nOnce configured, you can use the following tools in your MCP client:\n\n### Search Listings\n\nSearch for listings on any supported OLX domain with various filters:\n\n```\nCan you search for \"apartments\" in \"Lisboa\" on OLX Portugal with a maximum price of 1000 euros?\n```\n\n```\nSearch for \"telefon\" in \"warszawa\" on OLX Poland with prices between 100-500 PLN?\n```\n\n**Parameters:**\n- `domain` (required): OLX domain ('olx.pt', 'olx.pl', 'olx.bg', 'olx.ro', 'olx.ua')\n- `query` (optional): Search term\n- `category` (optional): Category filter\n- `location` (optional): Location filter\n- `minPrice` (optional): Minimum price\n- `maxPrice` (optional): Maximum price\n- `page` (default: 1): Page number\n- `limit` (default: 20): Items per page\n- `sortBy` (default: 'relevance'): Sort order ('relevance', 'date', 'price-asc', 'price-desc')\n\n### Listing Details\n\nGet detailed information about a specific listing from any supported domain:\n\n```\nCan you get the details for listing \"ABC123\" from OLX Portugal?\n```\n\n```\nShow me details for listing \"XYZ789\" from OLX Poland including images?\n```\n\n**Parameters:**\n- `domain` (required): OLX domain ('olx.pt', 'olx.pl', 'olx.bg', 'olx.ro', 'olx.ua')\n- `listingId` (required): The ID of the listing\n- `includeImages` (default: false): Include image URLs\n- `includeSellerInfo` (default: true): Include seller information\n\n## Development\n\n### Scripts\n\n- `npm run build` - Build the TypeScript project\n- `npm run dev` - Run in development mode with hot reload\n- `npm start` - Run the built server\n- `npm test` - Run tests (when available)\n- `npm run clean` - Clean build artifacts\n\n## Troubleshooting\n\n### MCP Inspector\n\nFor debugging MCP communication, you can use the MCP Inspector:\n\n```bash\nnpx @modelcontextprotocol/inspector node dist/index.js\n```\n\n## License\n\nMIT License - see LICENSE file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fl-margiela%2Folx-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fl-margiela%2Folx-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fl-margiela%2Folx-mcp/lists"}