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
Kurulum
Gereksinimler
- Python 3.11+
- pip
- Geçerli Careerjet API anahtarı
Adımlar
- Bağımlılıkları yükleyin:
pip install -r requirements.txt
-
API Anahtarınızı yapılandırın:
- Varsayılan API anahtarı:
371d48447450886ce16b718533cca6f2 - Kendi API anahtarınızı almak için: Careerjet Partners
- Varsayılan API anahtarı:
-
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 kelimelerlocation(zorunlu): İş lokasyonulocale: 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 Devletlerien_GB- Birleşik Krallıkde_DE- Almanyafr_FR- Fransaes_ES- İspanyait_IT- İtalyatr_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:
- Careerjet Partners sayfasını ziyaret edin
- Partner hesabı oluşturun
- 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
- Fork edin
- Feature branch oluşturun
- Değişikliklerinizi commit edin
- 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