← Todos los recursos Skill

Cómo mejorar el SEO de tu página web paso a paso

Busqué en Google el servicio que vendo, en mi ciudad, y no aparecía. El método completo que usé para arreglarlo, paso a paso y con los scripts.

Cómo mejorar el SEO de tu página web paso a paso

Gratis, a cambio de saber quién eres

Descárgalo gratis

Te lo doy completo y sin costo. Solo te pido el correo para poder escribirte después y preguntarte cómo te fue: si algo no te sirvió, quiero saberlo. Nada de spam.

Un correo de confirmación y ya. Puedes salirte cuando quieras.

Lo que vas a lograr

Una auditoría le puso 75 sobre 100 a mi propio sitio. Peor: busqué en Google el servicio exacto que vendo, en mi propia ciudad, y no aparecía. Ni en la primera página ni en la tercera.

Arreglé cada cosa, anoté lo que funcionó y lo que me costó tiempo, y lo empaqueté en este skill. Estos son los números finales, medidos en producción sobre este mismo sitio que estás leyendo:

  • PageSpeed escritorio: 92 → 100. Móvil: 77 → 88.
  • Salto de contenido (CLS): 0.137 → 0. Cero exacto, no redondeado.
  • Fuentes: 273 KB → 123 KB. Un 55% menos.
  • Carga completa: 1.166 ms → 734 ms.
  • 102 de 102 URLs con título y descripción dentro de norma.

Puedes abrir PageSpeed Insights, poner chiragx.com y comprobarlo ahora mismo. No te pido que me creas.

Antes de empezar: instala el skill

Es un skill de Claude Code. Descomprime la carpeta dentro de tus skills:

~/.claude/skills/web-playbook-100/

En Windows es C:\Users\TU-USUARIO\.claude\skills\. Se activa solo cuando le pidas auditar o mejorar el SEO de un sitio.

¿No usas Claude Code? Igual te sirve. Todo es Markdown y los scripts corren solos desde la terminal. Abre SKILL.md y léelo como el manual que es.

Paso 1. Mide de verdad, no como te gustaría

Casi todo el mundo se salta este paso y por eso arregla lo que no era. Antes de tocar una línea:

  1. Abre tu sitio en el celular con datos, no con wifi. El wifi de tu oficina te miente. Tus clientes te visitan en la calle.
  2. Corre PageSpeed en móvil tres veces y toma el valor del medio. Una sola medición no dice nada; varía demasiado. Escritorio casi siempre se ve bien y casi nunca es donde te visitan.
  3. Busca en Google tu servicio + tu ciudad, en incógnito. Si no apareces, ese es tu problema real, no el score.
  4. Cuenta tus servicios y cuenta tus páginas. Si ofreces cinco cosas y tienes una sola página, ahí está tu techo. Guarda ese número.

Apunta los cuatro resultados en un archivo. Al final vas a volver a medir con lo mismo, y ahí es donde ves si sirvió.

El script scripts/audit.sh del skill hace la parte técnica de esto por ti: revisa códigos de respuesta, redirecciones, canonicals, hreflang y metadatos de todas tus URLs de un tirón.

Paso 2. Una página por servicio, no una lista en el home

Este fue el cambio que más movió la aguja, y no tiene nada de técnico.

Si vendes cinco servicios y los tienes como cinco párrafos dentro del home, Google tiene una página para posicionar en cinco búsquedas distintas. Va a perder las cinco. Cada servicio necesita su propia URL, con su propio título, su propia descripción y su propio contenido de verdad.

En mi caso pasé de un home con una sección de servicios a doce páginas (seis servicios en dos idiomas), cada una con:

  • Un título que usa las palabras que la gente escribe, no las que usamos en la industria.
  • Un problema concreto arriba, antes de hablar de mí.
  • Preguntas frecuentes reales, las que me hacen en las llamadas.
  • Datos estructurados de tipo Service y FAQPage.
  • Enlaces cruzados entre servicios relacionados, y de vuelta al índice.

El skill trae esto en references/arquitectura.md, con el criterio para decidir qué merece página propia y qué no. Regla corta: si alguien podría buscarlo por su nombre, merece página.

Paso 3. SEO técnico: que Google pueda leerte sin adivinar

Aquí es donde la mayoría de los sitios pierden puntos por cosas invisibles. El orden que funciona:

  1. Datos estructurados. Marca quién eres (Person u Organization), qué vendes (Service), tus preguntas (FAQPage) y la ruta de navegación (BreadcrumbList). Valida cada página en la prueba de resultados enriquecidos.
  2. Canonical en todas las páginas. Una sola versión oficial de cada URL.
  3. Hreflang si tienes más de un idioma. Recíproco: si la española apunta a la inglesa, la inglesa tiene que apuntar de vuelta. Si falla una, fallan las dos.
  4. Sitemap generado solo, con lastmod real. Un sitemap escrito a mano se queda viejo en dos semanas.
  5. Títulos y descripciones dentro de norma. Título hasta 60 caracteres, descripción hasta 158. Si se pasan, Google los corta y pierdes el mensaje.

Cuando esto esté listo, verifica el sitio en Google Search Console, sube el sitemap y pide la indexación de las páginas nuevas. También date de alta en Bing Webmaster Tools: es media hora y es de donde sale buena parte de lo que responden los buscadores con IA.

Search Console tiene su curva y hay decisiones que dependen de cómo esté armado tu sitio. Lo dejo mencionado como paso porque explicarlo bien es una conversación, no un párrafo. Escríbeme y lo vemos con tu caso en la mano.

Paso 4. Rendimiento: lo que de verdad mueve el número

Esta es la parte con más mito por metro cuadrado. Lo que sí funcionó, en orden de impacto:

Fuentes

Google Fonts te cuesta una conexión a otro dominio antes de poder pintar una letra. Bájalas y sírvelas tú. Dos avisos que me costaron tiempo:

  • Google sirve un solo archivo variable por familia. Si bajas "regular", "medium" y "bold" por separado, estás bajando el mismo archivo tres veces. Deduplica por hash y declara rangos de peso.
  • Usa font-display: optional en la fuente del cuerpo. Con swap el texto se repinta y ahí nace buena parte de tu salto de contenido.

scripts/selfhost-fonts.js hace la bajada y la deduplicación solo.

Imágenes

  • Convierte a AVIF y sirve con <picture>, dejando el original como respaldo. Mi home pasó de 1.013 KB a 533 KB sin que se note diferencia a la vista.
  • Declara ancho y alto en todas las imágenes. Sin eso, el navegador no sabe cuánto espacio reservar y el contenido salta.
  • Si tienes una regla global img{max-width:100%}, tiene que llevar height:auto. Sin eso las imágenes se aplastan. Este error estuvo semanas en mi sitio y lo vine a ver en una grabación de pantalla.

Salto de contenido

Llegar a cero es cuestión de reservar espacio: dimensiones en imágenes, alturas en lo que carga después, y nada que se mueva cuando entra la fuente. El script scripts/browser-audit.js te mide el salto, el elemento más grande y el contraste real en un navegador de verdad, que es distinto de lo que reporta un laboratorio.

Paso 5. Entidad: que Google sepa que existes como persona o empresa

Esto es lo que casi nadie hace y es lo que separa "una web más" de "el referente del tema en tu país".

Google no solo indexa páginas, mantiene un grafo de entidades: personas, empresas, lugares y cómo se relacionan. Si tú no eres una entidad para Google, compites solo por palabras. Si lo eres, compites por ser quien eres.

Los pasos, en orden:

  1. Marca Person u Organization en tu sitio con un @id estable, y referencia ese mismo @id desde todas las páginas.
  2. Enlaza con sameAs a tus perfiles reales: LinkedIn, GitHub, YouTube, X, tu ficha de empresa.
  3. Que todos esos perfiles digan lo mismo. Misma descripción, mismo nombre, mismo enlace. Si tu LinkedIn dice una cosa y tu web otra, estás mandando señales que se contradicen.
  4. Si tienes cobertura de prensa, charlas, o entidades ya existentes que te mencionen, crea tu ficha en Wikidata y conéctala a tus empresas.

Lo de Wikidata tiene reglas de notabilidad y se puede borrar si lo haces mal, así que no lo tomes a la ligera. Está en references/entidad.md con el detalle, pero si vas a hacerlo para tu negocio, háblame antes y te digo si calificas y cómo plantearlo.

Paso 6. Contenido y medición: que esto no se muera en un mes

Un sitio en 100 que no publica nada vuelve a bajar. Necesitas dos cosas.

Un lugar donde publicar sin tocar código. Yo monté un CMS propio sobre Cloudflare porque quería controlar el HTML que sale, pero cualquier cosa sirve mientras publiques de verdad. Lo importante es que subir un artículo te tome quince minutos, no una tarde: si te cuesta, no lo vas a hacer. El montaje está en references/stack.md y references/cms-y-contenido.md.

Saber de dónde viene la gente. Mide el primer contacto, no el último: si alguien te encontró por Google en marzo y te escribió por WhatsApp en mayo, eso fue Google, no WhatsApp. Guarda el origen en el navegador la primera vez y mándalo con el formulario. Sin esto vas a estar adivinando qué canal te trae clientes.

Los errores que te van a costar tiempo

El skill trae dieciocho errores documentados en references/errores.md, cada uno con lo que costó. Estos cuatro son los que más veo:

  • Optimizar escritorio y celebrar. Escritorio siempre se ve bien. Tu tráfico es móvil.
  • Perseguir el score en vez del negocio. Un 100 que no aparece cuando buscan tu servicio no vale nada. Mide las dos cosas.
  • Confiar en el laboratorio. Las herramientas simulan. Abre un navegador real y mide ahí antes de dar algo por bueno.
  • Cambiar diez cosas a la vez. Si mejora, no sabes cuál fue. Si empeora, tampoco. Un cambio, una medición.
Flyer de auditoría SEO: tu sitio reprobado, ¿lo revisamos?
Flyer de auditoría SEO: tu sitio reprobado, ¿lo revisamos?

Cómo sabes que llegaste

Vuelve a los cuatro números del paso 1 y compáralos. Llegaste cuando:

  • Móvil pasa de 85 medido tres veces.
  • El salto de contenido está en cero.
  • Apareces al buscar tu servicio más tu ciudad, en incógnito.
  • Cada servicio que vendes tiene su propia URL indexada.

Si tres de cuatro te salen y uno no, ese uno normalmente es el paso 5. Es el más lento y el que más rinde.

Gratis, a cambio de saber quién eres

Descárgalo gratis

Te lo doy completo y sin costo. Solo te pido el correo para poder escribirte después y preguntarte cómo te fue: si algo no te sirvió, quiero saberlo. Nada de spam.

Un correo de confirmación y ya. Puedes salirte cuando quieras.

¿Te trabaste en algún paso?

Escríbeme y lo vemos

El recurso te lleva de cero a cien solo, pero hay pasos que se explican mejor hablando. Si llegaste hasta ahí y algo no cuadra, mándame el enlace de tu sitio y te digo qué está pasando.

Agendar una llamada →

SEO técnico · Rendimiento web · Core Web Vitals · Entidad