Recursos para developers

REST API, MCP Server para agentes de IA, webhooks y ejemplos de código.

Autenticación

Todas las peticiones a la API requieren una API key enviada en la cabecera Authorization. Authorization.

Authorization: Bearer YOUR_API_KEY

Genera tus API keys desde la configuración de tu cuenta. Heredan los límites de tu plan.

REST API

Próximamente

Acceso programático a tus datos de KatanaSEO. Gestiona perfiles, keywords, artículos y rankings vía REST.

Funciones

+CRUD completo para perfiles, keywords y artículos
+Endpoints de rankings y analítica
+Gestión de webhooks
+Rate limiting: 100 req/min (Pro), 500 req/min (Business)

Ejemplo

curl -X GET "https://api.katanaseo.com/v1/profiles" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Servidor MCP (agentes de IA)

Beta

Conecta agentes de IA como Claude, Cursor o Windsurf a tus datos SEO mediante Model Context Protocol.

Funciones

+Consulta keyword research desde editores con IA
+Revisa scores SEO y rankings de artículos
+Lanza generación de contenido desde workflows con IA
+Compatible con Claude Desktop, Cursor y Windsurf

Ejemplo

{
  "mcpServers": {
    "katanaseo": {
      "command": "npx",
      "args": ["-y", "@katanaseo/mcp-server"],
      "env": {
        "KATANASEO_API_KEY": "your_api_key"
      }
    }
  }
}

Webhooks

Activo

Recibe notificaciones en tiempo real y publica artículos en cualquier sistema mediante integración CMS por webhook.

Funciones

+Eventos: job.started, job.progress, job.completed, job.failed
+Webhook CMS para publicar artículos en cualquier endpoint HTTPS
+Firma HMAC + Bearer token + verificación por timestamp
+Reintentos automáticos con exponential backoff

Ejemplo

// Webhook CMS payload
{
  "event": "article.sync",
  "timestamp": 1711267200,
  "article": {
    "title": "How to Improve Core Web Vitals",
    "slug": "improve-core-web-vitals",
    "content_html": "<h1>...</h1>",
    "status": "published"
  }
}

Construye sobre KatanaSEO

Empieza hoy con webhooks. La API y el MCP Server están en camino.