SEO Evaluate

Usar la app en Vercel

SEO Evaluate es una plataforma minimalista para revisar si las IA pueden entender y citar una URL pública. El objetivo del MVP es resolver el flujo principal: pegar una URL, analizar señales públicas de visibilidad IA y entender qué mejorar primero.

App pública: https://seo-evaluate.vercel.app

Descripción del proyecto

La aplicación funciona como una primera capa de auditoría para dueños de negocio, marketers, agencias y equipos web que quieren mejorar su visibilidad en buscadores y asistentes de IA. Recibe una URL, descarga el HTML público y robots.txt desde una API interna, y transforma señales de rastreo, schema, SEO y citabilidad en un score entendible, prioridades ordenadas por impacto y recomendaciones concretas.

No busca reemplazar herramientas avanzadas como Screaming Frog, Ahrefs o Semrush; busca ofrecer una experiencia inicial simple para detectar problemas evidentes y explicar próximos pasos sin fricción.

Etiquetas

seo · seo-audit · ai-visibility · answer-engine-optimization · nextjs · typescript · tailwindcss · react · cheerio · url-auditor · web-audit · technical-seo

Funcionalidades

• Auditoría real desde POST /api/audit.
• Score de visibilidad IA de 0 a 100.
• Estados: Excelente, Bueno, Mejorable y Crítico.
• Validación de URL, estado de carga y errores legibles.
• Modo claro/oscuro con persistencia local.
• Reporte con prioridades, recomendaciones y señales agrupadas por acceso, comprensión y citabilidad.
• Tarjetas de checks compactas con explicación simple en modal.
• Exportación del resultado en Markdown.

Checks iniciales

El MVP evalúa señales públicas de visibilidad IA y SEO:

• HTTPS.
• OAI-SearchBot en robots.txt.
• Title y longitud recomendada.
• Meta description y longitud recomendada.
• JSON-LD y tipos schema.org.
• Entidad clara con schema, sameAs, canonical y Open Graph.
• H1 único y estructura H2/H3.
• Contenido citable con texto visible y headings de pregunta.
• Imágenes sin atributo alt.
• Canonical.
• Meta robots e indexabilidad.
• Meta viewport para mobile.
• Open Graph básico.
• Enlaces internos y externos.

Stack

• Next.js 16
• React 19
• TypeScript
• Tailwind CSS 4
• Cheerio para parseo HTML
• Lucide React para iconografía

Ejecutar en local

npm install
npm run dev

Abrir:

http://localhost:3000

Configuración SEO

La URL pública del proyecto es:

https://seo-evaluate.vercel.app

Esa URL se usa como base para canonical, sitemap, robots, Open Graph, Twitter Cards, manifest y datos estructurados JSON-LD. Para otro dominio, configurar:

NEXT_PUBLIC_SITE_URL=https://tu-dominio.com

Si no se define, la app usa https://seo-evaluate.vercel.app como valor por defecto.

Scripts

npm run dev      # servidor de desarrollo
npm run lint     # lint del proyecto
npm run build    # build de producción
npm run start    # ejecutar build de producción

API

Endpoint:

POST /api/audit

Body:

{
  "url": "https://www.wikipedia.org"
}

Respuesta resumida:

{
  "score": 76,
  "rating": "Bueno",
  "checks": [],
  "priorities": [],
  "recommendations": []
}

Limitaciones del MVP

• Analiza solo HTML público accesible desde el servidor.
• No ejecuta Lighthouse ni mide Core Web Vitals reales.
• No integra Google Search Console, PageSpeed Insights, Ahrefs ni Semrush.
• No guarda historial ni requiere login.
• Bloquea URLs locales o privadas por seguridad.

Roadmap sugerido

• Historial de auditorías.
• Reportes PDF.
• Análisis técnico avanzado.
• Integración con PageSpeed Insights.
• Proyectos por dominio.
• Login y persistencia en base de datos.

Estado

Primera versión funcional del MVP.