SEO Plugin

Plugin público para Codex que reúne 50 Marketing Skills y tres integraciones Google de solo lectura: Analytics, Search Console y Business Profile. Incluye perfiles multi-account y un dashboard Astro local para consultar auditorías privadas.

Uso rápido

Abre una tarea nueva y ejecuta:

/seo full https://example.com proyecto=MiProyecto profileId=mi-perfil

La skill seo coordina el análisis técnico, las skills especializadas, Search Console, Analytics y Business Profile, y guarda el informe en el dashboard privado. El modo completo captura 90 días diarios frente a los 90 anteriores, hasta 12 meses de tendencia, KPIs comparativos, snapshots, gráficas por fuente disponible, tablas accesibles, PNG/CSV y un plan medible. Rastrea hasta 500 URLs y selecciona hasta 50 páginas para diagnóstico profundo, capturas y cruces de datos. También puede invocarse como $seo full.

El detalle de auditoría incluye una pestaña Perfil de empresa con vista de ficha, galería, servicios, atributos, reseñas, publicaciones y rendimiento local. Por política de Google, ese contenido se conserva en una caché privada separada durante un máximo de 30 días y nunca se publica en GitHub.

Los snapshots v5 guardan diferencias por URL, idiomas esperados/declarados, cobertura de evidencia (HTTP, DOM, capturas, Lighthouse, CrUX y Google), inventario técnico y estado reanudable en .seo-data/runs/. La referencia de Business Profile apunta a una caché temporal privada, nunca al contenido persistente. Chrome/Chromium se ejecuta en un perfil efímero; si no está disponible, el rastreo HTTP continúa y se registra la limitación.

Instalación local

codex plugin marketplace add /Users/gtrave/Documents/seo-plugin
codex plugin add seo@seo-marketplace
cd /Users/gtrave/Documents/seo-plugin/plugins/seo
npm install
npm run dashboard

El dashboard solo escucha en http://127.0.0.1:4321. Los resultados se guardan en .seo-data/, que está excluido completamente de Git.

Cada auditoría tiene una cuota fija de 512.000.000 bytes (512 MB), medida con lstat sin seguir enlaces simbólicos. El panel de almacenamiento aparece como última sección del detalle y desglosa datos estructurados, Markdown, páginas/métricas y assets. Las escrituras se bloquean antes de superar el límite y devuelven audit-storage-limit-exceeded; no se borran ni comprimen archivos existentes.

Instalación desde GitHub

codex plugin marketplace add Tutitoos/seo-plugin --ref main
codex plugin add seo@seo-marketplace

Por defecto, los datos privados se guardan en ~/Documents/seo-plugin/.seo-data. Se puede cambiar la ubicación con SEO_PLUGIN_DATA_DIR.

Origen de las skills

Las 50 Marketing Skills proceden de coreyhaines31/marketingskills, snapshot d4ff28a9c8d56c06809860bf2800d4f5224b52db (MIT). Consulta UPSTREAM.md.

Seguridad

• Los tokens OAuth permanecen en el Llavero de macOS.
• Las APIs Google se usan en modo lectura; Business Profile requiere el scope de Google business.manage, aunque las herramientas expuestas no escriben.
• El contenido probatorio de cada snapshot es de solo lectura. El dashboard solo permite editar el tracker de incidencias, protegido por loopback, mismo origen y token CSRF.
• El único almacenamiento modificable por el plugin es .seo-data/.