Careerjet Job Search MCP Server

Bu proje, Careerjet 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

Related MCP server: mcp-adzuna

Kurulum

Gereksinimler

• Python 3.11+

• pip

• Geçerli Careerjet API anahtarı

Adımlar

1. Bağımlılıkları yükleyin:

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

3. MCP Server'ı çalıştırın:

python server.py

Docker ile Kurulum

# 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 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:

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 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

# 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 ü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