Fully equipped Technical SEO & AEO for busy Nuxters.
Nuxt SEO is an ecosystem of SEO modules, tools, and tutorials built with and for the Nuxt community. Search has changed: Google still matters, but ChatGPT, Claude, Perplexity, and AI Overviews now answer questions your site could answer, and they only cite sources they can parse. Nuxt SEO ships the full stack, robots.txt, sitemaps, Schema.org, OG images, meta tags, link checks, to make your Nuxt app discoverable by both search engines and answer engines.
|
Made possible by my Sponsor Program 💖 Follow me @harlan_zw 🐦 • Join Discord for help |
- 🤖 Crawl Control: Automatic
robots.txtgeneration,<meta name="robots">tags, andX-Robots-Tagheaders to manage how search engines and AI crawlers access your site. - 📄 Sitemaps: Auto-generated
sitemap.xmlfrom your app's data sources, with multi-sitemap support for i18n sites. - 🔎 Structured Data: Schema.org JSON-LD generated automatically, the single biggest lever for rich results, AI Overviews, and entity recognition.
- 🖼️ OG Images: Dynamic Open Graph image generation for every page, no manual design work needed.
- △ SEO Utils: Clean titles, default meta, canonical URLs, breadcrumbs, favicons, and social share links, AEO fundamentals AI parsers rely on.
- ✅ Link Checking: Broken link detection at build time with ESLint integration and DevTools support.
Traditional SEO signals (clean HTML, structured data, crawlable sitemaps, valid meta) are the same signals AI crawlers use to decide what to cite. Nuxt SEO also includes nuxt-ai-ready for llms.txt and on-demand Markdown endpoints. MCP tools require a separate opt-in.
npx nuxt module add seo
# then verify:
npx @vercel/agent-readability audit https://your-site.comThe @nuxtjs/seo package is a simple alias for installing all of the modules in one go.
// This is almost all it does. Setup also fails the build on an unsupported
// Nuxt version, or when a loaded module is older than its version below.
export default defineNuxtModule<ModuleOptions>({
moduleDependencies: {
'@nuxtjs/robots': { version: '>=6.0' },
'@nuxtjs/sitemap': { version: '>=8.3' },
'nuxt-link-checker': { version: '>=4.3' },
'nuxt-og-image': { version: '>=6.4.4' },
'nuxt-schema-org': { version: '>=5.0' },
'nuxt-seo-utils': { version: '>=7.0' },
'nuxt-site-config': { version: '>=4.0' },
'nuxt-skew-protection': {
version: '>=1.6.1',
defaults: { updateStrategy: 'polling', cookie: false },
},
'nuxt-ai-ready': {
version: '>=2.5.2',
defaults: { agentSkills: false, apiCatalog: false },
},
'@nuxtjs/i18n': { version: '>=10.0', optional: true },
},
})Every module works standalone. Install @nuxtjs/seo to get everything at once, or pick only what you need. The bundle defaults to polling, disables version cookies, and keeps agent skills and API catalogs opt-in. Your module configuration takes precedence.
| Module | Package | What it solves |
|---|---|---|
| Robots | @nuxtjs/robots | Control which crawlers (Googlebot, GPTBot, ClaudeBot, PerplexityBot…) can access which pages |
| Sitemap | @nuxtjs/sitemap | Give every crawler, search and answer engine, a full index of your content |
| Schema.org | nuxt-schema-org | The structured data AI engines rely on to understand entities, authors, products, FAQs |
| OG Image | nuxt-og-image | Preview images for social shares and chat-bot rich cards |
| SEO Utils | nuxt-seo-utils | Favicons, canonicals, breadcrumbs, default meta, the AEO fundamentals |
| Link Checker | nuxt-link-checker | Broken links harm SEO, confuse AI crawlers, and hurt UX |
| Site Config | nuxt-site-config | Unified site URL, name, and locale config shared across every module |
| AI Ready | nuxt-ai-ready | llms.txt and on-demand .md route variants |
| Skew Protection | nuxt-skew-protection | Persistent assets and instant updates across deployments |
Note
Site Config installs automatically with any SEO module. It provides a unified configuration layer that works across all modules at both build time and runtime.
Install everything at once:
npx nuxt module add seoOr pick only what you need:
npx nuxt module add sitemap robotsNuxt SEO v6 requires Nuxt 4.1 or later. See the v5 migration steps.
Tip
Using an AI agent? Get the @nuxtjs/seo Skill on skilld.dev/gh/harlan-zw/nuxt-seo/nuxtjs-seo.
Once installed, check the Using the Modules guide to get started.
Modules handle the technical foundation. Validating your live site is equally important:
Learn more about SEO and AEO:
Read the full documentation for configuration options, guides, and examples.
Licensed under the MIT license.