KusiAI Logo KusiAI
Recursos para Desarrolladores y Agentes de IA

Portal de Desarrolladores & Agentes Autónomos

KusiAI está diseñada desde el primer paquete TCP para ser consumida y operada por agentes inteligentes de software. Consulta aquí nuestra especificación OpenAPI 3.1, la integración de Model Context Protocol (MCP) y los estándares de autenticación agéntica.

Especificación REST

OpenAPI 3.1

Contrato JSON v1 con esquemas tipados para Function Calling.

Ver /openapi.json →
Catálogo ARD

AI Catalog

Descubrimiento global de recursos y capacidades para agentes.

Ver ai-catalog.json →
Estándar MCP

MCP Server

Manifiesto de herramientas para Claude Desktop y Cursor.

Ver server-card.json →
Autenticación

Auth.md RFC

Protocolo de registro y provisión de credenciales para bots.

Ver /auth.md →

Endpoints Principales de la API (v1)

POST https://kusiai.es/api/v1/audit

Ejecuta una auditoría forense síncrona determinista de visibilidad en IA, detección de bloqueos WAF 403 y cálculo de Citation Share. Soporta la cabecera Idempotency-Key.

{ "url": "https://tu-dominio.com", "market": "ES" }
POST (ASYNC) https://kusiai.es/api/v1/audit/async

Lanza un trabajo de auditoría en segundo plano para análisis masivos. Devuelve 202 Accepted con un job_id y URL de sondeo en la cabecera Location.

Consulta de estado: GET https://kusiai.es/api/v1/jobs/{job_id}
GET https://kusiai.es/api/v1/citation-share?domain=empresa.com&limit=20&offset=0

Devuelve la cuota de citación cuantitativa calculada sobre prompts comerciales en 6 modelos de frontera, con soporte de paginación estructurada.

GET https://kusiai.es/api/v1/search?query=citation+share&limit=20

Consulta vectorial sobre el grafo semántico de KusiAI (1536 dimensiones) optimizado para sistemas RAG con paginación por cursor.

Librerías y SDKs Oficiales

Python SDK

Cliente asíncrono para pipelines de datos y evaluación de modelos.

pip install kusiai-sdk

Node.js / TypeScript SDK

Integración nativa para frameworks web y agentes autónomos.

npm install @kusiai/sdk

Integración con Model Context Protocol (MCP)

Para conectar un agente de escritorio (como Claude Desktop o Cursor) directamente a nuestro servidor de herramientas, añade la siguiente configuración en tu archivo claude_desktop_config.json: 

{
  "mcpServers": {
    "kusiai": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-fetch", "https://kusiai.es/api/openapi.json"]
    }
  }
}

Documentos Canónicos de la Arquitectura