# SIS SEO INTELLIGENCE SYSTEM — Agent Context (llms.txt)

> SIS SEO INTELLIGENCE SYSTEM - Una plataforma de inteligencia SEO para diagnosticar, priorizar y ejecutar. Mucho más que una auditoría: un sistema que transforma el análisis en decisiones accionables.
> WRS: 98/100 — Nivel 3 Agent-Agnostic. Engine: WebMCP 5.4.0-strict.

## Identidad y Propósito
SIS SEO Intelligence System es una plataforma interactiva y API agéntica diseñada para auditar la madurez técnica SEO de sitios web, evaluar la preparación agéntica (WebMCP Readiness), ejecutar análisis de contenido con IA (Gemini 3.6 Flash) y proporcionar métricas de avance por fases mediante el marco estratégico SOSTAC®.

## Servidor MCP SSE Nativo & Contratos de Herramientas
- **SSE Stream**: `GET /mcp` (`Accept: text/event-stream`)
- **JSON-RPC 2.0 Endpoint**: `POST /mcp`
- **Protocolo**: Model Context Protocol (MCP) v1.1
- **Manifiesto Completo de Herramientas**: `/mcp-config.json`

### Declaración Estructurada de Herramientas (Tool Contracts)

```yaml
tools:
  - tool: audit_website_seo
    description: Auditoría técnica SEO completa en tiempo real de un dominio (Status code, TTFB, Robots.txt, Sitemap, llms.txt, AI Plugin).
    inputs:
      - url: string (URL absoluta del sitio web)
    outputs:
      - statusCode: number
      - ttfbMs: number
      - hasTitle: boolean
      - hasMetaDescription: boolean
      - hasH1: boolean
      - hasLlmsTxt: boolean
      - hasAiPlugin: boolean
      - hasMcpSse: boolean
      - technicalScore: number (0-100)
      - issues: array
      - recommendations: array
    deterministic: true
    estimated_latency: 3-8s
    depends_on: []
    model: null

  - tool: webmcp_audit
    description: Audita la preparación e interoperabilidad WebMCP (WRS Score 0-100) de un sitio web para agentes de IA.
    inputs:
      - url: string
    outputs:
      - wrsScore: number (0-100)
      - level: string (Nivel 1, 2 o 3 Agent-Agnostic)
      - pillars: object (crawlers, discovery, semantics, webmcp)
    deterministic: true
    estimated_latency: 2-5s
    depends_on: []
    model: null

  - tool: eval_posicion_cero
    description: Calcula el score agéntico Posición Cero™ v1.4 (IPP x S x WRS).
    inputs:
      - target: string (Dominio o URL)
      - name: string (Nombre de marca opcional)
    outputs:
      - ippScore: number
      - semanticScore: number
      - wrsScore: number
      - posicionCeroScore: number (0-100)
      - verdict: string
    deterministic: true
    estimated_latency: 2-4s
    depends_on: []
    model: null

  - tool: get_sostac_metrics
    description: Obtiene las métricas del radar estratégico SOSTAC® y avance por fases.
    inputs:
      - profileId: string (opcional)
    outputs:
      - profileName: string
      - overallProgress: number
      - sostacScores: object (situation, objectives, strategy, tactics, action, control)
    deterministic: true
    estimated_latency: 1-2s
    depends_on: []
    model: null

  - tool: generate_meta_tags
    description: Genera opciones persuasivas de Title y Meta Description con IA.
    inputs:
      - keyword: string
      - businessDescription: string
      - pageType: string (opcional)
      - tone: string (opcional)
    outputs:
      - titleOptions: array
      - metaDescriptionOptions: array
      - reasoning: string
    deterministic: false
    estimated_latency: 2-4s
    depends_on: []
    model: Gemini 3.6 Flash

  - tool: analyze_page_content
    description: Analiza legibilidad, densidad semántica de keywords y jerarquía H1-H3.
    inputs:
      - text: string
      - targetKeyword: string (opcional)
    outputs:
      - readabilityScore: number
      - keywordDensityPercent: number
      - headingStructureHealth: string
      - actionableRecommendations: array
    deterministic: false
    estimated_latency: 3-6s
    depends_on: []
    model: Gemini 3.6 Flash

  - tool: generate_schema_jsonld
    description: Genera marcado estructurado JSON-LD válido para Schema.org.
    inputs:
      - schemaType: string (Organization, LocalBusiness, Article, FAQPage, Product, Service)
      - businessName: string
      - url: string
      - details: string (opcional)
    outputs:
      - jsonld: object
      - validationStatus: string
    deterministic: false
    estimated_latency: 2-4s
    depends_on: []
    model: Gemini 3.6 Flash

  - tool: generate_seo_brief
    description: Genera una guía/brief estratégico de redacción SEO para redactores.
    inputs:
      - topic: string
      - targetAudience: string (opcional)
      - targetKeywords: array (opcional)
    outputs:
      - h1Title: string
      - outline: array
      - lsiKeywords: array
      - targetWordCount: number
      - toneAndStyle: string
    deterministic: false
    estimated_latency: 4-8s
    depends_on: []
    model: Gemini 3.6 Flash

  - tool: evaluate_ia_readiness
    description: Evalúa la preparación de un dominio para ser indexado, comprendido y citado por agentes de IA (permisos de crawlers, /llms.txt, Schema.org, WebMCP) y genera un plan de acción priorizado.
    inputs:
      - targetDomain: string (dominio o URL a evaluar)
    outputs:
      - target: string
      - totalScore: number (0-100)
      - pillars: object (crawlers, discovery, semantics, mcpApis — cada uno con score, status y details)
      - criticalGaps: array (id, category, title, impact, fix)
      - actionPlan: array (step, title, detail, estimate)
      - source: string ("ai" cuando Gemini generó el análisis en vivo, "heuristic_fallback" cuando el servicio de IA no estuvo disponible y se usó el evaluador determinístico local)
    deterministic: false
    estimated_latency: 3-7s
    depends_on: []
    model: Gemini 3.6 Flash (con fallback a gemini-flash-latest y gemini-3.1-pro-preview)
    fallback: Evaluador heurístico determinístico de servidor si la API de Gemini no responde.

  - tool: evaluate_citability
    description: Analiza un texto (artículo, blog, landing) y calcula su "Citabilidad" — qué tan fácil es para un LLM extraer datos concretos del contenido y citar la fuente sin alucinar — según 8 criterios (estructura, datos citables, fuentes de autoridad, respuestas directas, E-E-A-T, ejemplos concretos, formato AI-friendly, citabilidad sintáctica).
    inputs:
      - content: string (mínimo 50 caracteres)
    outputs:
      - score: number (0-100)
      - verdict: string (Excelente, Bueno, Aceptable, Deficiente)
      - description: string
      - criteria: array (name, score, reason, level: success/warning/critical)
      - previews: object (chatgpt, gemini — así respondería cada asistente citando el contenido)
      - gaps: array (title, impact, effort, actions)
      - impact: string (incremento potencial estimado en citaciones, ej. "+45%")
      - source: string ("ai" cuando Gemini generó el análisis en vivo, "heuristic_fallback" cuando se usó el evaluador determinístico local)
    deterministic: false
    estimated_latency: 2-6s
    depends_on: []
    model: Gemini 3.6 Flash (con fallback a gemini-flash-latest y gemini-3.1-pro-preview)
    fallback: Evaluador heurístico determinístico de servidor si la API de Gemini no responde (siempre HTTP 200, etiquetado con source).
```