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

Adımlar

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

pip install -r requirements.txt

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

HTTP API Server

API server'ı başlatmak için:

python api_server.py

Server http://localhost:5000 adresinde çalışacaktır.

API Endpoints

GET / - Sağlık kontrolü
GET /api/jobs/search - İş arama
GET /api/jobs/details - İş detayları

Örnek API Kullanımı

# Sağlık kontrolü
curl http://localhost:5000/

# İş arama
curl "http://localhost:5000/api/jobs/search?keywords=developer&location=Istanbul&locale=tr_TR"

# İş detayları
curl "http://localhost:5000/api/jobs/details?url=https://example.com/job/1"

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)
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",
    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: "213e213hd12344552"
      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

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
└── README.md          # Bu dosya

Test

# 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

Destek

Sorularınız için issue açabilirsiniz.

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Enables job searching functionality using Careerjet API with features like keyword and location-based searches, advanced filtering, and multi-language support across 50+ countries.

Related MCP Servers

Find Flights MCP Server
ravinahp
A
security
A
license
A
quality
Enables searching and retrieving detailed flight information using the Duffel API, supporting various flight types and flexible search parameters for efficient travel planning.
Last updated -
3
92
Python
MIT License
Google Jobs MCP Server
ChanMeng666
A
security
A
license
A
quality
A Model Context Protocol server that provides Google Jobs search capabilities through SerpAPI integration, featuring multi-language support, flexible search parameters, and rich job details.
Last updated -
1
10
9
JavaScript
MIT License
AI Agent Marketplace Index Search
AI-Agent-Hub
-
security
F
license
-
quality
Enables searching for AI agents by keywords or categories, allowing users to discover tools like coding agents, GUI agents, or industry-specific assistants across marketplaces.
Last updated -
23
Python
HireBase MCP Server
jhgaylor
A
security
A
license
A
quality
Provides tools to interact with the HireBase Job API, enabling users to search for jobs using various criteria and retrieve detailed job information through natural language.
Last updated -
2
2
Python
MIT License

View all related MCP servers

Careerjet Job Search MCP Server