ComposioHQ/Automação-Hunter

Automação Hunter

Potencialize sua prospecção com o Hunter.io — descubra endereços de e-mail por domínio, encontre e-mails de pessoas específicas, verifique 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 MCP do Composio à configuração do seu cliente:

   https://rube.app/mcp
   

2. Conecte sua conta do 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 comando:

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

Parâmetros principais:

• domain — Domínio a ser pesquisado (ex.: "stripe.com"). Obrigatório se company não for fornecido.
• company — Nome da empresa a ser pesquisada (ex.: "Stripe"). Obrigatório se domain não for fornecido.
• type — Filtrar por e-mails "personal" ou "generic"
• seniority — Filtrar por níveis: "junior", "senior", "executive" (array)
• department — Filtrar por departamentos: "executive", "it", "finance", "sales", etc. (array)
• required_field — Exigir campos específicos: "full_name", "position", "phone_number" (array)
• limit — Máximo de resultados por requisiçã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 com base no nome e domínio ou empresa.

Ferramenta: HUNTER_EMAIL_FINDER

Exemplo de comando:

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

Parâmetros principais:

• domain — Domínio alvo (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 requisição em segundos (3-20, padrão 10). Durações maiores geram resultados mais precisos.

---

3. Verificar Entregabilidade de E-mail

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

Ferramenta: HUNTER_EMAIL_VERIFIER

Exemplo de comando:

"Verifique se [email protected] é um endereço de e-mail válido"

Parâmetros principais:

• email (obrigatório) — O endereço de e-mail a ser verificado (ex.: "[email protected]")

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

---

4. Obter Estimativas de Volume de E-mails

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

Ferramenta: HUNTER_EMAIL_COUNT

Exemplo de comando:

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

Parâmetros principais:

• domain — Domínio a ser consultado (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 "personal" ou "generic"

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

---

5. Salvar e Gerenciar Leads

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

Ferramenta: HUNTER_UPSERT_LEAD

Exemplo de comando:

"Salve [email protected] como um lead no Hunter com 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 Uso e Limites da Conta

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

Ferramenta: HUNTER_ACCOUNT_INFORMATION

Exemplo de comando:

"Quantas pesquisas na 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 chave de API inválida ou expirada. Corrija antes de tentar operações em lote.
• Contagens de e-mail são estimativas: HUNTER_EMAIL_COUNT retorna números aproximados para dimensionamento e priorização, não contagens garantidas de e-mails recuperáveis.
• Pesquisa de domínio usa paginação offset: HUNTER_DOMAIN_SEARCH pagina via limit/offset. Não assuma que a primeira página está completa — continue buscando até que os resultados estejam vazios ou você atinja um limite.
• Resultados vazios não são erros: HUNTER_DOMAIN_SEARCH pode retornar emails: [] sem erro. Trate como "nenhum dado encontrado" e continue, em vez de repetir como falha.
• Nuances do status de verificação: Status accept_all ou risky do HUNTER_EMAIL_VERIFIER indicam incerteza. Exclua-os de fluxos rigorosos de entregabilidade ou trate-os separadamente.
• Limites de planos gratuitos/básicos: Planos gratuitos e básicos limitam HUNTER_DOMAIN_SEARCH a 10 resultados por requisição. Limites maiores exigem um plano pago.
• Formato do domínio importa: Use domínios simples como "stripe.com" — não inclua protocolo ("https://") nem prefixo "www.".

---

Referência Rápida

Ação	Slug da Ferramenta	Parâmetros Obrigatórios
Pesquisar e-mails do domínio	HUNTER_DOMAIN_SEARCH	domain ou company
Encontrar e-mail de uma pessoa	HUNTER_EMAIL_FINDER	Nome + (domain ou company)
Verificar e-mail	HUNTER_EMAIL_VERIFIER	email
Obter contagem de e-mails	HUNTER_EMAIL_COUNT	domain ou company
Salvar/atualizar lead	HUNTER_UPSERT_LEAD	email
Verificar conta	HUNTER_ACCOUNT_INFORMATION	Nenhum

---

Desenvolvido por Composio