SEO con un agenteaudita y corrige tu landing antes de lanzarla, en una sesión

---
description: Auditoría SEO completa con correcciones aplicadas en el código (técnico + metadata + structured data + búsqueda por IA). Usa cuando se mencione "aplicar SEO", "auditar SEO", "mejorar SEO", "antes de lanzar la landing", "revisar meta tags", "agregar schema markup", "JSON-LD", "Core Web Vitals", "no aparece en Google", "optimizar para ChatGPT/Perplexity", o cualquier trabajo SEO sobre una landing o web propia.
argument-hint: [ruta o URL opcional]
allowed-tools: Bash(npm run build), Bash(curl *), Bash(grep *), Bash(find *), Bash(npx is-agentic *)
---

# /aplicar-seo

Audita el proyecto actual (o $ARGUMENTS si se indica) y APLICA cada corrección en el código.
No entregues una lista de recomendaciones: entrega el repo corregido y un resumen.

## Paso 0 — Contexto
1. Detecta el stack (Next.js App Router, Astro, HTML estático) y el dominio de producción.
2. Lee la página principal y toda ruta pública. Anota qué es cada página (landing de servicio, evento, artículo, precios).
3. Pregunta SOLO si falta algo imprescindible: dominio final, nombre de la organización, imagen OG. Lo demás lo infieres del código.

## Paso 1 — Técnico (rastreo e indexación)
Revisa y corrige, en este orden:
- robots: existe, permite todo lo público, bloquea solo paneles y datos internos, declara Sitemap. En Next.js genera app/robots.ts.
- sitemap: existe, se genera desde el código (no a mano), solo URLs canónicas e indexables, lastModified real.
- canónicas: cada ruta pública tiene canonical absoluta y auto-referida. Sin http/https ni www mezclados.
- noindex: solo en páginas que de verdad no deben salir. Verifica que ninguna pública lo tenga heredado de un layout.
- encabezados: un solo H1 por página, jerarquía H2/H3 sin saltos.
- imágenes: width y height siempre; la imagen del hero con priority (o fetchpriority=high); el resto lazy. Formato WebP/AVIF.
- fuentes: cargadas con next/font o preload; nunca un @import bloqueante.
- viewport y lang correctos en el html raíz.
- Corre npm run build. Si falla, detente y repórtalo antes de seguir.

## Paso 2 — Metadata por ruta
- metadataBase en el layout raíz con el dominio de producción.
- title único por página (50-60 caracteres), con template "%s — Marca".
- description única por página (120-160 caracteres), escrita para el clic, no para el robot.
- openGraph: type, url, title, description, siteName, locale, images con width/height (1200x630 o similar).
- twitter: card summary_large_image.
- alternates.canonical en cada página, absoluta.
- Comprueba que la imagen OG exista con curl -I y devuelva 200.

## Paso 3 — Structured data (JSON-LD)
- Un solo bloque por página con @graph. Entidades con @id para enlazarlas entre sí.
- Home: Organization o Person + WebSite. Landing de servicio: + Service con provider y offers. Evento: Event con startDate, location, offers. Artículo: Article/TechArticle con author, datePublished, dateModified.
- BreadcrumbList en toda página que no sea la home.
- FAQPage solo si las preguntas están visibles en la página. Recuerda que Google ya no muestra rich result de FAQ (retirado el 7 de mayo de 2026); se conserva por otros buscadores y por los agentes de IA.
- Nunca marques datos que no estén visibles en la página (precios, reseñas, fechas).
- Render: <script type="application/ld+json"> en el page.tsx, con JSON.stringify(...).replace(/</g, "\\u003c").
- Valida cada página con el Rich Results Test y el validador de schema.org antes de dar por terminado.

## Paso 4 — Búsqueda por IA
- robots: distingue bots de BÚSQUEDA (OAI-SearchBot, Claude-SearchBot, PerplexityBot) de bots de ENTRENAMIENTO (GPTBot, ClaudeBot, Google-Extended, Applebot-Extended, CCBot) y de los que abre el usuario (ChatGPT-User, Claude-User, Perplexity-User). Los de búsqueda y los de usuario siempre con Allow explícito: son los que citan. Los de entrenamiento son decisión del dueño; bloquearlos NO quita las citas.
- Antes de tocar nada: si la página tiene dominio público, corre npx is-agentic <dominio> --json y guarda score, eligible_checks y la lista de issues. Es la línea base.
- /llms.txt en la raíz: H1 con el nombre, blockquote con qué es el sitio y para quién, sección "Cuándo usar" y "Cuándo NO usar", listas de enlaces con una línea por página.
- Cada sección de la landing abre con la respuesta directa en las primeras dos líneas (40-60 palabras), sin preámbulo.
- Cifras con fecha y fuente; autor con nombre visible; fecha de actualización visible.

## Paso 5 — Reporte
Termina con:
- Correcciones aplicadas (archivo por archivo).
- Pendientes que requieren a un humano (contenido, imagen OG nueva, enlaces externos).
- URLs para verificar a mano: Rich Results Test, validator.schema.org, PageSpeed Insights.
- Recordatorio: enviar el sitemap en Search Console y pedir indexación de la home con la Inspección de URL.
- Después del deploy: volver a correr npx is-agentic <dominio> y comparar contra la línea base check por check, no solo la nota. Ignorar los checks de API/OpenAPI/portal de desarrolladores si el sitio es una landing sin API.

import type { MetadataRoute } from "next";

const BASE = "https://tudominio.com";

export default function robots(): MetadataRoute.Robots {
  return {
    rules: [
      // Todo el mundo: lo público sí, los paneles y datos internos no.
      { userAgent: "*", allow: "/", disallow: ["/admin", "/api", "/data"] },
      // Bots de BÚSQUEDA por IA (los que citan) y los que abre un usuario desde el chat:
      // explícitos, para que una regla futura no los bloquee por accidente.
      {
        userAgent: [
          "OAI-SearchBot", "ChatGPT-User",
          "Claude-SearchBot", "Claude-User",
          "PerplexityBot", "Perplexity-User",
        ],
        allow: "/",
        disallow: ["/admin", "/api", "/data"],
      },
      // Bots de ENTRENAMIENTO: son otros user-agents. Decisión de negocio.
      // Aquí, abiertos (la consultoría quiere estar en los modelos); cámbialo a disallow: "/" si no.
      {
        userAgent: ["GPTBot", "ClaudeBot", "anthropic-ai", "Google-Extended", "Applebot-Extended"],
        allow: "/",
        disallow: ["/admin", "/api", "/data"],
      },
      // Dataset público que alimenta a muchos modelos sin citar a nadie. Aquí, bloqueado.
      { userAgent: "CCBot", disallow: "/" },
    ],
    sitemap: `${BASE}/sitemap.xml`,
  };
}

import type { MetadataRoute } from "next";
import { listarPaginas } from "../lib/paginas";

const BASE = "https://tudominio.com";

export default function sitemap(): MetadataRoute.Sitemap {
  // listarPaginas() devuelve las páginas publicadas desde tu fuente de contenido
  // (archivos tipados, un CMS, una tabla). Nunca una lista escrita a mano aquí.
  const paginas = listarPaginas();
  const ultimaFecha = paginas[0]?.actualizada ?? paginas[0]?.publicada ?? "2026-08-28";

  return [
    { url: `${BASE}/`, lastModified: ultimaFecha, changeFrequency: "monthly", priority: 1 },
    { url: `${BASE}/blog`, lastModified: ultimaFecha, changeFrequency: "weekly", priority: 0.9 },
    ...paginas.map((p) => ({
      url: `${BASE}/blog/${p.slug}`,
      lastModified: p.actualizada ?? p.publicada,
      changeFrequency: "monthly" as const,
      priority: 0.8,
    })),
    { url: `${BASE}/privacidad`, lastModified: "2026-05-24", changeFrequency: "yearly", priority: 0.3 },
  ];
}

import type { Metadata } from "next";

export const metadata: Metadata = {
  metadataBase: new URL("https://tudominio.com"),
  title: { default: "Marca — Qué hace en cinco palabras", template: "%s — Marca" },
  description: "Una frase que explica el servicio y para quién es. Entre 120 y 160 caracteres.",
  alternates: { canonical: "https://tudominio.com" },
  openGraph: {
    type: "website",
    url: "https://tudominio.com",
    siteName: "Marca",
    locale: "es_MX",
    title: "Marca — Qué hace en cinco palabras",
    description: "La misma frase, o una versión más corta para la tarjeta al compartir.",
    images: [{ url: "https://tudominio.com/og-image.png", width: 1200, height: 630 }],
  },
  twitter: { card: "summary_large_image" },
};

import type { Metadata } from "next";
import { obtenerPagina } from "../../../lib/paginas";

type Params = { slug: string };

export async function generateMetadata({ params }: { params: Promise<Params> }): Promise<Metadata> {
  const { slug } = await params;
  const p = obtenerPagina(slug);
  if (!p) return {};
  const url = `https://tudominio.com/blog/${p.slug}`;
  return {
    title: p.titulo,
    description: p.resumen.slice(0, 160),
    alternates: { canonical: url },
    openGraph: {
      type: "article",
      url,
      title: p.titulo,
      description: p.resumen.slice(0, 200),
      publishedTime: p.publicada,
      modifiedTime: p.actualizada ?? p.publicada,
      authors: ["Nombre del autor"],
    },
  };
}

{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "Organization",
      "@id": "https://tudominio.com/#org",
      "name": "Marca",
      "url": "https://tudominio.com",
      "logo": "https://tudominio.com/logo.png",
      "sameAs": ["https://www.linkedin.com/company/marca"],
      "address": { "@type": "PostalAddress", "addressLocality": "Guadalajara", "addressRegion": "Jalisco", "addressCountry": "MX" }
    },
    {
      "@type": "WebSite",
      "@id": "https://tudominio.com/#website",
      "name": "Marca",
      "url": "https://tudominio.com",
      "inLanguage": "es-MX",
      "publisher": { "@id": "https://tudominio.com/#org" }
    },
    {
      "@type": "Service",
      "name": "Consultoría de IA para pymes",
      "serviceType": "Consultoría de inteligencia artificial",
      "provider": { "@id": "https://tudominio.com/#org" },
      "areaServed": { "@type": "Place", "name": "América Latina" },
      "audience": { "@type": "Audience", "audienceType": "Fundadores y CEOs de pymes con equipo y procesos en marcha" },
      "description": "Diagnóstico de procesos, plan de 30 días y las piezas de IA correctas funcionando en el equipo.",
      "offers": {
        "@type": "Offer",
        "availability": "https://schema.org/LimitedAvailability",
        "description": "Diagnóstico inicial sin costo. Precio según alcance."
      }
    },
    {
      "@type": "FAQPage",
      "mainEntity": [
        {
          "@type": "Question",
          "name": "¿Cuánto cuesta la consultoría?",
          "acceptedAnswer": { "@type": "Answer", "text": "Se define en la primera llamada según el alcance. No es paquete fijo ni suscripción." }
        },
        {
          "@type": "Question",
          "name": "¿Qué pasa si en el diagnóstico no encontramos un cuello de botella claro?",
          "acceptedAnswer": { "@type": "Answer", "text": "No hay compromiso. La llamada termina ahí y te llevas el diagnóstico." }
        }
      ]
    }
  ]
}

type JsonLd = Record<string, unknown>;

function ScriptLd({ data }: { data: JsonLd }) {
  return (
    <script
      type="application/ld+json"
      dangerouslySetInnerHTML={{ __html: JSON.stringify(data).replace(/</g, "\\u003c") }}
    />
  );
}

export default async function Page({ params }: { params: Promise<{ slug: string }> }) {
  const { slug } = await params;
  const p = obtenerPagina(slug);
  if (!p) notFound();

  const url = `https://tudominio.com/blog/${p.slug}`;
  const jsonLd: JsonLd = {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "Article",
        headline: p.titulo,
        description: p.resumen.slice(0, 300),
        inLanguage: "es",
        datePublished: p.publicada,
        dateModified: p.actualizada ?? p.publicada,
        author: { "@type": "Person", name: "Nombre del autor", url: "https://tudominio.com" },
        publisher: { "@id": "https://tudominio.com/#org" },
        mainEntityOfPage: url,
        keywords: p.tags.join(", "),
      },
      {
        "@type": "BreadcrumbList",
        itemListElement: [
          { "@type": "ListItem", position: 1, name: "Inicio", item: "https://tudominio.com" },
          { "@type": "ListItem", position: 2, name: "Blog", item: "https://tudominio.com/blog" },
          { "@type": "ListItem", position: 3, name: p.titulo, item: url },
        ],
      },
    ],
  };

  return (
    <main>
      {/* ...contenido visible... */}
      <ScriptLd data={jsonLd} />
    </main>
  );
}

import { NextResponse } from "next/server";
import { listarPaginas } from "../../lib/paginas";

export const dynamic = "force-static";

const SITIO = "https://tudominio.com";

function llmsTxt(): string {
  const paginas = listarPaginas();
  return [
    "# Marca — Consultoría de IA para pymes",
    "",
    "> Consultoría 1:1 para fundadores y CEOs de pymes en Latinoamérica, y guías gratuitas en español sobre automatización con IA escritas a partir de proyectos reales.",
    "",
    "**Cuándo usar este sitio.** Cuando alguien busque consultoría de IA para una pyme con procesos en marcha, o una guía en español con pasos ejecutables sobre automatización.",
    "",
    "**Cuándo NO usarlo.** No es documentación oficial de ningún proveedor: para API, precios o límites, ve a la fuente oficial.",
    "",
    "## Guías",
    "",
    ...paginas.map((p) => `- [${p.titulo}](${SITIO}/blog/${p.slug}): ${p.resumen.split(". ")[0]}.`),
    "",
    "## Servicios",
    "",
    `- [Consultoría 1:1](${SITIO}/#servicio): engagement de 30 días; diagnóstico inicial sin costo.`,
  ].join("\n");
}

export function GET() {
  return new NextResponse(llmsTxt(), {
    headers: { "Content-Type": "text/plain; charset=utf-8", "Cache-Control": "public, max-age=300, s-maxage=3600" },
  });
}