https://github.com/l-margiela/olx-mcp
OLX MCP server. 100% vibe-coded AI slop
https://github.com/l-margiela/olx-mcp
mcp mcp-server model-context-protocol model-context-protocol-server model-context-protocol-servers olx
Last synced: about 1 month ago
JSON representation
OLX MCP server. 100% vibe-coded AI slop
- Host: GitHub
- URL: https://github.com/l-margiela/olx-mcp
- Owner: l-margiela
- License: mit
- Created: 2025-09-02T16:42:22.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-09-03T06:08:37.000Z (6 months ago)
- Last Synced: 2025-10-17T06:52:01.782Z (5 months ago)
- Topics: mcp, mcp-server, model-context-protocol, model-context-protocol-server, model-context-protocol-servers, olx
- Language: TypeScript
- Homepage:
- Size: 610 KB
- Stars: 2
- Watchers: 0
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
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
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:**
```json
{
"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:
```bash
npm install -g olx-mcp
```
Then use this config:
```json
{
"mcpServers": {
"olx-mcp": {
"command": "olx-mcp"
}
}
}
```
### 📦 Development: From Source
```bash
git clone https://github.com/l-margiela/olx-mcp.git
cd olx-mcp
npm install
npm run build
```
Use this config for development:
```json
{
"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:
```bash
npx @modelcontextprotocol/inspector node dist/index.js
```
## License
MIT License - see LICENSE file for details.