audit-template-crafters.md

---
name: audit-template-crafters
description: Plantilla HTML de auditoría SEO premium estilo presentación 16:9. Proyecto en curso con Crafters of Today como caso de prueba.
type: project
originSessionId: 4b0f3c88-5373-4955-bb66-542ccb88ef22
---
## Estado del Proyecto — Auditoría SEO Template

**Ubicación:** `C:\tmp\audit-template\`
- `template.html` — Plantilla HTML principal (16:9, 1280x720px slides)
- `images/` — Imágenes extraídas del PPTX original de Webpositer
- `audit_interpreter.py` — Módulo Gemini 3.1 Flash Lite para generar síntesis/conclusiones
- `auditoria-crafters.pdf` — PDF generado con Playwright (Chromium headless)

**VPS:** Todo en `/home/ubuntu/proyectos-cloud/auditoria-seo/audit-premium/`

## Agentes Especializados (8 archivos en agents/)

| Archivo | Sección | Función |
|---|---|---|
| `base_agent.py` | — | Config Gemini, reglas globales, función `interpret()` |
| `agent_posicionamiento.py` | 1.1 | Keywords, tráfico estimado, mercados |
| `agent_autoridad.py` | 1.2 | DR, backlinks, perfil de enlaces |
| `agent_visibilidad.py` | 1.3 | Índice de visibilidad, Sistrix |
| `agent_search_console.py` | 1.4 | GSC: queries, CTR, impresiones |
| `agent_analytics.py` | 1.5-1.6 | GA4: tráfico, canales, contenido (2 funciones) |
| `agent_tecnico.py` | 2.1-2.2 | SF: rastreo, errores, on-page (2 funciones) |
| `agent_competencia.py` | 3.x | Nicho, competidores, gap |
| `agent_estrategia.py` | Resumen | Sintetiza todo, prioriza, roadmap |

Modelo: `gemini-3.1-flash-lite-preview`. Cada agente tiene umbrales, criterios de filtrado y personalidad propia.

## SF Config
- `maxURIs=0` (sin límite, cambiado de 500 para premium)
- Crawl en curso: `ed763752` — rastreo completo sin límite
- Config: `/home/ubuntu/proyectos-cloud/sf-api/sf_config.seospiderconfig`

## Estructura Actual (Sección 1 completa)

| Slide | Tipo | Contenido |
|---|---|---|
| 1 | Cover | AUDITORÍA SEO — CRAFTERS OF TODAY |
| 2 | Índice | TOC con secciones 1-6 |
| 3 | Content | Punto 0 — Resumen estado actual |
| 4 | Divider | SITUACIÓN ACTUAL DEL PROYECTO |
| 5 | Audit | 1.1 Posicionamiento (SEMrush ES, barras 24m) |
| 6 | Audit | 1.2 Autoridad (Ahrefs DR 35, evolución, explicación) |
| 7 | Audit | 1.3 Visibilidad (Sistrix ES = 0.00, contexto) |
| 8 | Audit | 1.4 Search Console (GSC España, clicks, queries) |
| 9 | Audit | 1.5 Analytics Tráfico (GA4 7-14 abr, canales, donuts) |
| 10 | Audit | 1.6 Analytics Contenido (páginas, engagement) |
| 11 | Audit | Resumen + Estrategia (diagnóstico + próximos pasos) |
| 12 | Divider | ANÁLISIS DE MERCADO Y COMPETENCIA (por hacer) |
| ... | ... | Resto de secciones template original |

## Pendiente

- **Sección 2 slides:** Datos del SF completo (crawl ed763752 en curso, sin límite de URLs). Actualizar slides 2.1 y 2.2 con datos reales.
- **Sección 3:** Análisis de mercado y competencia (competidores orgánicos, comparativa)
- **Secciones 4-6:** Por definir estructura
- **Integrar agentes** con generador de HTML (cada agente genera la síntesis/conclusión de su slide)
- **Automatizar flujo completo:** dominio → datos APIs → agentes → HTML → PDF
- **Generador HTML:** Script Python que toma datos + output de agentes y produce el HTML con los datos inyectados en la plantilla

## Decisiones de Diseño

- **Font:** Montserrat (títulos 26px #111, subtítulos 12px #666, cuerpo 13px #444-555)
- **Footer:** Barra azul degradada 32px, Montserrat 12px blanco, "Alex Amigo" a la derecha
- **Marca de agua:** "AA" centrado 380px, opacity 3%
- **Accent:** #FF6633 naranja
- **Estructura slide audit:** .slide--audit > .audit__content (header+body) + .audit__footer
- **Síntesis:** max-height 90px, 11px, border-left naranja, sin nombrar herramientas
- **Gráficos:** SVG inline, barras limpias sin solapar, donuts para distribución
- **País foco:** Solo España (max 2 países adicionales si tienen datos)
- **GA4:** Comparar periodo exacto vs mismo periodo año anterior

## OAuth Token Crafters

- **Client ID:** 591244231404-s4s1s5kqjneba3h9lcai98r639r83e0j.apps.googleusercontent.com
- **Refresh token:** 1//033gnNXU6JIjRCgYIARAAGAMSNwF-L9IrWalX-nR6BNL4qVwQA9hKyU4QyNBGWv2Us1dlyjNxl6pZeMS2dTY1uX3kmGKYTruGBu8
- **GSC property:** sc-domain:craftersoftoday.com
- **GA4 property:** 310839961 (accounts/225749428)
- **Scopes:** webmasters.readonly + analytics.readonly
- Token guardado en VPS: `/home/ubuntu/proyectos-cloud/auditoria-seo/gsc_oauth_token_crafters.json`

## Reglas para el Intérprete

- NUNCA nombrar herramientas (SEMrush, Ahrefs, etc.)
- Tono consultor SEO senior, directo, sin relleno
- Síntesis máx 3 frases, conclusión máx 2 frases
- Siempre preguntar al inicio: ¿tenemos GSC? ¿GA4? ¿desde cuándo? ¿país foco?
- PDF con Playwright (Chromium), 1280x720, margin 0, print_background true

**Why:** Alex quiere automatizar auditorías SEO premium con presentación profesional para clientes.
**How to apply:** Continuar sección por sección. Próximo paso: Sección 2 (mercado) o ir directo a arquitectura web.