seo-quote

name	seo-quote
description	Genera un informe de auditoría SEO en formato .docx para cotizaciones y propuestas comerciales. Recopila datos mínimos del sitio (volumen, stack, issues críticos), calcula horas de trabajo y genera un presupuesto en USD. Output: documento entregable al cliente. Invocar cuando el usuario pida "cotización SEO", "presupuesto SEO", "propuesta SEO", "informe de auditoría para cliente" o "/seo-quote".
user-invokable	true
argument-hint	<url> [--rate <usd/h>] [--lang es|en]

SEO Quote Report Generator

Genera un informe-propuesta SEO en .docx listo para entregar a un cliente potencial. No es una auditoría completa: es la exploración mínima suficiente para justificar un diagnóstico, definir un scope de trabajo y calcular un presupuesto creíble.

---

Parámetros de entrada

Parámetro	Default	Descripción
<url>	requerido	URL raíz del sitio a auditar
--rate	60	Tarifa hora en USD
--lang	es	Idioma del documento (es / en)

---

Fase 1: Recolección de datos mínimos

Ejecutar en este orden. Detener y reportar si una fuente falla; continuar con las demás.

1.1 Volumen del sitio (sitemap)

GET <url>/sitemap.xml
GET <url>/sitemap_index.xml   (si el anterior falla o es índice)
GET <url>/post-sitemap.xml    (WordPress)
GET <url>/page-sitemap.xml    (WordPress)

Extraer:

• Total de URLs indexadas (suma de todos los sitemaps)
• Desglose por tipo: posts, páginas, categorías, productos (si aplica)
• Fecha del lastmod más reciente y más antiguo (señal de frecuencia de publicación)

Si no hay sitemap: registrar como issue crítico y estimar volumen desde robots.txt o crawl de homepage.

1.2 Stack tecnológico (homepage)

WebFetch de <url> (homepage). Detectar:

• CMS (WordPress, PrestaShop, Shopify, Wix, custom)
• Plugin SEO activo (Rank Math, Yoast, AIOSEO, The SEO Framework, ninguno)
• Cache/CDN (LiteSpeed Cache, WP Rocket, Cloudflare, W3 Total Cache)
• Constructor de páginas (Divi, Elementor, Gutenberg, otro)
• Advertising (Advanced Ads, AdSense, Mediavine, etc.)
• Analytics/Tag Manager (GA4, GTM, Site Kit)

Señales de detección:

• X-Powered-By, Server headers
• Clases CSS: elementor-, et_pb_, wp-block-
• Paths: /wp-content/, /wp-json/, /modules/, cdn.shopify.com
• Meta generators

1.3 robots.txt

GET <url>/robots.txt

Verificar:

• Existe y es accesible
• Referencia al sitemap principal
• No bloquea recursos CSS/JS críticos ni el raíz /
• Reglas de AI crawlers presentes/ausentes (GPTBot, ClaudeBot, PerplexityBot)

1.4 Señales on-page homepage

Desde el WebFetch de 1.2, extraer:

• <title> tag (presente/ausente, longitud)
• <meta name="description"> (presente/ausente, longitud)
• H1 (presente/ausente, texto)
• Canonical (apunta a sí mismo o a otra URL)
• <meta name="robots"> si existe
• OG tags presentes (og:title, og:description, og:image)
• Schema JSON-LD: listar @types detectados

1.5 Core Web Vitals (DataForSEO o PageSpeed)

Si DataForSEO MCP disponible: on_page_lighthouse sobre la homepage. Si no: WebFetch de https://pagespeed.web.dev/report?url=<url> para extraer scores visibles.

Registrar:

• Performance score (Lighthouse)
• LCP, INP/FID, CLS valores si visibles
• Mobile vs Desktop si hay diferencia notable

1.6 Autoridad de dominio (DataForSEO backlinks)

Si DataForSEO MCP disponible: backlinks_summary para el dominio raíz.

Extraer:

• Referring domains
• Backlinks total
• Rank (DataForSEO Rank o similar)

Si no disponible: omitir sección en el documento o indicar "datos pendientes de herramienta de backlinks".

---

Fase 2: Clasificación de complejidad

Asignar el sitio a uno de tres tiers basándose en los datos recolectados.

Tier A — Sitio pequeño / simple

• Menos de 100 URLs en sitemap
• CMS estándar (WordPress básico, Wix, Squarespace)
• Sin plugin SEO activo o configuración mínima
• Sin e-commerce
• Performance score ≥ 70 mobile

Tier B — Sitio mediano / estándar

• 100–1.000 URLs
• WordPress con plugin SEO (Rank Math, Yoast)
• Page builder activo (Elementor, Divi)
• CDN/cache presente pero con posibles conflictos
• E-commerce pequeño (WooCommerce < 500 productos)
• Performance score 50–70 mobile

Tier C — Sitio grande / complejo

• Más de 1.000 URLs
• Stack complejo (múltiples plugins de cache, ads, analytics, builders)
• E-commerce grande (>500 productos) o multiidioma (hreflang)
• Performance issues críticos (score < 50 mobile)
• Problemas de indexación detectados
• Presencia en múltiples mercados/idiomas

---

Fase 3: Detección de issues

Catalogar cada issue encontrado en Fase 1 asignando:

• Criticidad: Crítico / Alto / Medio / Bajo
• Descripción: qué se detectó
• Impacto SEO: por qué importa (en una línea, lenguaje no técnico)
• Horas estimadas de corrección: ver tabla de horas

Tabla de issues frecuentes y horas por tier

Issue	Criticidad	Horas Tier A	Horas Tier B	Horas Tier C
Sin sitemap XML	Crítico	1	2	3
robots.txt mal configurado	Crítico	1	1	2
Sin plugin SEO activo	Crítico	2	3	5
Sin schema markup	Alto	2	4	8
Meta descriptions ausentes/duplicadas (bulk)	Alto	2	6	14
Títulos fuera de rango o duplicados (bulk)	Alto	2	6	14
Sin H1 o H1 incorrecto (bulk)	Alto	2	4	10
Core Web Vitals en rojo (LCP/INP/CLS)	Alto	4	8	16
Sin HTTPS o mixed content	Crítico	2	3	5
Headers de seguridad ausentes	Medio	1	2	3
Redirect chains (3+ hops)	Alto	2	4	8
Páginas huérfanas significativas	Medio	2	4	8
Imágenes sin alt text (bulk)	Medio	1	3	8
Contenido delgado (< 300 palabras) en páginas clave	Alto	3	8	20
Sin canonical en páginas de listado/paginación	Medio	1	2	4
AI crawlers sin gestionar (robots.txt)	Bajo	1	1	2
Sin llms.txt (GEO/visibilidad en AI Search)	Bajo	1	2	3
E-E-A-T débil (sin autor, sin about, sin trust signals)	Alto	3	6	10
Hreflang ausente en sitio multiidioma	Crítico	4	8	16

Para issues no listados: estimar horas con el criterio de complejidad del tier + factor de volumen de páginas afectadas.

---

Fase 4: Plan de trabajo

Organizar las acciones en 3 fases temporales. Cada fase tiene un objetivo y un conjunto de acciones.

Estructura del plan

Fase 1 — Fundamentos técnicos (semanas 1–2) Acciones críticas y altas que bloquean el SEO base: sitemap, robots.txt, redirects, HTTPS, schema básico, plugin SEO configurado. Sin esta fase, el resto del trabajo no tiene tracción.

Fase 2 — Optimización on-page y contenido (semanas 3–6) Optimización de titles, meta descriptions, H1, imágenes. Mejora de contenido en páginas prioritarias (las que ya rankean o tienen potencial alto). Interlinking.

Fase 3 — Autoridad y visibilidad AI (semanas 7–12) Link building, schema avanzado (FAQ, Article, Organization), GEO (llms.txt, AI crawler policy, structured data para AI citation), reporting mensual.

Ajustar el cronograma si el tier es A (compresión posible a 6 semanas) o C (extensión a 16–20 semanas).

---

Fase 5: Cálculo de presupuesto

Servicios contemplados

Construir una tabla de servicios con horas por servicio basándose en los issues detectados y el tier.

Servicio	Descripción	Horas	Tarifa (USD/h)	Total (USD)
Auditoría SEO técnica inicial	Revisión completa del estado técnico	X	rate	$
Configuración plugin SEO	Setup completo Rank Math / Yoast	X	rate	$
Optimización on-page (bulk)	Titles, metas, H1 en N páginas prioritarias	X	rate	$
Schema markup	Implementación tipos clave	X	rate	$
Core Web Vitals	Diagnóstico y correcciones de performance	X	rate	$
Optimización de contenido	Mejora de N artículos existentes	X	rate	$
Interlinking	Análisis y ejecución de links internos	X	rate	$
GEO / AI Search Visibility	llms.txt, AI crawlers, structured data GEO	X	rate	$
Seguimiento mensual	Reporting + ajustes + monitorización	X	rate	$

Solo incluir los servicios pertinentes para los issues detectados. No inflar con servicios que no aplican.

Cálculo de horas por volumen de sitio

Para optimizaciones bulk (titles, metas, contenido), usar esta escala:

• 1–50 páginas: horas base del issue
• 51–200 páginas: horas base × 2,5
• 201–500 páginas: horas base × 5
• 501–1.000 páginas: horas base × 8

• 1.000 páginas: horas base × 12 + evaluar automatización/scripting (descuento 30% si se aplica scripting)

Totales

• Total horas proyecto: suma
• Total presupuesto (USD): horas × tarifa
• Opción mantenimiento mensual: horas mensuales × tarifa
• Forma de pago sugerida: 50% inicio / 50% entrega (one-time) o mensual (mantenimiento)

Usar formato numérico europeo en el documento: punto para miles, coma para decimales. En código Python interno usar float estándar; solo formatear al escribir el documento.

---

Fase 6: Generación del documento .docx

Generar un script Python con python-docx y ejecutarlo. Guardar en C:/Users/cmano/claude-seo/<cliente>/cotizacion-seo-<slug-dominio>-<YYYY-MM-DD>.docx.

Crear el directorio si no existe.

Estructura del documento

1. Portada
   - Título: "Diagnóstico SEO y Propuesta de Trabajo"
   - Subtítulo: <nombre del sitio> | <fecha>
   - Preparado para: [nombre cliente si disponible]
   - Preparado por: Zythos Media

2. Resumen ejecutivo (1 página)
   - Estado actual: tier + score resumen
   - Issues críticos detectados: N (lista breve)
   - Oportunidad estimada: descripción cualitativa del potencial
   - Inversión total: USD X.XXX

3. Situación actual del sitio
   3.1 Datos generales
       - URL, CMS, stack tecnológico
       - Volumen: N URLs indexadas (posts, páginas, otros)
       - Frecuencia de publicación (estimada)
       - Autoridad de dominio (si disponible)
   3.2 Core Web Vitals
       - Tabla LCP / INP / CLS + valoración pass/warn/fail
   3.3 Visibilidad en búsqueda (si hay datos GSC disponibles)

4. Problemas detectados
   Tabla con columnas: Prioridad | Problema | Impacto | Solución propuesta
   Ordenar de Crítico a Bajo.
   Lenguaje orientado al cliente, no técnico.

5. Plan de trabajo
   5.1 Fase 1 — Fundamentos técnicos
   5.2 Fase 2 — Optimización on-page y contenido
   5.3 Fase 3 — Autoridad y visibilidad AI
   Cada fase: objetivo, acciones, entregables esperados.

6. Cronograma
   Tabla: Fase | Actividad | Semanas | Responsable

7. Presupuesto
   Tabla de servicios con horas y costes.
   Totales bien delimitados.
   Nota de condiciones de pago.

8. Próximos pasos
   3 bullets claros: qué debe hacer el cliente para arrancar.

Estilos del documento

• Fuente cuerpo: Calibri 11
• Fuente títulos: Calibri 14 (sección), 12 (subsección), bold
• Tabla issues: header fila oscura (#1F4E79), texto blanco; filas alternas blancas y #D6E4F0
• Tabla presupuesto: header fila oscura (#1F4E79), texto blanco; fila total en bold con fondo #E8F5E9
• Sin emojis. Sin bullet points estilo ChatGPT. Prosa directa.

Plantilla Python base

from docx import Document
from docx.shared import Pt, RGBColor, Inches, Cm
from docx.enum.text import WD_ALIGN_PARAGRAPH
from docx.oxml.ns import qn
from docx.oxml import OxmlElement
from datetime import datetime
import os

def fmt_usd(value):
    """Formato europeo: 1.234,50"""
    s = f"{value:,.2f}"
    return s.replace(",", "X").replace(".", ",").replace("X", ".")

def add_table_row(table, cells, bold=False, bg_color=None, text_color=None):
    row = table.add_row()
    for i, text in enumerate(cells):
        cell = row.cells[i]
        cell.text = str(text)
        run = cell.paragraphs[0].runs[0] if cell.paragraphs[0].runs else cell.paragraphs[0].add_run(str(text))
        run.font.size = Pt(10)
        run.bold = bold
        if text_color:
            run.font.color.rgb = RGBColor(*text_color)
        if bg_color:
            tc = cell._tc
            tcPr = tc.get_or_add_tcPr()
            shd = OxmlElement('w:shd')
            shd.set(qn('w:fill'), bg_color)
            shd.set(qn('w:val'), 'clear')
            tcPr.append(shd)
    return row

# --- Datos del sitio (completar con los datos recolectados) ---
DATOS = {
    "url": "https://www.debosaber.cl",
    "nombre": "DeboSaber.cl",
    "cms": "WordPress",
    "plugin_seo": "Rank Math",
    "cache": "LiteSpeed Cache",
    "constructor": "Gutenberg",
    "urls_total": 710,
    "urls_posts": 710,
    "urls_paginas": 0,
    "tier": "C",
    "tarifa": 60,
    "fecha": datetime.now().strftime("%d/%m/%Y"),
    "cliente": "DeboSaber.cl",
    "preparado_por": "Zythos Media",
}

ISSUES = [
    # (prioridad, problema, impacto, solucion, horas)
    ("Crítico", "Sin sitemap XML activo", "Google no puede descubrir ni rastrear las páginas eficientemente", "Activar y configurar sitemap en Rank Math", 2),
    ("Alto", "Meta descriptions duplicadas o ausentes en >50% de posts", "El buscador genera snippets automáticos que no invitan al clic", "Optimización bulk de meta descriptions en posts prioritarios", 14),
    # ... más issues
]

SERVICIOS = [
    # (servicio, descripcion, horas, tarifa)
    ("Auditoría SEO técnica inicial", "Revisión completa del estado técnico con informe detallado", 8, DATOS["tarifa"]),
    ("Optimización on-page bulk", f"Titles, metas y H1 en {DATOS['urls_posts']} posts", 28, DATOS["tarifa"]),
    # ... más servicios
]

# --- Generación del documento ---
doc = Document()

# Estilos globales
style = doc.styles['Normal']
style.font.name = 'Calibri'
style.font.size = Pt(11)

# ... (código completo del documento)

output_path = f"C:/Users/cmano/claude-seo/{DATOS['nombre'].lower().replace('.', '-')}/cotizacion-seo-{DATOS['nombre'].lower().replace('.', '-')}-{datetime.now().strftime('%Y-%m-%d')}.docx"
os.makedirs(os.path.dirname(output_path), exist_ok=True)
doc.save(output_path)
print(f"Documento guardado: {output_path}")

El script real generado debe estar completamente funcional y rellenar todos los datos recolectados en las fases 1–5.

---

Output final esperado

1. El documento .docx guardado en C:/Users/cmano/claude-seo/<cliente>/cotizacion-seo-<slug>-<fecha>.docx
2. En el chat: resumen de 5 líneas con:
   • Tier asignado
   • Issues críticos detectados (N)
   • Total horas estimadas
   • Presupuesto total (USD, formato europeo)
   • Ruta del archivo generado

---

Notas de comportamiento

• No preguntar por datos si se pueden obtener en Fase 1. Solo preguntar si una fuente crítica falla y no hay alternativa.
• Si DataForSEO no está disponible, omitir esas secciones del documento con nota "Datos pendientes de herramienta de backlinks".
• El documento va dirigido al cliente, no al equipo técnico. Lenguaje claro, sin jerga SEO innecesaria.
• Nunca inventar datos de tráfico, rankings o backlinks sin fuente verificada.
• Si el usuario proporciona datos GSC o de ranking, incorporarlos en la sección "Visibilidad en búsqueda".
• Formato numérico europeo en todo el documento (punto miles, coma decimales).
• Actualizar CLAUDE.md del proyecto si se identifica información nueva del cliente durante la ejecución.

---

Reglas de cálculo de horas — verificación interna

Antes de escribir el presupuesto, verificar que las horas sean coherentes con el tier:

Tier	Rango total horas típico (proyecto inicial)
A	12–30 horas
B	30–80 horas
C	80–200 horas

Si el total calculado cae fuera del rango, revisar los multiplicadores de volumen antes de ajustar la tarifa.