cores
radaremprego

API pública

Ligar um assistente

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/mcp

100 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.

  1. Abre Personalizar → Conectores (Customize → Connectors) e carrega em "+" / Adicionar (Add).
  2. 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
  3. Carrega em "Adicionar" e depois em "Ligar" (Connect).
  4. Abre-se a página de entrada do Radar Emprego: entra com o teu email (ligação mágica) ou com Google.Abre-se a página de entrada do Radar Emprego: entra com o teu email (ligação mágica) ou com Google.
  5. 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.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.
  6. 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.

  1. No terminal (fica disponível em todos os teus projetos):
    claude mcp add --transport http --scope user radar-emprego https://radaremprego.com/api/mcp
  2. Dentro do Claude Code escreve /mcp, escolhe radar-emprego e "Authenticate": o browser abre.
  3. Abre-se a página de entrada do Radar Emprego: entra com o teu email (ligação mágica) ou com Google.
  4. 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.
  5. 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.

  1. Abre Definições → Apps e conectores → Definições avançadas e liga o "Modo de programador" (Developer mode).
  2. 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
  3. Abre-se a página de entrada do Radar Emprego: entra com o teu email (ligação mágica) ou com Google.
  4. 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.
  5. Numa conversa, escolhe "+" → Modo de programador → Radar Emprego e faz a pergunta.
API pública

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; segue next.
  • GET /api/v1/jobs/{id} — tudo o que sabemos de uma oferta. Uma oferta juntada a outra (o mesmo anúncio visto duas vezes) responde 308 para essa, com merged_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} ou null
  • portuguese — 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_required
  • programme — {kind: internship|hire, label, measures, eligibility} ou null
  • closes_on — data-limite verificada (AAAA-MM-DD) ou null; valid_through é a data da fonte, tal como vem
  • company.id — o valor do filtro company=

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: 429 com Retry-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.
letra A/B