API pública
MCP
Para ligar o Claude, o ChatGPT ou outro assistente às ofertas e às tuas pesquisas guardadas. Só precisas deste endereço; não há campos para preencher, a app pede-te para entrares e autorizares.
https://radaremprego.com/api/mcp100 chamadas de ferramentas por dia. Como fazer em cada app: Claude, Claude Code, ChatGPT. Para outros assistentes e programas: llms.txt.
As ferramentas devolvem os mesmos campos por oferta e aceitam os mesmos filtros: no_portuguese, foreign_support, openings_min, funded, sort: "closing"; get_job junta as palavras do anúncio por trás de cada um.
Claude (claude.ai, Claude Desktop)
Planos Free (um conector), Pro, Max, Team e Enterprise. Em Team e Enterprise, quem administra a organização adiciona o conector primeiro.
- Abre Personalizar → Conectores (Customize → Connectors) e carrega em "+" / Adicionar (Add).
- Escolhe "Adicionar conector personalizado" (Add custom connector). Nome: Radar Emprego. URL: https://radaremprego.com/api/mcp. Não preenchas mais nada: nas opções avançadas fica a identidade publicada do Claude, sem Client ID nem secret.
https://radaremprego.com/api/mcp - Carrega em "Adicionar" e depois em "Ligar" (Connect).
- Abre-se a página de entrada do Radar Emprego: entra com o teu email (ligação mágica) ou com Google.

- Carrega em "permitir". A app passa a ver as tuas pesquisas guardadas, exclusões e avaliações, e mais nada. Desligas em Conta → Apps ligadas.

- Numa conversa, ativa o Radar Emprego no menu "+" → Conectores, e pede por exemplo: "enfermeiro em Coimbra com salário".
Claude Code
Qualquer conta Claude Code.
- No terminal (fica disponível em todos os teus projetos):
claude mcp add --transport http --scope user radar-emprego https://radaremprego.com/api/mcp - Dentro do Claude Code escreve /mcp, escolhe radar-emprego e "Authenticate": o browser abre.
- Abre-se a página de entrada do Radar Emprego: entra com o teu email (ligação mágica) ou com Google.
- Carrega em "permitir". A app passa a ver as tuas pesquisas guardadas, exclusões e avaliações, e mais nada. Desligas em Conta → Apps ligadas.
- Sem browser (CI, servidor): cria uma chave em Conta e junta ao comando:
--header "Authorization: Bearer emp_…"
ChatGPT
Planos Plus, Pro, Business, Enterprise e Edu, no site (chatgpt.com), com o modo de programador ligado.
- Abre Definições → Apps e conectores → Definições avançadas e liga o "Modo de programador" (Developer mode).
- Em Apps e conectores carrega em "Criar" (Create). Nome: Radar Emprego. URL do servidor MCP: https://radaremprego.com/api/mcp. Autenticação: OAuth. Marca "confio nesta aplicação" e cria.
https://radaremprego.com/api/mcp - Abre-se a página de entrada do Radar Emprego: entra com o teu email (ligação mágica) ou com Google.
- Carrega em "permitir". A app passa a ver as tuas pesquisas guardadas, exclusões e avaliações, e mais nada. Desligas em Conta → Apps ligadas.
- Numa conversa, escolhe "+" → Modo de programador → Radar Emprego e faz a pergunta.
O que tem
O trabalho que fazemos sobre cada anúncio, em JSON:
- salário bruto normalizado por mês, se foi confirmado no anúncio, e o líquido estimado
- profissão ESCO / ISCO-08 e área
- uma oferta por emprego, com todas as fontes onde aparece (sem duplicados)
- concelhos e, quando o anúncio o diz, o local de trabalho exato
- horário (turnos, noites, fins de semana), regime, contrato, requisitos, línguas
- resumos escritos por IA, em português e em inglês
- o que o anúncio diz: número de vagas, se pede português, apoio a quem vem de fora (visto, mudança, alojamento), estágio IEFP ou contratação apoiada
- a data-limite de candidatura, só quando a fonte a diz de facto
O texto original do anúncio não faz parte da API: pertence à sua fonte. Cada oferta traz as ligações para o anúncio original, onde a candidatura acontece.
Pedidos
Cria uma chave (grátis) em conta e envia-a em cada pedido:
curl -H "Authorization: Bearer emp_…" \ "https://radaremprego.com/api/v1/jobs?concelho=Porto&area=saude&lang=en" curl -H "Authorization: Bearer emp_…" "https://radaremprego.com/api/v1/jobs/12345"
GET /api/v1/jobs— ofertas ativas que cumprem o filtro; os parâmetros são os da página de pesquisa (copia o URL de uma pesquisa no site). No máximo 20 por página; seguenext.GET /api/v1/jobs/{id}— tudo o que sabemos de uma oferta. Uma oferta juntada a outra (o mesmo anúncio visto duas vezes) responde308para essa, commerged_into.lang=en— rótulos, resumos e ligações em inglês.sem_pt=1,apoio=1,vagas=2,iefp=1|estagio|contrato,sort=closing— português não obrigatório, apoio a quem vem de fora, várias vagas, estágio IEFP ou contratação apoiada, prazo mais próximo primeiro.evitar=vendas|publico|telefone,so=vendas— sem vendas, sem atendimento ao público, sem trabalho ao telefone (seja qual for a área); ou só esse tipo de trabalho.
Campos de cada oferta além do salário e da profissão:
openings—{min, max, many, label}ounullportuguese—required|plus|not_required|null(o anúncio não diz)support—[{token, text, help}]: visa, relocation, housing, welcome, pt_lessons (ajuda), no_sponsorship, permit_requiredprogramme—{kind: internship|hire, label, measures, eligibility}ounullcloses_on— data-limite verificada (AAAA-MM-DD) ounull;valid_throughé a data da fonte, tal como vemcompany.id— o valor do filtrocompany=
Limites
- 100 pedidos por dia por conta (todas as chaves somadas), renova às 00:00 UTC; mais no Plus.
- 10 pedidos seguidos, depois um a cada 5 s.
- Cabeçalhos
X-RateLimit-Remaining,X-RateLimit-Reset; acima do limite:429comRetry-After.
Sem código
Para mostrar as ofertas de um concelho noutro site, sem chave: uma moldura, um feed RSS ou JSON, e um plugin WordPress, em ofertas para o seu site.
Condições
- Mostra a ligação para a oferta ou para o anúncio original junto de cada oferta.
- Assinala os resumos como escritos por IA.
- Não revendas os dados como estão.