API y servidor MCP de Citevana

API REST

Todas las respuestas son JSON. Las respuestas correctas incluyen "ok": true. Las herramientas gratuitas devuelven un resumen en lenguaje sencillo y una lista de tareas ordenada por importancia, con tiempos estimados.

Ejemplo de solicitud

curl -s https://citevana.com/api/v1/tools/ai-crawlers \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

curl -s https://citevana.com/api/v1/sites \
  -H "Authorization: Bearer $CITEVANA_API_KEY"

Errores

Todos los errores usan la misma estructura JSON, que se muestra abajo. Los códigos incluyen invalid_request, invalid_url, blocked_host, fetch_failed, unauthorized, insufficient_scope, not_found, rate_limited y quota_exceeded.

{
  "ok": false,
  "error": {
    "code": "quota_exceeded",
    "message": "Daily api_calls quota reached."
  },
  "requestId": "req_…"
}

Límites y cabeceras

Cada respuesta medida incluye X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset (segundos Unix). Una respuesta 429 incluye además Retry-After. Las llamadas con clave cuentan para la cuota diaria api_calls de tu espacio de trabajo, y cada clave puede tener su propio límite diario más bajo.

Los navegadores pueden llamar a las herramientas gratuitas desde cualquier sitio sin clave. Los endpoints que requieren clave no admiten solicitudes de navegador entre orígenes: llámalos desde tu servidor.

Añade ?locale=es, pt-BR, de, fr, ja, id, hi, tr, vi o ar a un endpoint de herramienta para recibir el resumen en ese idioma.

Fuente, revisada el 16 de septiembre de 2026: https://spec.openapis.org/oas/v3.1.1.html

Servidor MCP

Conecta cualquier cliente MCP que admita servidores remotos a https://citevana.com/api/mcp. Usa el transporte Streamable HTTP, responde en JSON y no mantiene sesiones.

• check_ai_crawlers — Qué rastreadores de IA de búsqueda, asistentes y entrenamiento permite un sitio. Gratis.
• audit_page — Auditoría de SEO on-page y preparación para IA de una URL. Gratis.
• generate_llms_txt — Crea un archivo llms.txt a partir del nombre del sitio, un resumen y enlaces. Gratis; no se descarga nada.
• get_site_audit_summary — Última auditoría de uno de tus sitios. Requiere una clave de API con read:audits.

El servidor admite la revisión 2026-07-28 del protocolo (metadatos por solicitud y server/discover). También acepta el handshake initialize de las revisiones 2025-11-25, 2025-06-18 y 2025-03-26.

Las tres herramientas gratuitas funcionan sin autenticación. Para get_site_audit_summary, tu cliente debe enviar tu clave de API en una cabecera Authorization: Bearer. Citevana aún no ofrece inicio de sesión OAuth para MCP.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "check_ai_crawlers",
    "arguments": {
      "url": "https://example.com"
    },
    "_meta": {
      "io.modelcontextprotocol/protocolVersion": "2026-07-28",
      "io.modelcontextprotocol/clientCapabilities": {}
    }
  }
}

Fuente, revisada el 16 de septiembre de 2026: https://modelcontextprotocol.io/specification/2026-07-28/basic/transports/streamable-http

Otros clientes MCP y tus propios agentes

Si tu cliente permite definir cabeceras HTTP para un servidor remoto, añade Authorization: Bearer seguido de tu clave para activar get_site_audit_summary. Cada llamada cuenta para la misma cuota diaria api_calls que la API REST.

Extensión de Chrome

La extensión de Chrome de Citevana ejecuta, mediante esta API, la comprobación de rastreadores de IA y la auditoría de la pestaña que estás viendo. No necesita cuenta; con una clave opcional ves las auditorías de tus sitios. Se está preparando para Chrome Web Store.

Solo pide los permisos activeTab y storage, además de acceso a la API de Citevana. Envía la dirección de la página solo cuando pulsas una comprobación, y nunca envía la cadena de consulta.

Fuente, revisada el 16 de septiembre de 2026: https://developer.chrome.com/docs/extensions/develop/concepts/activeTab

Seguridad y privacidad

• Todas las herramientas son de solo lectura. Nunca se modifica nada en tu sitio web.
• El texto copiado de las páginas descargadas se marca como datos no confiables, para que los asistentes de IA nunca sigan instrucciones que contenga.
• Solo descargamos páginas públicas, como CitevanaBot, y bloqueamos direcciones de redes privadas y reservadas.
• Solo guardamos un hash SHA-256 de cada clave de API. La clave se muestra una vez y puedes revocarla cuando quieras. La creación y la revocación de claves quedan en el registro de auditoría.

CitevanaBot

Preguntas frecuentes

Fuentes

• https://modelcontextprotocol.io/specification/2026-07-28/basic/transports/streamable-http
• https://modelcontextprotocol.io/specification/2026-07-28/basic/versioning
• https://developers.openai.com/apps-sdk/deploy/connect-chatgpt
• https://developers.openai.com/apps-sdk/build/auth
• https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp
• https://spec.openapis.org/oas/v3.1.1.html
• https://developer.chrome.com/docs/extensions/develop/concepts/activeTab
• https://developer.chrome.com/docs/webstore/program-policies/policies