Desarrolladores y agentes de IA

Clarity dentro de tus IA y agentes

Mide cómo hablan ChatGPT, Gemini, Perplexity, Claude y Grok de una marca y comprueba si una web está lista para la búsqueda con IA. Desde código, agentes de IA o como conector en Claude y ChatGPT. Pagas solo las llamadas que haces.

ChatGPTClaudeGeminiPerplexityGrok
1

Crea una cuenta y una clave

Regístrate gratis y crea una clave API en Panel → API y conectores. Los conectores no la necesitan: basta con iniciar sesión.

2

Recarga créditos

Créditos prepago con Stripe, factura incluida. Sin suscripción ni caducidad mensual.

3

Llama a las herramientas

Por REST o MCP. Cada llamada descuenta créditos y, si falla, se reembolsa automáticamente.

Herramientas y precios

Precios en tiempo real, descontados de los créditos prepago (1 crédito = 1 €).

visibility_check€0.35 por modelo

Hace una pregunta real a los modelos de IA con búsqueda web activa y te dice si la marca aparece, cuántas veces, en qué posición de las listas, qué competidores salen y qué fuentes se usan.

Parámetros (* obligatorios)

brand*, question*, models[], competitors[], brand_domain

geo_audit€0.50 por llamada

Comprueba si una web puede ser leída y citada por las IA: rastreadores de IA en robots.txt y firewall, llms.txt y llms-full.txt, sitemap, contenido sin JavaScript, schema Organization, directivas de snippet, páginas de confianza. Puntuación 0-100 con cada control.

Parámetros (* obligatorios)

url*

Modelos disponibles ahora: ChatGPT (chatgpt), Google Gemini (gemini)

Inicio rápido

Dos llamadas de ejemplo. Sustituye clr_YOUR_API_KEY por tu clave.

curl -X POST https://clarity.whooho.it/api/v1/visibility \
  -H "Authorization: Bearer clr_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "brand": "Acme Bikes",
    "question": "What are the best e-bike shops in Milan?",
    "models": ["chatgpt", "perplexity"],
    "competitors": ["BikeLand", "Velo Milano"],
    "brand_domain": "acmebikes.it"
  }'
curl -X POST https://clarity.whooho.it/api/v1/geo-audit \
  -H "Authorization: Bearer clr_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "url": "acmebikes.it" }'

Ejemplo de respuesta (abreviada):

{
  "request_id": "req_9f2c…",
  "tool": "visibility_check",
  "charged_cents": 70,
  "refunded_cents": 0,
  "balance_cents": 1930,
  "result": {
    "summary": { "models_asked": 2, "models_answered": 2, "mentioned_in": 1, "visibility_percent": 50 },
    "models": [{
      "model": "chatgpt",
      "brand": { "mentioned": true, "mention_count": 2, "list_rank": 3, "excerpt": "…Acme Bikes in Navigli offers…" },
      "competitors": [{ "name": "BikeLand", "mentioned": true, "list_rank": 1 }],
      "brand_domain_cited": true,
      "sources": [{ "url": "https://…", "title": "…", "domain": "…" }],
      "answer": "…"
    }]
  }
}

Conector para Claude, ChatGPT y otras IA

Clarity es un servidor MCP remoto con acceso OAuth: cada usuario se conecta con su cuenta y sus créditos. URL del servidor:

https://clarity.whooho.it/api/mcp
Claude

Claude (web, escritorio, móvil)

  1. Ajustes → Conectores → Añadir conector personalizado.
  2. Nombre: Clarity. URL: la de arriba.
  3. Conectar → inicia sesión en Clarity → Permitir.
  4. Pregunta por ejemplo: "Usa Clarity para ver si ChatGPT recomienda mi tienda de bicis eléctricas en Milán".
ChatGPT

ChatGPT

  1. Ajustes → Apps y conectores → ajustes avanzados: activa el modo desarrollador.
  2. Crea un conector: nombre Clarity, la URL de arriba, autenticación OAuth.
  3. Inicia sesión en Clarity y permite el acceso.
  4. Activa el conector en un chat y pide una auditoría o un control de visibilidad.

Claude Code, Cursor, agentes y otros clientes MCP (con clave API)

claude mcp add --transport http clarity https://clarity.whooho.it/api/mcp \
  --header "Authorization: Bearer clr_YOUR_API_KEY"

O, en los clientes que usan un archivo de configuración JSON:

{
  "mcpServers": {
    "clarity": {
      "type": "http",
      "url": "https://clarity.whooho.it/api/mcp",
      "headers": {
        "Authorization": "Bearer clr_YOUR_API_KEY"
      }
    }
  }
}

Créditos y facturación

  • •Recargas disponibles: €10, €25, €50, €100. Pago con Stripe y factura automática.
  • •El precio se descuenta antes de la llamada: si el crédito no basta, la llamada no se ejecuta (error 402).
  • •Si una llamada o un modelo concreto falla, esa parte se reembolsa automáticamente.
  • •Los créditos no caducan. Cada respuesta indica lo cobrado y el saldo restante.

Seguridad

  • •Las claves API se guardan solo como huella criptográfica (SHA-256): ni siquiera nosotros podemos leerlas. Puedes revocarlas con un clic.
  • •Los conectores usan OAuth 2.1 con PKCE: tu contraseña nunca pasa por la app de IA. Los tokens de acceso duran una hora y rotan al renovarse.
  • •Un conector solo ve créditos y herramientas: no tus marcas, análisis ni datos de pago.
  • •Las direcciones analizadas se controlan: nada de redes privadas, servidores internos o metadatos cloud. Límites de frecuencia, tamaño y tiempo en cada llamada.
  • •Las preguntas que envías se pasan a los modelos de IA (OpenAI, Google, Perplexity y otros) como lo haría un usuario: no incluyas datos personales o confidenciales.

Errores y límites

400invalid_input / invalid_url / invalid_modelParámetros no válidos: el mensaje indica cuál.
401unauthorizedClave o token ausente, revocado o caducado.
402insufficient_creditsCrédito insuficiente: la respuesta incluye precio y saldo.
403tool_disabledHerramienta desactivada temporalmente.
413payload_too_largeSolicitud demasiado grande.
429rate_limited / too_many_concurrentDemasiadas llamadas: reduce el ritmo y reintenta.
502audit_failedEl sitio a analizar no responde (crédito reembolsado).
503capacity / no_modelsCapacidad diaria alcanzada o ningún modelo disponible: reintenta más tarde.

Límites actuales: 20 llamadas por minuto por clave, 3 llamadas simultáneas por cuenta, respuesta en 2 minutos.

Para máquinas y agentes