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

Smithery Glama score MCP Registry npm version npm downloads license mcpservers.org

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

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 exemplo stripe.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 de all, general, support, sales, privacy, general_support ou sales_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. 2 també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