Przejdź do głównej treści

​
Dostępne narzędzia MCP

Serwer Hexjobs MCP udostępnia kilka narzędzi do wyszukiwania i analizowania ofert pracy. Wszystkie narzędzia zwracają dane w strukturalnym formacie JSON i obsługują błędy w sposób bezpieczny.

​
Podstawowe narzędzia wyszukiwania

Główne narzędzie wyszukiwania z zaawansowanym filtrowaniem i semantycznym wyszukiwaniem napędzanym AI. Parametry:
ParametrTypWymaganyOpis
querystringNieZapytanie wyszukiwania (np. “programista python”, “CTO”)
countrystringNieKod kraju: “PL”, “DE”, “AT”, “UA”
citiesarray[string]NieFiltruj według miast (np. [“Warszawa”, “Kraków”])
categoriesarray[string]NieKategorie ofert (np. [“IT”, “Marketing”])
experience_levelsarray[string]NiePoziomy doświadczenia (np. [“junior”, “mid”, “senior”])
contract_typesarray[string]NieTypy umów (np. [“B2B”, “UoP”])
work_modesarray[string]NieTryby pracy (np. [“office”, “hybrid”, “remote”])
companiesarray[string]NieFiltruj według nazw firm
is_remotebooleanNieFiltruj tylko oferty zdalne
min_salaryfloatNieMinimalne wynagrodzenie
limitintegerNieLiczba wyników (max 100, domyślnie 20)
offsetintegerNieOffset paginacji (domyślnie 0)
Zwraca: 
{
  "offers": [
    {
      "slug": "python-developer-company-123",
      "title": "Senior Python Developer",
      "company": {
        "name": "Tech Company",
        "logo": "https://..."
      },
      "location": {
        "city": "Warszawa",
        "country": "Poland"
      },
      "category": "IT",
      "experienceLevels": ["senior"],
      "contractTypes": ["B2B", "UoP"],
      "workModes": ["hybrid", "remote"],
      "salary": {
        "min": 15000,
        "max": 25000,
        "currency": "PLN"
      },
      "publishedAt": "2026-01-15T10:00:00Z",
      "url": "https://hexjobs.com/offer/python-developer-company-123"
    }
  ],
  "total": 156,
  "limit": 20,
  "offset": 0
}
Przykład użycia: 
Wyszukaj oferty senior Python w Warszawie z minimalnym wynagrodzeniem 15000 PLN

​
offer

Pobierz szczegółowe informacje o konkretnej ofercie pracy. Parametry:
ParametrTypWymaganyOpis
slugstringTakSlug oferty pracy (unikalny identyfikator)
Zwraca: 
{
  "slug": "python-developer-company-123",
  "title": "Senior Python Developer",
  "description": "Pełny opis stanowiska...",
  "requirements": "Wymagania...",
  "responsibilities": "Główne obowiązki...",
  "benefits": "Benefity firmowe...",
  "company": {
    "name": "Tech Company",
    "description": "Informacje o firmie...",
    "logo": "https://...",
    "website": "https://..."
  },
  "location": {
    "city": "Warszawa",
    "country": "Poland",
    "address": "Ulica 123",
    "isRemote": true
  },
  "salary": {
    "min": 15000,
    "max": 25000,
    "currency": "PLN"
  },
  "insights": {
    "summary": "Podsumowanie wygenerowane przez AI",
    "keySkills": ["Python", "Django", "PostgreSQL"],
    "suitableFor": "Doświadczeni programiści backend"
  }
}

​
offers_count

Pobierz całkowitą liczbę ofert pracy spełniających określone filtry bez zwracania faktycznych ofert. Parametry: Takie same jak narzędzie search (z wyjątkiem limit i offset) Zwraca: 
{
  "count": 156,
  "query": "python developer",
  "filters": {
    "country": "PL",
    "cities": ["Warszawa"]
  }
}

​
Narzędzia do danych rynkowych

​
available_categories

Pobierz wszystkie dostępne kategorie ofert pracy wraz z liczbą ofert. Parametry: Brak Zwraca: 
{
  "categories": [
    {
      "name": "IT",
      "count": 5432
    },
    {
      "name": "Marketing",
      "count": 1234
    }
  ],
  "total": 15
}

​
available_countries

Pobierz wszystkie dostępne kraje/regiony wraz z liczbą ofert pracy. Parametry: Brak Zwraca: 
{
  "countries": [
    {
      "name": "PL",
      "count": 8765
    },
    {
      "name": "DE",
      "count": 3456
    }
  ],
  "total": 4
}

​
available_experience_levels

Pobierz wszystkie dostępne poziomy doświadczenia wraz z liczbą ofert. Parametry: Brak Zwraca: 
{
  "experience_levels": [
    {
      "name": "junior",
      "count": 1234
    },
    {
      "name": "mid",
      "count": 4567
    },
    {
      "name": "senior",
      "count": 2345
    }
  ],
  "total": 5
}

​
available_contract_types

Pobierz wszystkie dostępne typy umów wraz z liczbą ofert. Parametry: Brak Zwraca: 
{
  "contract_types": [
    {
      "name": "B2B",
      "count": 4567
    },
    {
      "name": "UoP",
      "count": 3456
    }
  ],
  "total": 4
}

​
available_work_modes

Pobierz wszystkie dostępne tryby pracy wraz z liczbą ofert. Parametry: Brak Zwraca: 
{
  "work_modes": [
    {
      "name": "remote",
      "count": 3456
    },
    {
      "name": "hybrid",
      "count": 4567
    },
    {
      "name": "office",
      "count": 1234
    }
  ],
  "total": 3
}

​
Najlepsze praktyki

​
Efektywne wyszukiwanie

  1. Używaj konkretnych zapytań - bardziej szczegółowe zapytania zwracają lepsze wyniki
  2. Łącz filtry - użyj wielu filtrów, aby zawęzić wyniki
  3. Używaj paginacji dla dużych wyników - użyj limit i offset dla dużych zestawów wyników
  4. Najpierw sprawdź liczby - użyj offers_count przed pobieraniem pełnych wyników

​
Przykłady zapytań

Znajdź oferty Python

​
Obsługa błędów

Wszystkie narzędzia zwracają przyjazne dla użytkownika komunikaty błędów: 
{
  "error": "Nie można przetworzyć zapytania wyszukiwania. Spróbuj ponownie lub dostosuj filtry.",
  "offers": [],
  "total": 0
}

​
Limity zapytań

Serwer MCP stosuje standardowe limity fair-use:
  • Maksymalnie 100 wyników na zapytanie
  • Oczekiwana rozsądna częstotliwość zapytań
  • Brak twardych limitów dla normalnego użytkowania

​
Wskazówki i sztuczki

Użyj narzędzi danych rynkowych (available_categories, available_countries itp.), aby odkryć, jakie filtry są dostępne przed konstruowaniem złożonych zapytań.
Parametr limit jest ograniczony do 100 wyników na zapytanie. Dla większych zestawów danych użyj paginacji z offset.
Wyszukiwanie semantyczne jest automatycznie włączane podczas używania narzędzia search z ciągiem zapytania. Rozumie kontekst i synonimy.