Company Contact Details Extractor
Extrai os pontos de contato públicos de uma empresa a partir do seu site, incluindo endereços de e-mail por função e números de telefone.
Documentação
Servidor MCP Company Contact Details Extractor
Um servidor MCP que encontra a página de contato de uma empresa e extrai e-mails de função, um número de telefone e um endereço postal. Ele encapsula o ator Company Contact Details Extractor da Mamba Labs na Apify e retorna uma linha JSON plana pronta para Clay para qualquer cliente MCP.
O que está incluído
- O que ele faz
- Início rápido
- Pré-requisitos
- Exemplos de prompts
- Entradas
- Saída
- Exemplo de saída
- Recursos
- Documentação completa do ator
- Suíte GTM da Mamba Labs
- Licença
O que ele faz
Forneça o domínio de uma empresa e ele encontra a página de contato dessa empresa, retornando os endereços de e-mail de função publicados nela, um número de telefone principal no formato E.164 quando o país é identificado, e um endereço postal. Uma linha plana por empresa.
Indivíduos nomeados nunca são retornados. Um endereço é mantido apenas quando seu domínio pertence à empresa e sua parte local está no vocabulário de funções, então info@, support@, sales@ e privacy@ são preservados, e o endereço de uma pessoa é descartado por uma lista de permissões em vez de um detector de nomes. A linha informa quantos endereços foram encontrados, quantos foram rejeitados e o motivo, para que um resultado enxuto nunca seja confundido com um site que não publica nada.
Toda a extração é executada na Apify. Este pacote é um cliente leve que chama o ator e devolve o resultado inalterado.
Início rápido
Você precisa do Node.js 18 ou mais recente e de uma conta Apify com um token de API.
Adicione isto à sua configuração do Claude Desktop:
{
"mcpServers": {
"mamba-company-contact-details-extractor": {
"command": "npx",
"args": ["-y", "@mambalabsdev/mcp-company-contact-details-extractor"],
"env": {
"APIFY_TOKEN": "your-apify-token"
}
}
}
}
Obtenha seu token em https://console.apify.com/account/integrations,, cole-o e reinicie o Claude Desktop. A ferramenta extract_company_contact_details estará disponível.
Pré-requisitos
- Node.js 18 ou mais recente
- Uma conta Apify com um token de API
Exemplos de prompts
- "Encontre os dados de contato para stripe.com."
- "Obtenha o e-mail de vendas para figma.com e pule o número de telefone."
- "Busque os dados de contato desta empresa de encanamento local e permita caixas de e-mail gratuitas."
- "Extraia o endereço de suporte para notion.com, lendo uma segunda página se a página de contato não tiver nada."
Entradas
company_domain(obrigatório para esta ferramenta): domínio da empresa sem prefixo, por exemplostripe.com. Esta é a chave de busca e a chave de junção para todos os outros atores da frota. A ferramenta retorna um erro nomeando o campo quando ele está ausente, antes de qualquer execução começar.company_name(opcional): usado na linha e no registro de log. Esta ferramenta condiciona endereços ao domínio do e-mail em vez do nome da empresa, então fornecer um nome não altera quais endereços são mantidos.emailTypes(opcional): quais classes de endereço de função retornar. Um deall,general,support,sales,privacy,general_supportousales_only.allé o padrão e retorna geral, suporte, vendas e privacidade. As configurações mais restritas retornam apenas o que nomeiam e deixam as outras colunas nulas, o que é uma resposta diferente de não encontrar nada.includePhones(opcional): quando verdadeiro (o padrão), a página de contato é verificada em busca de um número de telefone principal. Defina como falso para pular a extração de telefone completamente.includeAddress(opcional): quando verdadeiro (o padrão), um endereço postal é lido primeiro do JSON-LD e depois do rodapé. Defina como falso para pular.allowFreeMailboxes(opcional): quando falso (o padrão), um endereço no Gmail, Outlook ou outro provedor gratuito é rejeitado, porque não pode ser verificado contra o domínio da empresa. Defina como verdadeiro para listas de pequenas empresas e empresas locais, onde uma caixa de e-mail gratuita na página de contato costuma ser o ponto de contato real.crawlDepth(opcional): quantas páginas ler após a página inicial.1(o padrão) lê a página de contato.2também lê uma página de suporte ou jurídica quando a página de contato não retornou nada. Este é um controle de custo e profundidade, não uma mudança de resposta.skipCache(opcional): quando falso (o padrão), uma busca bem-sucedida é armazenada em cache por sete dias e reutilizada. Defina como verdadeiro para forçar uma nova busca.
Como uma chamada é executada
A ferramenta inicia a execução do ator e a monitora até um status concluído, para que uma execução longa não seja interrompida aos 300 segundos. A execução tem permissão de 1.800 segundos. Se ainda estiver em andamento dois minutos depois disso, a chamada para de esperar e retorna o ID da execução com um link para ela no Apify Console, onde os resultados chegam quando ela termina. Uma execução que não é bem-sucedida retorna como erro com seu ID e status.
Saída
A ferramenta retorna a linha JSON plana do ator para a empresa, com 27 campos em snake_case e sem objetos aninhados. emails_rejected_count e emails_rejected_reasons explicam o que foi descartado, contact_page_method diz como a página de contato foi encontrada e fetch_status diz se a leitura foi bem-sucedida. Consulte a página da Apify Store para o esquema completo de saída.
Exemplo de saída
{
"degraded": false,
"degradation_reason": null,
"company_domain": "stripe.com",
"company_name": "Stripe",
"contact_page_url": "https://stripe.com/contact/sales",
"contact_page_method": "footer_anchor",
"contact_page_confidence": 0.85,
"email_general": null,
"email_support": null,
"email_sales": "sales@stripe.com",
"email_privacy": null,
"emails_found_count": 7,
"emails_rejected_count": 6,
"emails_rejected_reasons": "foreign_domain=5, not_a_role_address=1",
"phone_main": null,
"phone_source": null,
"phone_page": null,
"address_line": null,
"address_city": null,
"address_country": null,
"address_source": null,
"address_page": null,
"contact_form_url": null,
"pages_read": 2,
"coverage": 0.2,
"fetch_status": "ok",
"run_date": "2026-08-22T19:23:48.675Z"
}
Recursos
- Apenas endereços de e-mail de função, nunca um indivíduo nomeado
- Número de telefone principal e endereço postal quando a empresa os publica
- URL da página de contato, além de como essa página foi encontrada
- Contabilização de rejeições em
emails_rejected_reasons, para que uma leitura enxuta seja visível - Cobertura relatada por linha
- 27 campos planos em snake_case, uma linha por empresa
Documentação completa do ator
Este servidor é um cliente leve e não contém lógica de extração. Para a referência completa de entrada e saída, preços e histórico de execuções, consulte a página da Apify Store:
https://apify.com/mambalabs/company-contact-details-extractor
Suíte GTM da Mamba Labs
Este servidor é um dos servidores MCP da Suíte GTM da Mamba Labs. Cada ator da suíte recebe um domínio ou uma empresa e retorna uma linha plana, então eles se empilham na mesma tabela Clay sem remodelar nada. O ator por trás deste servidor é o Company Contact Details Extractor, ID imutável do ator Apify 4mMncKaJykiq94grz.
Construído por Mamba Labs | npm | Apify Store
Licença
MIT
Construído por Mamba Labs. https://apify.com/mambalabs