# Marketfiyati MCP Server

A Model Context Protocol (MCP) server for accessing Turkish market product prices from [marketfiyati.org.tr](https://marketfiyati.org.tr). This server provides a standardized API for searching products across different Turkish supermarket chains (BIM, A101, Migros, SOK, etc.) and comparing prices.

## Disclaimer

This is an **educational project** created for learning purposes. It is **not intended for commercial use**. All data is sourced from [marketfiyati.org.tr](https://marketfiyati.org.tr). Please respect their terms of service and use this project responsibly.

## Features

- 🔍 Search products by keywords and categories
- 📍 Location-based search with nearby stores
- 🏪 Multi-market price comparison
- 💰 Price tracking and unit price calculations
- 🚀 Fast response with intelligent caching
- 🔌 MCP-compatible for easy integration with AI tools

## Installation

### Using Docker (Recommended)

```bash
# Pull the pre-built image
docker pull ghcr.io/yibudak/marketfiyati_mcp:latest

# Run the container
docker run -d -p 8000:8000 --name marketfiyati-mcp ghcr.io/yibudak/marketfiyati_mcp:latest

# Run with SOCKS proxy (optional)
docker run -d -p 8000:8000 -e SOCKS_PROXY=socks5://localhost:1080 --name marketfiyati-mcp ghcr.io/yibudak/marketfiyati_mcp:latest
```

The server will be available at <http://localhost:8000>

### Manual Installation

```bash
# Clone the repository
git clone https://github.com/yibudak/marketfiyati_mcp.git
cd marketfiyati_mcp

# Install dependencies
pip install -r requirements.txt

# Run the server
uvicorn app.main:app --port 8000

# Run with SOCKS proxy (optional)
SOCKS_PROXY=socks5://localhost:1080 uvicorn app.main:app --port 8000
```

## API Endpoints

The server provides the following endpoints:

- **POST /search_by_categories** - Search products with detailed filters (keywords, location, depot IDs)
- **GET /search_by_categories** - Simple product search via query parameters
- **GET /health** - Health check endpoint (includes version info)
- **GET /version** - Get API version
- **GET /docs** - Interactive API documentation (Swagger UI)
- **GET /mcp** - MCP protocol endpoint for AI tool integration

For detailed API documentation, visit <http://localhost:8000/docs> after starting the server.

## SOCKS Proxy Configuration

The server supports SOCKS proxy for all external API calls to marketfiyati.org.tr. This is useful when you need to route requests through a proxy server.

### Supported Proxy Types

- SOCKS5 (recommended): `socks5://host:port`
- SOCKS5 with authentication: `socks5://username:password@host:port`
- SOCKS4: `socks4://host:port`

### Configuration Methods

#### Environment Variable

Set the `SOCKS_PROXY` environment variable before starting the server:

```bash
# Linux/macOS
export SOCKS_PROXY=socks5://localhost:1080
uvicorn app.main:app --port 8000

# Windows (PowerShell)
$env:SOCKS_PROXY="socks5://localhost:1080"
uvicorn app.main:app --port 8000

# Windows (Command Prompt)
set SOCKS_PROXY=socks5://localhost:1080
uvicorn app.main:app --port 8000
```

#### Docker

Pass the proxy configuration as an environment variable:

```bash
docker run -d -p 8000:8000 \
  -e SOCKS_PROXY=socks5://localhost:1080 \
  --name marketfiyati-mcp \
  ghcr.io/yibudak/marketfiyati_mcp:latest
```

### Example Proxy Configurations

```bash
# Local SOCKS5 proxy (e.g., SSH tunnel)
SOCKS_PROXY=socks5://localhost:1080

# Remote SOCKS5 proxy with authentication
SOCKS_PROXY=socks5://myuser:mypass@proxy.example.com:1080

# SOCKS4 proxy
SOCKS_PROXY=socks4://proxy.example.com:1080
```

### Creating a SOCKS Proxy with SSH

You can create a local SOCKS5 proxy using SSH:

```bash
# Create an SSH tunnel that acts as a SOCKS5 proxy on port 1080
ssh -D 1080 -C -N user@remote-server.com

# Then run the server with the proxy
SOCKS_PROXY=socks5://localhost:1080 uvicorn app.main:app --port 8000
```

## Using with Claude Desktop

Add the following configuration to your Claude Desktop config file:

**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`

**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

```json
{
  "mcpServers": {
    "marketfiyati": {
      "url": "http://localhost:8000/mcp"
    }
  }
}
```

After adding the configuration, restart Claude Desktop. The MCP server will be available for product price searches.

## License

This project is licensed under the MIT License.

## Acknowledgments

- Data provided by [marketfiyati.org.tr](https://marketfiyati.org.tr)

## Support

For issues and questions, please open an issue on [GitHub](https://github.com/yibudak/marketfiyati_mcp/issues).