SEO en página

¿Qué hace SEO en página?

Requiere: Python 3.10+. page_audit.py necesita acceso de red a la página en vivo; text_stats.py es offline y lee un archivo.

Esto es lo que cambiaría primero: el título, luego la descripción, luego el H1. Son baratos, es lo que la gente lee en los resultados y es fácil equivocarse de maneras que un script puede detectar.

Entradas

• La URL de la página, y una consulta principal más hasta dos secundarias. Si el usuario no tiene ninguna, toma las frases principales de text_stats.py, propón una y pídele que la confirme.
• El texto actual, para que el nuevo texto mantenga la voz de la página.

Ejecución de los scripts

Escribe cada script (shared/scripts/page_audit.py, shared/scripts/text_stats.py) sin cambios en un archivo temporal, ejecútalo y luego elimínalo. page_audit.py usa la red solo para leer la página que nombras y no lee archivos locales. text_stats.py no hace llamadas de red; lee un archivo de texto o stdin.

A="$(mktemp "${TMPDIR:-/tmp}/page_audit.XXXXXX")"   # pega shared/scripts/page_audit.py dentro, sin cambios
T="$(mktemp "${TMPDIR:-/tmp}/text_stats.XXXXXX")"   # pega shared/scripts/text_stats.py dentro, sin cambios
python3 "$A" https://example.com/page --json                # evidencia: snippet, contenido, enlaces-imágenes, aspectos básicos
python3 "$T" copy.md --keyword "frase principal" --top 15  # voz, legibilidad, colocación de palabras clave
rm -f "$A" "$T"

Los códigos de salida 0 y 1 siguen la auditoría (1 significa una brecha alta o crítica). El código 2 significa entrada incorrecta. text_stats.py sale con 2 por archivo faltante, entrada vacía o binaria, o una opción fuera de rango.

Pasos

1. Ejecuta la auditoría. Cita la evidencia de snippet, content y basics: longitudes de título y descripción, conteo de H1, palabras.
2. Mide el texto existente con text_stats.py. Anota la facilidad de lectura, palabras por oración y los conteos de tú frente a nosotros. Igualalos.
3. Escribe el título: de 30 a 60 caracteres, la frase principal cerca del inicio, una razón para hacer clic, la marca al final. Único en el sitio.
4. Escribe la descripción: de 70 a 160 caracteres, la respuesta o promesa, un punto de prueba, sin comillas. Consulta patrones.
5. Escribe un H1 que exprese el tema en las palabras del visitante. Construye los H2 como las preguntas que responde la página, en orden, sin saltar nunca un nivel.
6. Añade o corrige las etiquetas de compartir (og:title, og:description, og:image, twitter:card) y lang y viewport si faltan.
7. Verifica la colocación con --keyword: la frase debe aparecer en el título, en el H1 y en las primeras 100 palabras, y leerse de forma natural.
8. Vuelve a ejecutar ambos scripts. Compara las partes perdidas antes y después.

Resultado

Una tabla de antes y después para título, descripción, esquema de H1 y H2 con conteos de caracteres; el marcado exacto del <head> para pegar; cualquier edición del cuerpo como oraciones de reemplazo; las lecturas de text_stats.py antes y después; las partes de la auditoría recuperadas.

Criterios de salida

• Título de 30 a 60 caracteres; descripción de 70 a 160; exactamente un H1; dos o más H2; ningún nivel de encabezado saltado.
• --keyword informa la frase principal en un encabezado y en las primeras 100 palabras.
• Ninguna frase se repite hasta que suene mal. Regla general: más de 3 usos por cada 100 palabras es relleno.
• La facilidad de lectura no empeoró respecto al original a menos que el usuario pidiera un registro diferente.
• Una reauditoría muestra que las partes snippet y content se recuperaron, sin regresiones en otros lugares.

Casos límite y errores

• La página es de precios, contacto o inicio de sesión: 300 palabras pueden no aplicarse. Di que la parte del conteo de palabras es una regla general y déjala.
• El título ya posiciona y el usuario está nervioso: cambia un elemento a la vez y anota la fecha.
• Dos páginas compiten por la misma frase: detente y usa keyword-clusters. No reescribas ambas.
• Página no en inglés: las listas de preguntas y verbos de los scripts están en inglés. Informa esas partes como no aplicables.
• Los motores de búsqueda reescriben títulos y fragments. Di que los nuevos son una propuesta que el motor puede anular.

Reglas

• Iguala la voz de la página. Si dice "tú", tú dices "tú".
• No inventes hechos, precios ni pruebas para una descripción. Usa solo lo que está en la página o lo que el usuario proporcionó.
• Los conteos de palabras clave detectan relleno; no son un objetivo. Nunca alcances una densidad.
• Nunca prometas un ranking. Di lo que cambiaste y qué debería aclarar.