Recruiter Roles

Servidor MCP Recruiter Roles

Consulte o quadro de empregos Recruiter Roles de qualquer cliente de IA compatível com MCP (Claude, Cursor, ChatGPT, VS Code, …). Pergunte em linguagem natural e obtenha vagas ao vivo de recrutadores e aquisição de talentos, perfis de empresas, setores, locais e estatísticas de mercado — direto do quadro.

Somente leitura. Autenticado com uma chave de API gratuita do Recruiter Roles.

• Hospedado (recomendado): https://recruiterroles.com/api/mcp (Streamable HTTP)
• Local (este pacote): npx recruiter-roles-mcp (stdio, para clientes somente stdio)
• Obtenha uma chave de API gratuita: https://recruiterroles.com/api-access
• Documentação: https://recruiterroles.com/mcp · API REST: https://recruiterroles.com/api-docs

Ferramentas

Ferramenta	Descrição
search_jobs	Pesquise e filtre vagas ao vivo (setor, local, salário, remoto, recência, texto completo).
get_job	Detalhes completos de uma vaga — descrição, requisitos, benefícios, contato para candidatura.
list_companies	Navegue por agências de recrutamento e empregadores com contagens de vagas ativas.
get_company	Um perfil de empresa mais suas vagas ativas.
list_sectors	Todos os setores de recrutamento com contagens de vagas ao vivo.
list_locations	Países, regiões e cidades com contagens de vagas ao vivo.
market_stats	Visão geral agregada do mercado — totais, velocidade de publicação e detalhamentos.

Todas as ferramentas são anotadas com readOnlyHint: true, destructiveHint: false, openWorldHint: false e expõem um outputSchema.

Conectar

Servidor remoto hospedado (recomendado)

A maioria dos clientes pode se conectar diretamente ao endpoint Streamable HTTP hospedado com sua chave de API no cabeçalho Authorization (ou como um parâmetro de consulta ?key= para clientes que não podem definir cabeçalhos).

Cursor — ~/.cursor/mcp.json:

{
  "mcpServers": {
    "recruiter-roles": {
      "url": "https://recruiterroles.com/api/mcp",
      "headers": { "Authorization": "Bearer rr_live_YOUR_KEY" }
    }
  }
}

VS Code — .vscode/mcp.json:

{
  "servers": {
    "recruiter-roles": {
      "type": "http",
      "url": "https://recruiterroles.com/api/mcp",
      "headers": { "Authorization": "Bearer rr_live_YOUR_KEY" }
    }
  }
}

Conector personalizado Claude / ChatGPT — adicione a URL com sua chave anexada:

https://recruiterroles.com/api/mcp?key=rr_live_YOUR_KEY

Servidor stdio local (este pacote npm)

Para clientes somente stdio ou desenvolvimento local. Defina sua chave de API por meio da variável de ambiente RECRUITER_ROLES_API_KEY:

{
  "mcpServers": {
    "recruiter-roles": {
      "command": "npx",
      "args": ["-y", "recruiter-roles-mcp"],
      "env": { "RECRUITER_ROLES_API_KEY": "rr_live_YOUR_KEY" }
    }
  }
}

Execute diretamente:

RECRUITER_ROLES_API_KEY=rr_live_YOUR_KEY npx recruiter-roles-mcp

Como funciona

Esta é uma camada fina e somente leitura sobre a API REST v1 pública do Recruiter Roles. Cada ferramenta encaminha sua chave de API para um endpoint GET /api/v1/*, de modo que o uso do MCP compartilha o mesmo limite de taxa (1.000 solicitações/dia por chave), cache e registro de solicitações da API REST. O servidor não mantém conexão com banco de dados nem segredos próprios.

Desenvolvimento

npm install
npm run build
RECRUITER_ROLES_API_KEY=rr_live_YOUR_KEY node dist/index.js

Opcional: aponte para uma origem diferente durante o desenvolvimento com RECRUITER_ROLES_BASE_URL (padrão https://recruiterroles.com).

Política de backlink

Qualquer página ou produto que publique dados obtidos por meio deste servidor deve incluir um link visível e rastreável de volta para o Recruiter Roles. As chaves podem ser suspensas se o backlink for removido.

Licença

MIT — veja LICENSE.