{"ok":true,"site":"tyomarkkinatori","host":"tyomarkkinatori.fi","about":"Työmarkkinatori (tyomarkkinatori.fi), the Finnish public employment services portal. This CLI searches open job postings and reads their details, searches public trainings and services and reads course and service details, lists occupation info pages, and reads the code lists the site's filters use (municipalities, regions, working time, languages and so on).","commands":[{"command":"search-jobs","summary":"Full-text search of open job postings, with optional municipality and publish-date filters, sorting and paging","params":[{"name":"query","type":"string","required":true,"description":"Search keyword(s), e.g. an occupation or employer name"},{"name":"municipality","type":"string","description":"Municipality code (KUNTA code list, e.g. 837 = Tampere, 091 = Helsinki). Use list-codes --codeset KUNTA to look codes up."},{"name":"publishedAfter","type":"string","description":"Only postings published after this ISO timestamp. The UI's 'within 1 month' option sends now minus 1 month."},{"name":"sort","type":"string","description":"Sort order: LATEST = newest first, CLOSING = nearest application deadline first","oneOf":["LATEST","CLOSING"],"default":"LATEST"},{"name":"page","type":"number","description":"Zero-based page number","default":0},{"name":"pageSize","type":"number","description":"Results per page","default":30}],"exampleUrl":"https://clify-dev.netlify.app/tyomarkkinatori/search-jobs"},{"command":"get-job-posting","summary":"Get the full public details of one job posting by its UUID: description, employer, location, contacts, application info","params":[{"name":"id","type":"string","required":true,"description":"Job posting UUID (the id field from search-jobs)"}],"exampleUrl":"https://clify-dev.netlify.app/tyomarkkinatori/get-job-posting"},{"command":"list-codes","summary":"List the codes in a KOPA code list, e.g. municipalities, regions, working time, employment relationship or languages. Use these codes to interpret job posting fields and job search filters.","params":[{"name":"codeset","type":"string","required":true,"description":"Code list name","oneOf":["KUNTA","MAAKUNTA","MAA","TYÖAIKA","PALVELUSSUHDE","TYÖN_JATKUVUUS","TYÖSKENTELYAIKA","MÄÄRÄAIKAISUUDEN_KESTO","KIELI","PALKAN_PERUSTE","PALKKAHAITARI","AJOKORTTILUOKKA","TYÖNHAKUPROFIILI_LUPA_KORTTI","ESCO_AMMATTI","ESCO_OSAAMINEN","TYÖPAIKKAILMOITUKSEN_LÄHDE","TYOPAIKKAILMOITUS_RIKOSREKISTERIOTE","TYÖPAIKKAILMOITUKSEN_ESTÄMISEN_PERUSTE"]},{"name":"validOn","type":"string","required":true,"description":"Return codes valid on this date (YYYY-MM-DD), normally today"}],"exampleUrl":"https://clify-dev.netlify.app/tyomarkkinatori/list-codes?validOn=2026-10-18"},{"command":"list-isco-occupations","summary":"Get the ISCO occupation group hierarchy (notation codes with fi/sv/en labels and nested narrower groups). Job search uses these as occupation groups.","params":[],"exampleUrl":"https://clify-dev.netlify.app/tyomarkkinatori/list-isco-occupations"},{"command":"search-trainings","summary":"Search public trainings and services (courses, labour market training) by keyword, with offset paging","params":[{"name":"query","type":"string","required":true,"description":"Search term, e.g. an occupation or subject"},{"name":"pageSize","type":"number","description":"Results per page","default":20},{"name":"offset","type":"number","description":"Number of results to skip","default":0}],"exampleUrl":"https://clify-dev.netlify.app/tyomarkkinatori/search-trainings"},{"command":"get-training","summary":"Get one training or course implementation by token: dates, location, description, language requirements, registration link and provider","params":[{"name":"token","type":"string","required":true,"description":"Service implementation token (UUID; the token from search-trainings or the /kurssi/{token}/ URL)"}],"exampleUrl":"https://clify-dev.netlify.app/tyomarkkinatori/get-training"},{"command":"get-service","summary":"Get the general description of a service or training product (description, requirements, target groups, category, its offerings) by service token","params":[{"name":"token","type":"string","required":true,"description":"Service token (UUID; serviceOffering.service.token from get-training or search-trainings)"}],"exampleUrl":"https://clify-dev.netlify.app/tyomarkkinatori/get-service"},{"command":"list-service-categories","summary":"List the service and training categories (codes like PK1, PK7.3 with names) used in the trainings and services catalogue","params":[{"name":"language","type":"string","description":"Label language","oneOf":["fi","sv","en"],"default":"fi"}],"exampleUrl":"https://clify-dev.netlify.app/tyomarkkinatori/list-service-categories"},{"command":"list-service-codes","summary":"List a code set used by the trainings and services catalogue, e.g. target groups, language skill levels or education codes","params":[{"name":"codeset","type":"string","required":true,"description":"Code set name","oneOf":["KOHDERYHMÄLUOKAT","KIELITAIDON_TASO","TYÖNHAKUPROFIILI_KOULUTUS","KURSSI_PERUMISSYY","ESCO_AMMATTI","ESCO_OSAAMINEN"]},{"name":"language","type":"string","description":"Label language","oneOf":["fi","sv","en"],"default":"fi"}],"exampleUrl":"https://clify-dev.netlify.app/tyomarkkinatori/list-service-codes"},{"command":"list-professions","summary":"List all occupations that have an occupation info page (label and slug path), for use with get-profession","params":[{"name":"locale","type":"string","description":"Language","default":"fi"}],"exampleUrl":"https://clify-dev.netlify.app/tyomarkkinatori/list-professions?locale=fi"},{"command":"list-profession-fields","summary":"List occupational fields (ammattialat) with their info page paths","params":[{"name":"locale","type":"string","description":"Language","default":"fi"}],"exampleUrl":"https://clify-dev.netlify.app/tyomarkkinatori/list-profession-fields?locale=fi"},{"command":"get-profession","summary":"Read an occupation info page (job description, education, outlook) by slug","params":[{"name":"slug","type":"string","required":true,"description":"Occupation slug, the last segment of path in list-professions (e.g. sairaanhoitaja)"}],"exampleUrl":"https://clify-dev.netlify.app/tyomarkkinatori/get-profession"}]}