Crawdar Business Research

Dê ao seu agente prospects qualificados, não páginas brutas.

Conecte-se via MCP remoto, chame a API JSON versionada ou use um navegador com suporte a JavaScript. O Crawdar retorna por que cada empresa corresponde, decisões em nível de critério, uma rota de contato pública classificada e as fontes de apoio.

Interface recomendada

MCP remoto

Aponte qualquer cliente HTTP Streamable para https://crawdar.com/api/mcp. Comece com sandbox_businesses para testar sua integração sem consumir capacidade de busca ao vivo.

scan_review_pain_points

Amostra avaliações públicas para queixas recorrentes e possíveis soluções técnicas, com evidência de fonte e limites de cobertura.

research_businesses

Busca em linguagem natural em uma única chamada, com saída compacta ou completa.

search_businesses

Busca estruturada para alvo, geografia, qualificador e campos explícitos.

sandbox_businesses

Resultados fictícios determinísticos para testes de contrato e de loop de agente.

start_lead_search

Retorna um job privado com URLs de progresso, status, exportação, nova tentativa e cancelamento.

get_lead_search

Lê o progresso ou recupera páginas de resultados com um cursor opaco.

refine_lead_search

Cria um novo job preservando o original.

retry_lead_search

Substitui um job com falha ou interrompido.

cancel_lead_search

Cancela trabalho em fila ou em execução.

explain_crawdar

Retorna semântica, limites, interfaces e regras de uso seguro.

Cada ferramenta publica um esquema JSON de saída explícito. Mantenha cada jobToken privado, respeite os intervalos de progresso e nova tentativa e mantenha as URLs de evidência anexadas.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "research_businesses",
    "arguments": {
      "brief": "Independent veterinary clinics in Berlin with an active first-party website. Exclude directories and chains.",
      "output": "compact",
      "limit": 10,
      "offset": 0
    }
  }
}

Copie e cole

Conecte seu cliente.

Claude Code ou outro cliente .mcp.json

{
  "mcpServers": {
    "crawdar": {
      "type": "http",
      "url": "https://crawdar.com/api/mcp"
    }
  }
}

O Claude Code também pode se conectar pela linha de comando com claude mcp add --transport http crawdar https://crawdar.com/api/mcp.

Codex

Adicione isto a ~/.codex/config.toml:

[mcp_servers.crawdar]
url = "https://crawdar.com/api/mcp"

OpenAI Responses API

import OpenAI from "openai";

const openai = new OpenAI();
const response = await openai.responses.create({
  model: "gpt-5",
  input: "Find independent veterinary clinics in Berlin. Keep the source URLs.",
  tools: [{
    type: "mcp",
    server_label: "crawdar",
    server_description: "Evidence-backed public business research",
    server_url: "https://crawdar.com/api/mcp",
    allowed_tools: ["research_businesses", "search_businesses"],
    require_approval: "never"
  }]
});

console.log(response.output_text);

As ferramentas de busca e sandbox são somente leitura. Clientes podem exigir aprovação para cancel_lead_search.

Integração direta

API REST

Teste sem cota ou chamadas de provedor

curl https://crawdar.com/api/v1/sandbox/search \
  -H 'content-type: application/json' \
  -d '{ "target": "independent veterinary clinics", "geography": "Berlin, Germany" }'

As empresas do sandbox são fictícias e compatíveis com o esquema. Nunca as use como leads reais.

Obtenha uma chave de agente gratuita

Entre com o ChatGPT em sua página de conta para criar uma chave. O segredo é mostrado uma única vez. Contas verificadas recebem 25 buscas por dia UTC compartilhadas entre todas as suas chaves, com até duas novas chaves por dia. Revogue uma chave usando DELETE /api/v1/keys.

# Sign in at https://crawdar.com/account and create your key there.
# Store the displayed secret, then check your shared account allowance:
curl https://crawdar.com/api/v1/account -H "x-api-key: $CRAWDAR_API_KEY"

Envie o segredo retornado como x-api-key ou Authorization: Bearer YOUR_KEY para a API REST ou como um cabeçalho personalizado em um cliente MCP. Visitantes podem executar três buscas no total sem entrar. Chaves existentes não reivindicadas têm uma margem de cortesia até 7 de outubro de 2026 às 00:00 UTC; reivindique-as na sua página de conta.

Duas buscas podem ser executadas simultaneamente por conta. Até dez jobs em fila ou em execução podem aguardar no fluxo de trabalho assíncrono. Consulte o mesmo job em fila e respeite Retry-After. As buscas incluídas dependem da capacidade gratuita compartilhada do provedor. Se ela ou sua cota diária estiver esgotada, novas buscas usam créditos pré-pagos quando disponíveis. Resultados em cache permanecem gratuitos e buscas com falha devolvem o crédito de busca; uma busca nova concluída conta mesmo quando nenhuma correspondência é encontrada. Leia o uso e qualquer oferta de capacidade configurada em GET /api/v1/account.

Execute uma busca

Envie um alvo e uma geografia para o endpoint estável v1. Adicione um Idempotency-Key ao iniciar um job retomável para que novas tentativas de rede não criem trabalho duplicado.

curl https://crawdar.com/api/v1/search \
  -H 'content-type: application/json' \
  -H "x-api-key: $CRAWDAR_API_KEY" \
  -d '{
    "target": "independent veterinary clinics",
    "geography": "Berlin, Germany",
    "qualifier": "Must show an active first-party website. Exclude directories and chains.",
    "fields": ["Website", "Location", "Business email", "Source links"]
  }'

A resposta inclui resultados, fontes pesquisadas, avisos, diagnósticos, buscas gratuitas restantes e URLs de evidência. Consulte o contrato OpenAPI 3.1 ou o status ao vivo.

Fallback de navegador

Acesso por navegador headless

Um navegador com suporte a JavaScript pode usar o produto normal. Os controles principais têm nomes estáveis e IDs de teste para Playwright, Browser Use e agentes semelhantes.

1. Abra https://crawdar.com/.
2. Preencha [data-testid="target-input"] e [data-testid="quick-geography-input"].
3. Clique em [data-testid="quick-search-button"].
4. Aguarde [data-testid="search-results"] e inspecione as faixas Qualificado, Possível e Excluído.

Prefira MCP ou a API quando possível. Eles retornam JSON estruturado sem automação de interface.

Mantenha sua pesquisa

Listas persistentes de prospects

Use suas listas ou /api/v1/lists com uma conta verificada. Crie uma lista nomeada e importe uma busca concluída usando seu searchToken assinado ou seu jobId e jobToken privado. Renomeie com PATCH /api/v1/lists/{id} ou exclua a lista e suas linhas salvas com DELETE /api/v1/lists/{id}. Empresas são deduplicadas entre buscas. Filtre prospects por texto, status ou disponibilidade de contato e exporte CSV para importação em CRM com evidência de fonte e datas de observação.

POST /api/v1/lists/{id}/refresh verifica um prospect com evidência mais antiga que sete dias por chamada e relata campos alterados. A evidência anterior permanece quando nenhuma correspondência atual é encontrada. A atualização usa as cotas normais de busca. Contas podem manter 100 listas com 1.000 prospects cada.

Loop de agente recomendado

Busque, inspecione e aja.

1. Chame explain_crawdar uma vez quando a semântica dos resultados for desconhecida.
2. Para um fluxo de trabalho retomável, chame start_lead_search e armazene o id e o jobToken retornados com segurança.
3. Chame get_lead_search com view: "compact" e um limite pequeno. Se o status for running, respeite o intervalo de nova tentativa. Se for retomável, chame retry_lead_search.
4. Inspecione evidências e verificações de qualificação. Mantenha URLs de fonte com cada registro downstream.
5. Se os resultados estiverem vazios, inspecione diagnósticos e exclusões explicadas antes de refinar o briefing.
6. Passe nextCursor de volta sem alterações. Solicite full somente quando evidências detalhadas forem necessárias.

Regras operacionais

Mantenha a evidência anexada.

Verifique antes de agir

A confiança mede a evidência disponível. Não é uma garantia de que uma empresa é adequada, ativa ou pronta para comprar. Compare os critérios retornados com o briefing original: um rótulo qualificado significa que as verificações registradas passaram, não que todas as nuances foram compreendidas.

Lide com dados ausentes com honestidade

Um campo ausente permanece ausente. Não infira e-mails pessoais, receita, propriedade ou um atributo negativo a partir do silêncio. Resultados MCP compactos expõem sourceUrls; resultados completos de REST e sandbox retêm evidence[].url.

Respeite limites e políticas

O uso gratuito da API e do MCP é limitado por taxa. Respeite respostas de retry-after e os termos de crawler, privacidade e uso responsável. Inspecione errorCode, requestId e as orientações de nova tentativa quando uma ferramenta falhar.