Pro vývojáře a AI agenty

Data Sítě práce jsou dostupná jako veřejné JSON API bez registrace a bez API klíče. Pro AI asistenty nabízíme OpenAPI schéma a MCP server, přes který Claude, ChatGPT nebo Cursor umí hledat nabídky, porovnat platy a uložit hlídač. Odpověď na nabídku a kontakt s odborníkem provádí vždy člověk na webu.

Veřejné JSON API

Základ je https://sitprace.cz/api/public/. Odpovědi jsou JSON v češtině, cachované, bez stránkování. Popis všech endpointů včetně parametrů je v interaktivní dokumentaci a ve strojově čitelném OpenAPI schématu.

Metoda	Cesta	Co vrací
GET	/api/public/	Rozcestník všech endpointů a akcí (discovery).
GET	/api/public/jobs/search.json?query=…&city=…&radius_km=25	Hledání nabídek větou nebo klíčovými slovy; obec, okruh, obor; max. 50 výsledků + search_url.
POST	/api/public/alerts/subscribe.json	Uložit hlídač nových nabídek — aktivuje se až po potvrzení e-mailem.
GET	/api/public/jobs/latest.json	Nejnovějších 100 pracovních nabídek.
GET	/api/public/providers/latest.json	Nejnovějších 100 ověřených odborníků.
GET	/api/public/categories.json	Katalog oborů (slug, název, applies_to: job / service / both).
GET	/api/public/salaries.json	Mzdové mediány podle profese, měsíčně (?month=RRRR-MM).
GET	/api/public/salaries/trends.json?category=<slug>	Vývoj mezd v čase pro jednu profesi.
GET	/api/public/guides.json	Katalog průvodců (rady pro uchazeče i zaměstnavatele).
GET	/api/public/stats.json	Souhrnné statistiky platformy.

curl "https://sitprace.cz/api/public/jobs/search.json?query=řidič&city=Brno&radius_km=30"

MCP server

Model Context Protocol server běží na adrese https://sitprace.cz/api/public/mcp/ (Streamable HTTP, bezstavový, JSON přes POST, bez přihlášení). Nástroje:

search_jobs — hledání nabídek (query, city, radius_km, category, limit)
latest_jobs — nejnovější nabídky
list_categories — obory, volitelně jen pro práci nebo služby (side)
salary_benchmark — mzdové mediány podle profese (category, month)
salary_trends — vývoj mezd v čase (category)
site_stats — statistiky portálu
list_guides — katalog průvodců
parse_search — rozbor věty na filtry a hotovou URL (text, side)
save_job_alert — uložit hlídač — e-mail, query, city, radius_km; aktivace potvrzením e-mailem

Claude Code

claude mcp add --transport http sitprace https://sitprace.cz/api/public/mcp/

Claude Desktop / Claude.ai (vlastní konektor)

Nastavení → Konektory → Přidat vlastní konektor → URL serveru https://sitprace.cz/api/public/mcp/. Nebo do claude_desktop_config.json:

{
  "mcpServers": {
    "sitprace": {
      "type": "http",
      "url": "https://sitprace.cz/api/public/mcp/"
    }
  }
}

ChatGPT (Developer mode)

Settings → Connectors → Create → MCP server URL https://sitprace.cz/api/public/mcp/, Authentication: No authentication. Pro vlastní GPT lze místo toho použít OpenAPI schéma https://sitprace.cz/api/public/schema/ jako Actions.

Cursor / VS Code / jiní klienti

{
  "mcpServers": {
    "sitprace": {
      "url": "https://sitprace.cz/api/public/mcp/"
    }
  }
}

Přímo přes HTTP

curl -X POST https://sitprace.cz/api/public/mcp/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_jobs","arguments":{"query":"kuchař v Praze"}}}'

Limity a pravidla

Čtení: 10 000 požadavků za hodinu na IP; hledání a rozbor věty 300 za hodinu.
Uložení hlídače: 10 za hodinu na IP; hlídač se zapne až po kliknutí na odkaz v potvrzovacím e-mailu, nejvýše 3 aktivní hlídače na e-mail zdarma.
Agent neumí odpovědět na nabídku, kontaktovat odborníka ani vytvořit inzerát — tyto kroky vyžadují přihlášeného člověka na webu.
Interní API (/api/jobs/, /api/providers/, /api/core/) není garantované; pro integrace používejte výhradně /api/public/.
Data lze citovat a využívat pod licencí CC BY 4.0 s uvedením zdroje sitprace.cz a odkazem na konkrétní nabídku nebo stránku.
Osobní údaje uchazečů veřejné API neobsahuje; kontakty zaměstnavatelů jsou jen ty, které sami zveřejnili v inzerátu.

Další zdroje

llms.txt — shrnutí webu pro jazykové modely
Interaktivní dokumentace API
OpenAPI 3 schéma
Měsíční přehled platů — citovatelný HTML report
O nás a podmínky

Chybí vám endpoint nebo nástroj? Napište na podpora@sitprace.cz.