Search Console Insights (importación por carga)

Search Console Insights analiza tus exportaciones de Google Search Console sin que tengas que conectar la API. Subes el archivo ZIP, el módulo reconoce automáticamente el tipo (rendimiento o indexación), calcula insights priorizados de forma determinista y deja que la IA explique cada recomendación en texto claro con un ejemplo concreto.

Qué puede hacer

• Dos tipos de exportación, detección automática — Rendimiento ("Performance on Search": consultas de búsqueda, páginas, países, dispositivos, apariencia, gráfico) e Indexación ("Coverage": indexado vs. no indexado a lo largo del tiempo, problemas críticos). El tipo se reconoce automáticamente por la estructura del archivo/columnas.
• Detección de oportunidades (rendimiento) — Striking Distance (posiciones 11–20 con potencial), valores atípicos de CTR (impresiones altas, CTR demasiado bajo → oportunidad de title/meta), "muy visto, poco clicado", marca vs. no marca, distribución de posiciones, tendencia de clics.
• Detección de errores (indexación) — tendencia de indexación, errores 404, redirecciones, "excluida por noindex", "rastreada, actualmente no indexada", entre otros — priorizados por páginas afectadas.
• Cifras deterministas + explicación de IA — todas las métricas se calculan en PHP (sin valores inventados); la IA explica cada tarjeta de forma comprensible y ofrece medidas concretas con ejemplo (p. ej. un title propuesto).
• Asignación a proyecto y filtro — asigna cada carga a un proyecto (al subir o posteriormente) y filtra el panel por proyecto.

Cuándo usarlo

• No tienes conexión OAuth, pero igualmente quieres analizar tus datos de GSC.
• Vista rápida de quick wins (palabras clave en página 2, oportunidades de CTR) y problemas de indexación.
• Análisis separado por cliente/proyecto de varias propiedades.

Flujo de trabajo en la interfaz

1. Exportar — en Google Search Console, exporta el informe de rendimiento o de indexación como ZIP.
2. Subir — en /search-console sube el ZIP (máx. 25 MB); opcionalmente asigna un proyecto.
3. Analizar — aparecen KPIs, gráfico de tendencia y tarjetas de insights; las explicaciones de IA se completan en segundo plano (cola ai).
4. Implementar — procesa las tarjetas por impacto; cada tarjeta indica un próximo paso concreto con ejemplo.

Vía el chat de IA / la API

El Agente Rankion puede usar el módulo directamente:

• GET /api/v1/search-console — lista todas las cargas del equipo (opcional ?project_id=). Devuelve por cada carga type, property, período, número de filas y el id.
• GET /api/v1/search-console/{id} — devuelve los insights de una carga: metrics deterministas más ai_summary y ai_actions (medida + ejemplo) por tarjeta.

Pregunta típica de chat: "Mira los datos de Search Console de <Dominio> y ayúdame a mejorarlos." → El agente lista las cargas, elige la adecuada y obtiene los insights.

Importante saber (realidad de los datos)

• La exportación desde la interfaz de GSC está limitada a 1.000 filas por tabla y aproximadamente el 45 % de las consultas de búsqueda están anonimizadas → los totales generales están sistemáticamente subestimados. Por eso el módulo muestra oportunidades relativas, no totales exactos.
• La canibalización y el desajuste consulta-página requieren Query+Page en una misma fila (solo disponible vía API/exportación masiva) y no se pueden derivar de forma fiable a partir de la simple carga.
• Los errores reales de índice/cobertura solo aparecen completos en el informe de indexación de GSC; la carga proporciona a partir de ahí las categorías críticas de problemas con el número de páginas.