# Careerjet Job Search MCP Server

Bu proje, [Careerjet API](https://www.careerjet.com/partners/api/) kullanarak iş arama işlevselliği sağlayan bir MCP (Model Context Protocol) server'ıdır.

## Özellikler

- **İş Arama**: Anahtar kelimeler ve lokasyon ile iş arama
- **Gelişmiş Filtreleme**: Sözleşme türü, çalışma süresi, maaş sıralaması
- **Çoklu Dil Desteği**: 50+ ülke ve dil desteği
- **MCP Uyumlu**: AI asistanları ile kolay entegrasyon

## Kurulum

### Gereksinimler

- Python 3.11+
- pip
- Geçerli Careerjet API anahtarı

### Adımlar

1. **Bağımlılıkları yükleyin:**
```bash
pip install -r requirements.txt
```

2. **API Anahtarınızı yapılandırın:**
   - Varsayılan API anahtarı: `371d48447450886ce16b718533cca6f2`
   - Kendi API anahtarınızı almak için: [Careerjet Partners](https://www.careerjet.com/partners/api/)

3. **MCP Server'ı çalıştırın:**
```bash
python server.py
```

### Docker ile Kurulum

```bash
# Docker image'ı oluşturun
docker build -t careerjet-mcp .

# Container'ı çalıştırın
docker run -it careerjet-mcp
```

## Kullanım

### MCP Tools

#### 1. `search_jobs_tool`
İş arama işlevi.

**Parametreler:**
- `keywords` (zorunlu): Aranacak anahtar kelimeler
- `location` (zorunlu): İş lokasyonu
- `locale`: Dil/ülke kodu (varsayılan: en_US)
- `affid`: Careerjet API anahtarı (varsayılan: 371d48447450886ce16b718533cca6f2)
- `sort`: Sıralama türü (relevance, date, salary)
- `pagesize`: Sayfa başına sonuç sayısı
- `contracttype`: Sözleşme türü (p=permanent, c=contract, t=temporary)
- `contractperiod`: Çalışma süresi (f=full time, p=part time)

**Örnek:**
```python
# Python developer işleri London'da ara
result = search_jobs_tool(
    keywords="python developer",
    location="London",
    locale="en_GB",
    affid="371d48447450886ce16b718533cca6f2",
    sort="salary",
    pagesize=20
)
```

#### 2. `get_job_details_tool`
İş detayları alma (temel implementasyon).

### Desteklenen Lokaller

- `en_US` - Amerika Birleşik Devletleri
- `en_GB` - Birleşik Krallık  
- `de_DE` - Almanya
- `fr_FR` - Fransa
- `es_ES` - İspanya
- `it_IT` - İtalya
- `tr_TR` - Türkiye
- Ve daha fazlası...

## Konfigürasyon

### Smithery.yaml

MCP client'larda kullanım için `smithery.yaml` dosyası mevcuttur:

```yaml
startCommand:
  type: stdio
  configSchema:
    type: object
    properties:
      affid:
        type: string
        description: "Careerjet Affiliate ID"
        default: "371d48447450886ce16b718533cca6f2"
      locale:
        type: string
        description: "Varsayılan dil kodu"
        default: "en_US"
```

### Affiliate ID

Careerjet API kullanımı için bir Affiliate ID gereklidir. Ücretsiz hesap için:
1. [Careerjet Partners](http://www.careerjet.co.uk/partners) sayfasını ziyaret edin
2. Partner hesabı oluşturun
3. Aldığınız Affiliate ID'yi kullanın

**Varsayılan API Anahtarı:** `371d48447450886ce16b718533cca6f2`

## API Limitleri

- Careerjet API'sinin kullanım sıklığı limitleri vardır
- Yoğun kullanım için Careerjet ile iletişime geçin
- Rate limiting uygulanabilir

## Geliştirme

### Proje Yapısı

```
├── app.py              # Ana iş mantığı
├── server.py           # MCP server implementasyonu
├── requirements.txt    # Python bağımlılıkları
├── smithery.yaml      # MCP konfigürasyonu
├── Dockerfile         # Docker konfigürasyonu
├── test_samsun.py     # Test dosyası
└── README.md          # Bu dosya
```

### Test

```bash
# Samsun için test
python test_samsun.py

# Basit test
python -c "from app import search_jobs; print(search_jobs('python', 'London'))"
```

## Lisans

MIT License

## Katkıda Bulunma

1. Fork edin
2. Feature branch oluşturun
3. Değişikliklerinizi commit edin
4. Pull request gönderin

## İletişim

Bu proje [GitHub](https://github.com/rftsngl/Careerjet_MCPv2) üzerinde geliştirilmektedir.

## Sürüm Geçmişi

- **v2.0**: API anahtarı güncellendi ve geliştirmeler yapıldı
- **v1.0**: İlk sürüm