✈️ SEOpilot
> Una herramienta CLI ligera para detectar errores SEO en sitios web estáticos de forma automática, simple y efectiva.
---
🚀 ¿Qué es SEOpilot?
SEOpilot es un analizador SEO para sitios generados con frameworks como React, Astro, Vue, Next.js (modo export), Vite, entre otros. Escanea archivos HTML y te reporta errores comunes de SEO como:
- Múltiples etiquetas
- Falta de </code> o <code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"><meta name="description"></code><br />- Imágenes sin atributo <code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">alt</code><br />- Falta de <code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">lang</code> en la etiqueta <code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"><html></code></p><p class="my-3">Ideal para proyectos estáticos y flujos de CI/CD donde el SEO importa desde el principio.</p><p class="my-3">---</p><p class="my-3"><h2 class="text-xl font-semibold mt-5 mb-3">🧪 Características</h2></p><p class="my-3">- ✅ Fácil de usar: <code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">npx seopilot</code><br />- ✅ Soporte para <code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">--verbose</code>, <code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">--json</code>, <code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">--limit</code>, <code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">--fail-on-error</code><br />- ✅ Análisis automático de <strong>Core Web Vitals</strong> con Lighthouse (LCP, FID, CLS, TBT, FCP, score)<br />- ✅ Recomendaciones automáticas según resultados de Lighthouse<br />- ✅ Funciona en cualquier framework moderno<br />- ✅ Puede integrarse en CI (GitHub Actions, etc.)<br />- ✅ Salida clara y útil para humanos o máquinas</p><p class="my-3">---</p><p class="my-3"><h2 class="text-xl font-semibold mt-5 mb-3">🚦 Análisis Lighthouse y Core Web Vitals</h2></p><p class="my-3">SEOpilot ejecuta automáticamente <a href="https://developers.google.com/web/tools/lighthouse" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">Lighthouse</a> sobre cualquier URL pública que le pases como argumento. Obtendrás métricas de <strong>Core Web Vitals</strong> y recomendaciones automáticas para mejorar el rendimiento y la experiencia de usuario.</p><p class="my-3"><h3 class="text-lg font-medium mt-4 mb-2">$3</h3></p><p class="my-3">``<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">bash<br />npx seopilot https://www.tusitio.com<br /></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"></p><p class="my-3"><h3 class="text-lg font-medium mt-4 mb-2">$3</h3></p><p class="my-3"></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"><br />🚦 Ejecutando Lighthouse para https://www.tusitio.com...</p><p class="my-3">┌───────────────────────────────┐<br />│ Core Web Vitals: │<br />│ lcp: '2.1 s', │<br />│ fid: '30 ms', │<br />│ cls: '0.01', │<br />│ tbt: '120 ms', │<br />│ fcp: '1.1 s', │<br />│ score: 0.98 │<br />└───────────────────────────────┘</p><p class="my-3">┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓<br />┃ 🔎 Recomendaciones Lighthouse:┃<br />┃ ✅ ¡Excelente! Tus métricas ┃<br />┃ Core Web Vitals están dentro ┃<br />┃ de los valores recomendados. ┃<br />┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛<br /></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"></p><p class="my-3">Si alguna métrica está fuera de los valores recomendados, SEOpilot te dará sugerencias claras para mejorar tu sitio.</p><p class="my-3">---</p><p class="my-3">---</p><p class="my-3"><h2 class="text-xl font-semibold mt-5 mb-3">📦 Instalación</h2></p><p class="my-3"><h3 class="text-lg font-medium mt-4 mb-2">$3</h3></p><p class="my-3"></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">bash<br />npx seopilot<br /></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"></p><p class="my-3"><h3 class="text-lg font-medium mt-4 mb-2">$3</h3></p><p class="my-3"></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">bash<br />npm i -D seopilot<br /></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"></p><p class="my-3">Luego, en tu </code>package.json<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">:</p><p class="my-3"></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">json<br />"scripts": {<br /> "seo": "seopilot"<br />}<br /></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"></p><p class="my-3">---</p><p class="my-3"><h2 class="text-xl font-semibold mt-5 mb-3">📁 Estructura recomendada</h2></p><p class="my-3"></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"><br />📦 tu-proyecto/<br />├─ dist/ ← carpeta de salida (HTMLs generados)<br />├─ src/<br />├─ .github/workflows/ ← integración con CI<br />└─ ...<br /></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"></p><p class="my-3">---</p><p class="my-3"><h2 class="text-xl font-semibold mt-5 mb-3">🧰 Comandos y Flags</h2></p><p class="my-3"><h3 class="text-lg font-medium mt-4 mb-2">$3</h3></p><p class="my-3"></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">bash<br />npx seopilot<br /></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"></p><p class="my-3">---</p><p class="my-3"><h3 class="text-lg font-medium mt-4 mb-2">$3</h3></p><p class="my-3"></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">bash<br />npx seopilot --path src/testing<br /></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"></p><p class="my-3">---</p><p class="my-3"><h3 class="text-lg font-medium mt-4 mb-2">$3</h3></p><p class="my-3"></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">bash<br />npx seopilot --verbose<br /></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"></p><p class="my-3">---</p><p class="my-3"><h3 class="text-lg font-medium mt-4 mb-2">$3</h3></p><p class="my-3"></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">bash<br />npx seopilot --json<br /></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"></p><p class="my-3">---</p><p class="my-3"><h3 class="text-lg font-medium mt-4 mb-2">$3</h3></p><p class="my-3"></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">bash<br />npx seopilot --fail-on-error<br /></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"></p><p class="my-3">---</p><p class="my-3"><h3 class="text-lg font-medium mt-4 mb-2">$3</h3></p><p class="my-3"></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">bash<br />npx seopilot --limit 20<br /></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"></p><p class="my-3">---</p><p class="my-3"><h3 class="text-lg font-medium mt-4 mb-2">$3</h3></p><p class="my-3"></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">bash<br />npx seopilot --path src/testing --verbose --limit 10 --fail-on-error<br /></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"></p><p class="my-3">---</p><p class="my-3"><h2 class="text-xl font-semibold mt-5 mb-3">✅ Salida esperada</h2></p><p class="my-3"><h3 class="text-lg font-medium mt-4 mb-2">$3</h3></p><p class="my-3"></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"><br />📊 Resumen de errores:</p><p class="my-3">❌ Imagen sin alt: hero.jpg — 2 ocurrencias<br />❌ Falta <meta name="description"> — 1 ocurrencias<br /></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"></p><p class="my-3"><h3 class="text-lg font-medium mt-4 mb-2">$3</h3></p><p class="my-3"></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"><br />📄 dist/index.html<br /> ❌ Imagen sin alt: hero.jpg<br /> ❌ Falta <title><br /></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"></p><p class="my-3"><h3 class="text-lg font-medium mt-4 mb-2">$3</h3></p><p class="my-3"></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">json<br />{<br /> "totalFilesScanned": 5,<br /> "errors": [<br /> {<br /> "file": "dist/index.html",<br /> "messages": ["Falta <title>", "Imagen sin alt: hero.jpg"]<br /> }<br /> ],<br /> "summary": {<br /> "Falta <title>": 1,<br /> "Imagen sin alt: hero.jpg": 2<br /> }<br />}<br /></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"></p><p class="my-3">---</p><p class="my-3"><h2 class="text-xl font-semibold mt-5 mb-3">🤖 Integración con GitHub Actions</h2></p><p class="my-3"><h3 class="text-lg font-medium mt-4 mb-2">$3</h3></p><p class="my-3"></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">yaml<br />name: SEO Check</p><p class="my-3">on:<br /> push:<br /> branches: [main]<br /> pull_request:<br /> branches: [main]</p><p class="my-3">jobs:<br /> seo:<br /> runs-on: ubuntu-latest<br /> steps:<br /> - name: Checkout repo<br /> uses: actions/checkout@v3</p><p class="my-3"> - name: Install dependencies<br /> run: npm install</p><p class="my-3"> - name: Build project<br /> run: npm run build</p><p class="my-3"> - name: Run SEOpilot<br /> run: npx seopilot --fail-on-error<br /></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"></p><p class="my-3">---</p><p class="my-3"><h2 class="text-xl font-semibold mt-5 mb-3">🧪 Ejemplo de archivos HTML para testeo</h2></p><p class="my-3">Colocá estos archivos en una carpeta </code>src/testing/<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> y corré:</p><p class="my-3"></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">bash<br />npx seopilot --path src/testing --verbose<br /></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"></p><p class="my-3"><h3 class="text-lg font-medium mt-4 mb-2">$3</h3></p><p class="my-3"></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">html<br /><!DOCTYPE html><br /><html lang="en"><br /> <head><br /> <title>Test
Hola mundo
