Crawdar Business Research

Dale a tu agente prospectos calificados, no páginas en bruto.

Conéctate con MCP remoto, llama a la API JSON versionada, o usa un navegador con capacidad de JavaScript. Crawdar devuelve por qué cada empresa coincide, decisiones a nivel de criterio, una ruta de contacto público clasificada, y las fuentes de respaldo.

Interfaz recomendada

MCP remoto

Apunta cualquier cliente HTTP Streamable a https://crawdar.com/api/mcp. Comienza con sandbox_businesses para probar tu integración sin consumir capacidad de búsqueda en vivo.

scan_review_pain_points

Muestrea reseñas públicas para quejas recurrentes y posibles soluciones técnicas, con evidencia de fuentes y límites de cobertura.

research_businesses

Búsqueda de lenguaje natural en una sola llamada con salida compacta o completa.

search_businesses

Búsqueda estructurada para objetivo, geografía, calificador y campos explícitos.

sandbox_businesses

Resultados ficticios deterministas para pruebas de contratos y bucles de agente.

start_lead_search

Devuelve un trabajo privado con URLs de progreso, estado, exportación, reintento y cancelación.

get_lead_search

Lee el progreso o recupera páginas de resultados con un cursor opaco.

refine_lead_search

Crea un nuevo trabajo preservando el original.

retry_lead_search

Reemplaza un trabajo fallido o detenido.

cancel_lead_search

Cancela trabajo en cola o en ejecución.

explain_crawdar

Devuelve semántica, límites, interfaces y reglas de uso seguro.

Cada herramienta publica un esquema de salida JSON explícito. Mantén cada jobToken privado, respeta los intervalos de progreso y reintento, y mantén las URLs de evidencia adjuntas.

{
  "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
    }
  }
}

Copiar y pegar

Conecta tu cliente.

Claude Code u otro cliente .mcp.json

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

Claude Code también puede conectarse desde la línea de comandos con claude mcp add --transport http crawdar https://crawdar.com/api/mcp.

Codex

Añade esto a ~/.codex/config.toml:

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

API de Respuestas de OpenAI

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);

Las herramientas de búsqueda y sandbox son de solo lectura. Los clientes pueden requerir aprobación para cancel_lead_search.

Integración directa

API REST

Prueba sin cuota ni llamadas al proveedor

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

Las empresas del sandbox son ficticias y compatibles con el esquema. Nunca las uses como prospectos reales.

Obtén una clave de agente gratuita

Inicia sesión con ChatGPT en tu página de cuenta para crear una clave. El secreto se muestra una sola vez. Las cuentas verificadas reciben 25 búsquedas por día UTC compartidas entre todas sus claves, con hasta dos claves nuevas por día. Revoca una clave 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"

Envía el secreto devuelto como x-api-key o Authorization: Bearer YOUR_KEY a la API REST o como un encabezado personalizado en un cliente MCP. Los invitados pueden ejecutar tres búsquedas en total sin iniciar sesión. Las claves existentes no reclamadas tienen una asignación de gracia hasta el 7 de octubre de 2026 a las 00:00 UTC; reclámalas desde tu página de cuenta.

Dos búsquedas pueden ejecutarse simultáneamente por cuenta. Hasta diez trabajos en cola o en ejecución pueden esperar en el flujo de trabajo asíncrono. Consulta el mismo trabajo en cola y respeta Retry-After. Las búsquedas incluidas dependen de la capacidad compartida gratuita del proveedor. Si esta o tu asignación diaria se agota, las búsquedas nuevas usan créditos prepagados cuando están disponibles. Los resultados en caché siguen siendo gratuitos y las búsquedas fallidas devuelven su crédito de búsqueda; una búsqueda nueva completada cuenta incluso cuando no se encuentran coincidencias. Lee el uso y cualquier oferta de capacidad configurada en GET /api/v1/account.

Ejecuta una búsqueda

Envía un objetivo y una geografía al endpoint estable v1. Añade un Idempotency-Key al iniciar un trabajo reanudable para que los reintentos de red no puedan crear trabajo 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"]
  }'

La respuesta incluye resultados, fuentes buscadas, advertencias, diagnósticos, búsquedas gratuitas restantes y URLs de evidencia. Consulta el contrato OpenAPI 3.1 o el estado en vivo.

Respaldo de navegador

Acceso mediante navegador sin interfaz

Un navegador con capacidad de JavaScript puede usar el producto normal. Los controles principales tienen nombres estables e IDs de prueba para Playwright, Browser Use y agentes similares.

1. Abre https://crawdar.com/.
2. Completa [data-testid="target-input"] y [data-testid="quick-geography-input"].
3. Haz clic en [data-testid="quick-search-button"].
4. Espera a [data-testid="search-results"], luego inspecciona los carriles Calificado, Posible y Excluido.

Prefiere MCP o la API cuando sea posible. Devuelven JSON estructurado sin automatización de interfaz.

Mantén tu investigación

Listas de prospectos persistentes

Usa tus listas o /api/v1/lists con una cuenta verificada. Crea una lista con nombre, luego importa una búsqueda completada usando su searchToken firmado o su jobId y jobToken privado. Renombra con PATCH /api/v1/lists/{id} o elimina la lista y sus filas guardadas con DELETE /api/v1/lists/{id}. Las empresas se deduplican entre búsquedas. Filtra prospectos por texto, estado o disponibilidad de contacto, luego exporta CSV para importación a CRM con evidencia de fuentes y fechas de observación.

POST /api/v1/lists/{id}/refresh verifica un prospecto con evidencia de más de siete días por llamada e informa campos cambiados. La evidencia anterior permanece cuando no se encuentra una coincidencia actual. La actualización usa las asignaciones normales de búsqueda. Las cuentas pueden mantener 100 listas con 1,000 prospectos cada una.

Bucle de agente recomendado

Busca, inspecciona y luego actúa.

1. Llama a explain_crawdar una vez cuando la semántica de resultados no te sea familiar.
2. Para un flujo de trabajo reanudable, llama a start_lead_search y almacena el id y jobToken devueltos de forma segura.
3. Llama a get_lead_search con view: "compact" y un límite pequeño. Si el estado es running, respeta el intervalo de reintento. Si es reintentable, llama a retry_lead_search.
4. Inspecciona la evidencia y las verificaciones de calificación. Mantén las URLs de origen con cada registro posterior.
5. Si los resultados están vacíos, inspecciona los diagnósticos y las exclusiones explicadas antes de refinar el resumen.
6. Pasa nextCursor de vuelta sin cambios. Solicita full solo cuando se necesite evidencia detallada.

Reglas operativas

Mantén la evidencia adjunta.

Verifica antes de actuar

La confianza mide la evidencia disponible. No es una garantía de que una empresa sea adecuada, activa o esté lista para comprar. Compara los criterios devueltos con el resumen original: una etiqueta calificada significa que las verificaciones registradas pasaron, no que se entendió cada matiz.

Maneja los datos faltantes con honestidad

Un campo faltante permanece faltante. No infieras correos personales, ingresos, propiedad o un atributo negativo del silencio. Los resultados MCP compactos exponen sourceUrls; los resultados REST completos y de sandbox conservan evidence[].url.

Respeta límites y políticas

El uso gratuito de API y MCP tiene límite de velocidad. Respeta las respuestas de reintento y los términos de rastreo, privacidad y uso responsable. Inspecciona errorCode, requestId y las guías de reintento cuando una herramienta falle.