SEO App

01 — Qué es

SEO App es mi herramienta para preparar y entregar estudios de posicionamiento. Le das de dos a seis keywords principales, un país y el dominio del cliente, y saca las búsquedas relacionadas con su demanda, competencia y CPC, las puntúa de 0 a 100, separa las victorias rápidas y propone un plan de acción ordenado por impacto y esfuerzo.

Un proyecto reúne varios estudios, uno por público, para una web de servicios o una tienda con varias categorías: los compara, detecta solapes y dice qué página atiende a cada uno. La auditoría de URL vale también para un sitio en desarrollo (localhost o la red local), así que el SEO se revisa mientras se construye la web, no después.

Toda la lógica es la misma en la interfaz web, en la línea de comandos, en una API REST y en un servidor MCP para agentes de IA, con una skill que enseña a Claude el método completo. Esta web se ha auditado con ella.

02 — Qué hace

• Oportunidades. Puntuación de 0 a 100 por keyword, victorias rápidas, matriz de demanda frente a competencia, temas e intención de búsqueda.
• Proyectos por públicos. Un estudio por target, prioridad de cada uno, keywords que se pisan entre targets y qué URL atiende a cada público.
• Tendencias y calendario. Google Trends por keyword: estacionalidad, perfil del año, consultas en auge que el estudio no contempla y calendario de publicación y campañas a doce meses.
• Brief de contenido. Por keyword: tipo de página, extensión, títulos, esquema de H2, keywords secundarias, preguntas, enlaces internos y datos estructurados.
• Auditoría de textos. Nota de 0 a 100 en vivo mientras se escribe, frente a la keyword y al campo semántico del estudio.
• Auditoría web. Página a página o el sitio entero por su sitemap: indexabilidad, título y meta, encabezados, datos estructurados, enlaces, robots.txt y rastreadores de IA; cada pasada se compara con la anterior.
• Mapa de keywords. Cruza las keywords con el sitemap del cliente: página propia, hueco de contenido o páginas que compiten entre sí.
• Informe para el cliente. PDF con portada, resumen, plan de acción priorizado, oportunidades, briefs y auditorías, con la marca de la agencia; también en Markdown, CSV y JSON.
• Web, CLI, API y MCP. La misma lógica desde la interfaz, la terminal (seo new, seo site, seo report…), una API REST o un agente de IA por Model Context Protocol.

03 — Instalar y usar

git clone https://github.com/DanielMartinezSebastian/SEO-APP.git
cd SEO-APP
npm install
npm start          # interfaz en http://localhost:3000

# o desde la terminal (npm link deja la orden seo disponible)
seo new "zapatillas running, zapatillas trail" --site tienda.com
seo site --site localhost:3000
seo report --format pdf --out informe.pdf
seo mcp            # servidor MCP para agentes de IA

04 — Bueno saber

• No mide posiciones en Google, enlaces entrantes ni Core Web Vitals: para eso siguen haciendo falta Search Console y PageSpeed Insights.
• Los datos de demanda, competencia y CPC vienen de una fuente no oficial; la competencia refleja sobre todo la puja entre anunciantes, no la dificultad orgánica.
• La auditoría no ejecuta JavaScript: una SPA sin renderizado en servidor sale como página vacía.
• Las capturas son de un estudio real de esta misma web, hecho mientras la desarrollaba en localhost.
• Requiere Node.js 20 o superior. Pensada para el equipo del consultor o un servidor de la agencia, con acceso por contraseña opcional.