Hunter Automation

Potencialize seu alcance com Hunter.io -- descubra endereços de e-mail por domínio, encontre e-mails de pessoas específicas, verifique a entregabilidade, salve leads e acompanhe o uso da sua API -- tudo através de comandos em linguagem natural.

Documentação do Toolkit: composio.dev/toolkits/hunter

Configuração

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

   https://rube.app/mcp
   

2. Conecte sua conta Hunter.io quando solicitado (autenticação por chave de API).
3. Comece a emitir comandos em linguagem natural para encontrar e verificar e-mails.

Fluxos de Trabalho Principais

1. Pesquisar Domínio por Endereços de E-mail

Descubra todos os endereços de e-mail publicamente disponíveis para um determinado domínio ou empresa, com filtros por departamento, senioridade e tipo.

Ferramenta: HUNTER_DOMAIN_SEARCH

Exemplo de prompt:

"Encontre todos os endereços de e-mail executivos em stripe.com usando Hunter"

Parâmetros principais:

• domain -- Domínio para pesquisar (ex: "stripe.com"). Obrigatório se company não for fornecido.
• company -- Nome da empresa para pesquisar (ex: "Stripe"). Obrigatório se domain não for fornecido.
• type -- Filtrar por e-mails "pessoais" ou "genéricos"
• seniority -- Filtrar por níveis: "junior", "senior", "executivo" (array)
• department -- Filtrar por departamentos: "executivo", "ti", "financeiro", "vendas", etc. (array)
• required_field -- Exigir campos específicos: "nome_completo", "cargo", "telefone" (array)
• limit -- Máximo de resultados por solicitação (1-100, padrão 10; planos gratuitos/básicos limitados a 10)
• offset -- Pular resultados para paginação (padrão 0)

2. Encontrar o E-mail de uma Pessoa Específica

Inferir o endereço de e-mail mais provável para uma pessoa, dado o nome e o domínio ou empresa.

Ferramenta: HUNTER_EMAIL_FINDER

Exemplo de prompt:

"Encontre o e-mail de Alexis Ohanian em reddit.com usando Hunter"

Parâmetros principais:

• domain -- Domínio de destino (ex: "reddit.com"). Tem precedência sobre company.
• company -- Nome da empresa (ex: "Reddit"). Usado se o domínio não for fornecido.
• Nome (uma destas combinações é obrigatória):
  • first_name + last_name (ex: "Alexis" + "Ohanian")
  • full_name (ex: "Alexis Ohanian")
• max_duration -- Duração máxima da solicitação em segundos (3-20, padrão 10). Durações mais longas produzem resultados mais precisos.

3. Verificar a Entregabilidade de E-mail

Verificar se um endereço de e-mail é válido, entregável e seguro para enviar.

Ferramenta: HUNTER_EMAIL_VERIFIER

Exemplo de prompt:

"Verifique se john.doe@example.com é um endereço de e-mail válido"

Parâmetros principais:

• email (obrigatório) -- O endereço de e-mail para verificar (ex: "john.doe@example.com")

A resposta inclui: status de verificação, pontuação de entregabilidade, validação de registro MX e avaliação de risco.

4. Obter Estimativas de Volume de E-mail

Verificar quantos endereços de e-mail o Hunter tem para um domínio ou empresa -- esta chamada é gratuita e não consome créditos da API.

Ferramenta: HUNTER_EMAIL_COUNT

Exemplo de prompt:

"Quantos endereços de e-mail o Hunter tem para stripe.com?"

Parâmetros principais:

• domain -- Domínio para consultar (ex: "stripe.com"). Obrigatório se company não for fornecido.
• company -- Nome da empresa (mínimo 3 caracteres). Obrigatório se domain não for fornecido.
• type -- Filtrar contagem por e-mails "pessoais" ou "genéricos"

Retorna: Contagem total com detalhamento por tipo, departamento e nível de senioridade.

5. Salvar e Gerenciar Leads

Criar ou atualizar leads por e-mail em uma única chamada de upsert -- não é necessário verificar a existência primeiro.

Ferramenta: HUNTER_UPSERT_LEAD

Exemplo de prompt:

"Salve john@stripe.com como um lead no Hunter com o nome John Doe, cargo CTO"

Parâmetros principais:

• email -- Endereço de e-mail do lead (identificador principal para upsert)
• Nome, cargo, empresa e outros metadados do lead

6. Verificar o Uso da Conta e Limites

Revisar os detalhes do seu plano de conta Hunter, pesquisas restantes e cotas de verificação antes de executar operações em massa.

Ferramenta: HUNTER_ACCOUNT_INFORMATION

Exemplo de prompt:

"Quantas pesquisas de API do Hunter me restam este mês?"

Parâmetros principais: Nenhum obrigatório.

Armadilhas Conhecidas

• HTTP 401 significa credenciais inválidas: erros authentication_failed indicam uma chave de API inválida ou expirada. Corrija antes de tentar operações em massa.
• Contagens de e-mail são estimativas: HUNTER_EMAIL_COUNT retorna números aproximados para dimensionamento e priorização, não contagens de e-mail garantidas para recuperação.

…