Remote Jobs MCP

Ao conectar-se ao servidor público Jobicy MCP, suas ferramentas de IA podem pesquisar, filtrar e recuperar de forma autônoma as listagens de empregos remotos mais recentes em tempo real.

Ver em jobicy.comExperimente este MCPPatrocinado

Documentação

Nesta página

Um endpoint para vagas remotas atuais.

A API pública de Vagas retorna as listagens remotas mais recentes disponíveis no Jobicy. Use-a para produtos de descoberta de empregos, ferramentas de pesquisa, sites comunitários, painéis internos e protótipos.

FORMATO

JSON limpo

Campos estruturados para empregador, função, localização, tipo de vaga, descrição e salário.

ACESSO

Sem chave de API

Comece com uma simples solicitação GET. Nenhuma conta ou cabeçalho de autenticação é necessário; url retorna a listagem do Jobicy.

RESULTADOS

Até 200 vagas

Recupere os registros mais recentes e combine filtros de localização, categoria e palavras-chave.

GET https://jobicy.com/api/v2/remote-jobs

02 · Início rápido

Do zero à primeira resposta.

Comece com o endpoint público, adicione apenas os filtros necessários e mantenha a URL da listagem do Jobicy ao exibir uma vaga.

  1. Envie uma solicitação GET Nenhum token ou conta é necessário para a API pública de Vagas.
  2. Adicione filtros opcionais Use count, geo, industry e tag.
  3. Leia o array de vagas Armazene apenas o que sua interface precisa e mantenha a URL da listagem do Jobicy.
  4. Verifique se uma vaga ainda está ativa Envie uma solicitação leve HEAD para a URL da vaga no Jobicy. Uma resposta HTTP 404 ou 410 significa que a vaga não está mais ativa.
const response = await fetch(
  "https://jobicy.com/api/v2/remote-jobs?count=10&geo=usa&industry=engineering"
);

if (!response.ok) {
  throw new Error(\`HTTP ${response.status}\`);
}

const data = await response.json();
console.log(data.jobs);

Opcional API de Vagas Comercial: links de aplicação diretos

A chave de API é opcional. Sem ela, url sempre contém a URL da listagem do Jobicy e a API pública permanece gratuita. Para receber a URL original de aplicação ATS em url, crie uma chave de API no seu Painel da API Jobicy e envie-a com cada solicitação como Authorization: Bearer API_KEY. É necessária uma carteira: cada vaga com uma URL de aplicação direta disponível custa $0,01 uma vez por chave de API. Solicitações repetidas para a mesma vaga e chave são gratuitas.

Solicitação comercial com chave Bearer

curl "https://jobicy.com/api/v2/remote-jobs?count=10&geo=usa&industry=engineering" \
  -H "Authorization: Bearer API_KEY" \
  -H "Accept: application/json"

03 · Parâmetros de consulta

Solicite apenas as vagas que você precisa.

Todos os filtros são opcionais. Combine-os para restringir os resultados por quantidade, elegibilidade geográfica, categoria de vaga ou palavra-chave de texto.

count

Número de listagens a retornar. Intervalo aceito: 1–200.

Padrão 200

geo

Slug de localização como usa, europe ou apac.

Opcional

industry

Slug de categoria como engineering, marketing ou data-science.

Opcional

tag

Pesquisa por palavra-chave aplicada ao conteúdo disponível da vaga.

Opcional

Use slugs atuais

Carregue a lista de localizações e a lista de categorias antes de armazenar valores em uma integração de produção.

Exemplos de solicitação

Pesquisa por palavra-chave

Vinte vagas recentes mencionando Python.

GET /api/v2/remote-jobs?count=20&tag=python

Filtro por país

Quinze vagas recentes disponíveis no Canadá.

GET /api/v2/remote-jobs?count=15&geo=canada

Categoria e localização

Vagas de marketing disponíveis para candidatos nos EUA.

GET /api/v2/remote-jobs?geo=usa&industry=marketing

Sucesso do cliente

Cinco oportunidades recentes de suporte ao cliente.

GET /api/v2/remote-jobs?count=5&industry=supporting

04 · Campos de resposta

Dados prontos para exibição ou análise.

Cada vaga inclui sua URL de origem, empregador, elegibilidade, tipo de emprego, descrição, data de publicação e informações salariais quando fornecidas.

CampoTipoDescrição
idinteiroID exclusivo da listagem no Jobicy.
urlstringURL da listagem no Jobicy para solicitações públicas. Com uma chave Bearer válida da API de Vagas Comercial, contém a URL original de aplicação ATS quando disponível; caso contrário, permanece a URL da listagem do Jobicy.
jobTitlestringTítulo da função.
companyNamestringNome do empregador.
companyLogostringURL do logotipo do empregador quando disponível.
jobIndustryarrayRótulos de categoria da vaga.
jobTypearrayValores do tipo de emprego.
jobGeostringElegibilidade de localização remota.
jobLevelstringNível de experiência ou senioridade.
jobExcerptstringResumo curto da listagem, até 55 caracteres.
jobDescriptionstring HTMLDescrição completa da vaga.
pubDatedata-horaData original de publicação.
salaryMin / salaryMaxnúmeroLimites salariais quando fornecidos.
salaryCurrencystringCódigo de moeda ISO.
salaryPeriodstringIntervalo salarial, como anual ou por hora.
{
  "id": 123456,
  "url": "https://jobicy.com/jobs/example-role",
  "jobTitle": "Senior Product Designer",
  "companyName": "Example Company",
  "companyLogo": "https://example.com/logo.png",
  "jobIndustry": ["Creative & Design"],
  "jobType": ["full-time"],
  "jobGeo": "Anywhere",
  "jobLevel": "Senior",
  "jobExcerpt": "Short summary of the role",
  "jobDescription": "<p>Complete HTML job description</p>",
  "pubDate": "2026-07-30T12:00:00+00:00",
  "salaryMin": 90000,
  "salaryMax": 125000,
  "salaryCurrency": "USD",
  "salaryPeriod": "yearly"
}

Verificação de disponibilidade da listagem

Para verificar se uma vaga recuperada anteriormente ainda está ativa, envie uma solicitação leve HEAD para a URL da listagem do Jobicy retornada pela API pública. Uma resposta HTTP 404 ou 410 indica que a vaga não está mais ativa. Para listagens em cache ou armazenadas, verificar a disponibilidade uma ou duas vezes por hora geralmente é suficiente.

Crie e execute uma solicitação aqui.

Escolha filtros, envie a solicitação, inspecione a resposta JSON e copie-a para seu fluxo de trabalho de desenvolvimento.

GET https://jobicy.com/api/v2/remote-jobs?count=5

{
  "status": "Ready to send a request"
}

Busca de vagas remotas para ferramentas de IA.

O servidor MCP público permite que assistentes, agentes e IDEs compatíveis descubram filtros válidos e recuperem listagens estruturadas por meio do endpoint MCP público do Jobicy.

FERRAMENTA 01

get_jobs

Recupera vagas usando filtros opcionais count, geo, industry e tag.

FERRAMENTA 02

get_taxonomies

Retorna slugs atuais de localização ou categoria antes de uma ferramenta aplicar filtros estritos.

{
  "mcpServers": {
    "jobicy-jobs": {
      "url": "https://jobicy.com/mcp"
    }
  }
}

07 · Feed RSS

Crie um feed filtrado.

O RSS funciona bem para leitores, fluxos de publicação e serviços de automação que não precisam de uma integração JSON.

URLs canônicas e legadas

Use /jobs/feed para novas integrações. O endereço mais antigo /feed/job_feed permanece disponível para compatibilidade. Consultar algumas vezes por dia normalmente é suficiente e não deve exceder uma vez por hora.

08 · Uso justo

Crie experiências úteis com dados do Jobicy.

A API do Jobicy é projetada para sites, aplicativos, newsletters, ferramentas de pesquisa, produtos de IA e outros serviços que ajudam usuários a descobrir oportunidades de trabalho remoto.

  1. Você pode usar listagens do Jobicy em seus próprios produtos e experiências de usuário sem solicitar permissão individual.
  2. Mantenha o Jobicy como fonte original e preserve a URL canônica da vaga do Jobicy ao exibir listagens.
  3. Você pode criar suas próprias interfaces, resumos, categorias, experiências de busca e contexto adicional em torno das listagens.
  4. Não apresente listagens do Jobicy como suas próprias vagas originais nem remova a atribuição de fonte.
  5. Evite solicitações excessivas à API e armazene respostas em cache quando apropriado para fornecer uma experiência confiável para todos.
  6. Não use a API para criar redes de spam, bancos de dados de vagas enganosos ou serviços que afetem negativamente empregadores ou candidatos.

Nenhuma aprovação necessária para integrações normais

A maioria das integrações, incluindo quadros de empregos, newsletters, ferramentas de carreira, assistentes de IA e aplicativos internos, pode usar a API pública sem um acordo separado. Entre em contato conosco apenas para parcerias comerciais de alto volume ou acordos personalizados de dados.

Ganhe comissões com suas indicações do Jobicy

Se você usa listagens do Jobicy em seu site, aplicativo, newsletter ou outro produto, pode transformar as URLs originais das vagas do Jobicy em links de indicação e ganhar uma comissão quando usuários indicados por você fizerem compras elegíveis no Jobicy.

Basta anexar seu ID de usuário do Jobicy à URL da vaga: https://jobicy.com/jobs/example-job**?u=YOUR\_USER\_ID**

A URL da vaga permanece a mesma — o parâmetro ?u= simplesmente atribui o usuário indicado à sua conta.

Você ganha uma comissão quando seus usuários indicados concluem compras elegíveis no Jobicy.

Veja seu ID de indicação, usuários indicados, ganhos e outros detalhes de afiliado na sua conta de Afiliado.
Gerenciar sua conta de afiliado →
Saiba mais sobre o Programa de Afiliados do Jobicy →

09 · Integrações

Incorpore ou automatize sem reconstruir tudo.

Use um widget pequeno, o plugin oficial do WordPress ou uma receita de automação quando um cliente de API personalizado adicionaria trabalho desnecessário.

01

Envie novas vagas remotas para LinkedIn, X, Facebook, Telegram, Slack, Discord ou WordPress.

02

Widget incorporável

Adicione uma interface de busca de vagas responsiva com temas claro e escuro.

03

Plugin WordPress ›

Exiba listagens atualizadas do Jobicy com o shortcode [jobicy_jobs].

Exemplo de widget

<div id="jobicy-widget"></div>
<script>
window.jobicyWidgetConfig = {
  query: "Developer",
  theme: "light",
  autoSearch: true,
  limit: 10
};
</script>
<script src="https://jobicy.com/api/prod/wg.js"></script>

10 · Perguntas frequentes

Antes de ir para produção.

Os principais detalhes operacionais para uma integração estável de API pública ou feed.

A API de Vagas exige uma chave de API?

Não. O endpoint público de vagas remotas e as solicitações de taxonomia não exigem autenticação. Uma chave de API Bearer só é necessária para acesso à API de Vagas Comercial, que retorna URLs originais de aplicação ATS em url quando disponíveis.

Como recebo o link original de aplicação?

Envie Authorization: Bearer API_KEY com a solicitação da API de Vagas. Com uma chave ativa e saldo suficiente na carteira da API, url retorna a URL original de aplicação ATS. Se uma vaga não tiver URL original de aplicação, url permanece a listagem do Jobicy e nenhuma cobrança é feita.

Quantas vagas uma solicitação pode retornar?

O parâmetro count aceita valores de 1 a 200. O endpoint retorna as vagas correspondentes mais recentes disponíveis.

Como um cliente deve descobrir filtros válidos?

Use ?get=locations e ?get=industries em vez de depender de uma lista codificada indefinidamente.

A descrição da vaga pode conter HTML?

Sim. Trate jobDescription como HTML e higienize-o de acordo com as regras de segurança do seu aplicativo.

Com que frequência uma integração deve consultar?

Algumas verificações por dia geralmente são suficientes. Verificações automatizadas não devem ocorrer mais de uma vez por hora.

Exemplos de integração no GitHub

Crie com a API de Vagas do Jobicy, feeds RSS e MCP usando exemplos completos para Node.js, Python, Next.js, Telegram, Discord, Slack, WordPress, n8n, Zapier, Make e agentes de IA. Ver exemplos da API Jobicy no GitHub