ComposioHQ/automação-Lever

Automação Lever

Automatize suas operações de recrutamento no Lever ATS diretamente do Claude Code. Gerencie anúncios de emprego, acompanhe pipelines de candidatos, atualize requisições e consulte oportunidades sem sair do terminal.

Documentação do toolkit: composio.dev/toolkits/lever

---

Configuração

1. Adicione o servidor MCP do Composio à sua configuração:

   https://rube.app/mcp
   

2. Conecte sua conta Lever quando solicitado, executando qualquer comando Lever. O agente fornecerá um link OAuth para autenticação.
3. Verifique se sua chave de API do Lever possui os escopos necessários para as operações desejadas (acesso de leitura/gravação a anúncios, oportunidades, requisições).

---

Fluxos de Trabalho Principais

1. Listar e Filtrar Anúncios de Emprego

Recupere todos os anúncios de emprego com filtragem opcional por estado, equipe, departamento, local ou tipo de compromisso.

Ferramenta: LEVER_LIST_POSTINGS

Parâmetros principais:

• state -- filtrar por published, internal, closed, draft, pending, rejected
• team, department, location, commitment -- restringir resultados por atributos organizacionais
• limit (1-100) e offset -- paginar grandes conjuntos de anúncios
• tag -- filtrar por tag do anúncio

Exemplo de prompt: "Liste todos os anúncios de emprego publicados para engenharia no Lever"

---

2. Navegar por Oportunidades de Candidatos

Liste todas as oportunidades no pipeline de contratação com filtragem avançada para análise de pipeline e acompanhamento de candidatos.

Ferramenta: LEVER_LIST_OPPORTUNITIES

Parâmetros principais:

• posting_id, stage_id, tag -- filtrar por anúncio, estágio do pipeline ou tag
• email, contact_id -- encontrar oportunidades para um candidato específico
• archived -- filtrar por status de arquivamento (true/false)
• created_at_start, created_at_end -- filtro por intervalo de datas (ISO 8601)
• expand -- expandir applications, contact, owner, stage, stageChanges, sources, sourcedBy em objetos completos

Exemplo de prompt: "Mostre todas as oportunidades ativas para o anúncio de Engenheiro Sênior, expandidas com detalhes de contato"

---

3. Obter Detalhes da Oportunidade

Busque detalhes abrangentes de uma única oportunidade de candidato, incluindo informações de contato, progressão no estágio, fontes e candidaturas.

Ferramenta: LEVER_GET_OPPORTUNITY

Parâmetros principais:

• opportunity (obrigatório) -- o UID único da oportunidade
• expand -- campos separados por vírgula para expandir: contact, stage, owner

Exemplo de prompt: "Obtenha detalhes completos da oportunidade 31c9716c-d4e3-47e8-a6a1-54078a1151d6 com contato e estágio expandidos"

---

4. Gerenciar Requisições

Crie, liste, atualize e exclua requisições para acompanhar headcount e necessidades de contratação.

Ferramentas: LEVER_LIST_REQUISITIONS, LEVER_GET_REQUISITION, LEVER_UPDATE_REQUISITION, LEVER_DELETE_REQUISITION

A atualização requer estes campos:

• requisition (obrigatório) -- UUID da requisição
• requisitionCode (obrigatório) -- código único como REQ-001
• name (obrigatório) -- título da requisição
• headcountTotal (obrigatório) -- número de posições (mínimo 1)
• status -- open ou closed
• Opcionais: hiringManager, owner, department, team, location, compensationBand

Exemplo de prompt: "Atualize a requisição REQ-001 para aumentar o headcount para 3 e alterar o status para open"

---

5. Visualizar Estágios do Pipeline

Recupere todos os estágios do pipeline de contratação configurados na sua conta Lever.

Ferramenta: LEVER_LIST_STAGES

Parâmetros principais:

• limit (1-100) -- número máximo de itens por página
• offset -- token de paginação da resposta anterior

Exemplo de prompt: "Liste todos os estágios do pipeline na nossa conta Lever"

---

6. Gerenciar Tags

Liste todas as tags usadas para categorizar candidatos, oportunidades e anúncios.

Ferramenta: LEVER_LIST_TAGS

Parâmetros principais:

• limit -- número máximo de itens por página
• offset -- token de paginação

Exemplo de prompt: "Mostre todas as tags de candidatos no Lever"

---

Armadilhas Conhecidas

• Paginação necessária para grandes conjuntos de dados: LEVER_LIST_OPPORTUNITIES e LEVER_LIST_POSTINGS retornam no máximo 100 resultados por página. Sempre verifique se há um token offset na resposta e itere para obter resultados completos.
• Formato do parâmetro expand: O campo expand em LEVER_LIST_OPPORTUNITIES aceita um array de strings, enquanto em LEVER_GET_OPPORTUNITY e LEVER_GET_REQUISITION aceita uma string separada por vírgulas. Siga o esquema exato para cada ferramenta.
• Atualizações de requisição são substituições completas: LEVER_UPDATE_REQUISITION exige todos os campos obrigatórios (requisitionCode, name, headcountTotal) mesmo se você quiser alterar apenas um campo. Sempre busque a requisição atual primeiro com LEVER_GET_REQUISITION.
• Timestamps: Os filtros de data de oportunidade usam o formato ISO 8601, enquanto LEVER_LIST_POSTINGS usa timestamps Unix em milissegundos para updated_at_start.
• Escopos de conexão: Operações de gravação (atualizar/excluir requisições) falharão se seu token de API não tiver as permissões necessárias, mesmo que as leituras sejam bem-sucedidas.

---

Referência Rápida

Slug da Ferramenta	Descrição
LEVER_LIST_POSTINGS	Listar todos os anúncios de emprego com filtragem por estado, equipe, departamento
LEVER_LIST_OPPORTUNITIES	Listar oportunidades de candidatos com filtragem por pipeline
LEVER_GET_OPPORTUNITY	Obter informações detalhadas de uma única oportunidade
LEVER_GET_REQUISITION	Recuperar uma única requisição por ID
LEVER_LIST_REQUISITIONS	Listar todas as requisições com filtragem por status/código
LEVER_UPDATE_REQUISITION	Atualizar uma requisição existente (substituição completa)
LEVER_DELETE_REQUISITION	Excluir/arquivar uma requisição
LEVER_LIST_STAGES	Listar todos os estágios do pipeline
LEVER_LIST_TAGS	Listar todas as tags para categorização

---

Desenvolvido por Composio