SuperAPI AI Directory
Partner中文AI newsFavorites
Skillsnuxt-geo-best-practices

nuxt-geo-best-practices

General & other

View repository

Updated 10-16 02:27

About this skill

Nuxt GEO Best Practices

Comprehensive Generative Engine Optimization guide for Nuxt 4 applications. Designed to maximize your brand's citation rate inside AI-generated answers from ChatGPT, Google AI Overviews / AI Mode, Perplexity, Claude, and Gemini. Contains 16 rules across 5 categories, prioritized by evidence-backed impact.

When to Apply

Reference these guidelines when:

  • Setting up llms.txt and llms-full.txt for AI agent discovery
  • Allowlisting (or blocking) AI crawlers in robots.txt (GPTBot, ClaudeBot, PerplexityBot, Google-Extended, etc.)
  • Structuring page content for retrieval-augmented generation (RAG) extractability
  • Adding entity clarity via Organization, Person, FAQPage, or HowTo JSON-LD schemas
  • Applying the GEO arxiv paper's evidence-backed levers: statistics, citations, quotations (+30-40% visibility lift)
  • Building a usePageGeo composable for per-page AI-friendly meta
  • Ensuring AI crawlers see SSR-rendered HTML (not a JavaScript shell)
  • Generating an AI-friendly XML sitemap and sitemap_index.xml

Recommended Nuxt Modules

This skill is built for Nuxt 4 apps. Several rules below show both a "from-scratch" Nitro-route implementation and the equivalent module-based shortcut. Strongly consider installing these — they remove a lot of boilerplate and stay in sync with Nuxt's official patterns:

  • @nuxtjs/seo by Harlan Wilton — meta-module that bundles @nuxtjs/sitemap, @nuxtjs/robots, nuxt-schema-org, nuxt-og-image, nuxt-link-checker, and nuxt-seo-utils. Covers most GEO infrastructure (robots.txt, sitemap, JSON-LD, meta) with one install.
  • @nuxtjs/sitemap — auto-generated sitemap with per-page lastmod, hreflang, and exclusions.
  • @nuxtjs/robots — programmatic robots.txt with per-route control and AI bot allow/disallow rules.
  • nuxt-schema-org — type-safe JSON-LD via defineOrganization, defineWebSite, defineFaqPage, defineHowTo, definePerson, defineArticle.
  • nuxt-og-image — for OG/share images (covered in the sibling nuxt-seo-best-practices skill — note CF Workers caveat there).

Official Nuxt SEO Meta docs

Nuxt 4 ships first-class SEO/meta primitives. Read these before reinventing anything:

  • Nuxt 4 SEO & Meta — useSeoMeta, useHead, useServerSeoMeta, definePageMeta, the <Head> / <Title> / <Meta> components, and route-level head config.
  • useSeoMeta — typed wrapper around useHead({ meta: [...] }) with full IntelliSense for OG/Twitter tags.
  • useHead — generic head manager (used here for JSON-LD script injection).

The usePageGeo composable in page-use-page-geo.md is a thin wrapper over these primitives; it is not a replacement for them.

Nuxt 4.5 note: head management now runs on unhead v3 — stricter useHead typing and no promise input. The useHead JSON-LD injection patterns in this skill use plain synchronous values and are v3-compatible. Also, 4.5's experimental SSR streaming is bot-aware: crawlers automatically receive fully-buffered HTML, so enabling it does not hurt GEO (see ai-ssr-for-crawlers).

Evidence Base

These rules synthesize:

  1. GEO: Generative Engine Optimization (Aggarwal et al., KDD 2024, arXiv:2311.09735) — the foundational paper that benchmarked 9 optimization methods across 10K queries. Key findings adopted here:
    • Statistics, Citations, and Quotations boost visibility by up to 40%
    • Authoritative tone and Fluency optimization show moderate gains
    • Keyword stuffing (classic SEO) FAILS on generative engines — do not bring SEO keyword density habits into GEO
  2. Industry GEO playbooks (Search Engine Land, Semrush AI Visibility Index, Backlinko) — entity clarity, multi-platform presence, sentiment, and measurement frameworks observed across 2,500+ tracked prompts on Google AI Mode and ChatGPT.
  3. Production AEO audit data (2026) — a 41-page Nuxt site audited by an automated AEO scoring engine, plus multi-sweep visibility tracking across four answer engines. Source of the factor-weight table below, the three consistently-failing factors, and the statistical guardrails in measure-aeo-visibility. Key observation: the site had complete GEO infrastructure (llms.txt, valid schema, sitemap, 90% Google index coverage) and was still cited in 0 of 10 category queries — infrastructure is necessary, not sufficient.

Rule Categories by Priority

Priority Category Impact Prefix
1 Content Extractability (the +40% levers) CRITICAL content-
2 AI Crawler & Discovery CRITICAL ai-
3 Entity Clarity HIGH entity-
4 Page-Level GEO HIGH page-
5 Measurement & Verification CRITICAL measure-

Observed audit weights (production AEO audit tool, 2026)

Where the arxiv paper gives you which levers move visibility, an automated AEO audit gives you how a scoring engine actually weights a page. These weights come from a production audit of a 41-page Nuxt site and are useful for prioritising remediation when everything is failing at once:

Factor Weight Typical score Notes
Structured Data (JSON-LD) 12% Partial entity-organization-schema
Content Depth 10% Pass content-statistics, content-self-contained-chunks
Citations & Authority Signals 8% Partial content-citations
E-E-A-T Signals 8% Fail (26) entity-author-schema — worst common failure
FAQ Content 8% Fail (31) entity-faq-howto-schema
Schema Completeness 8% Pass entity-faq-howto-schema
Content Freshness 7% Partial page-canonical-and-fresh
Entity Consistency 7% Partial title / og:title / schema name must align
Content Extractability 6% Partial content-self-contained-chunks
Definition Blocks 6% Fail (12) content-definition-blocks — lowest scoring
Named Entities 6% Pass entity-organization-schema
Snippet Eligibility 6% Pass —
AI Access Files (llms.txt) 5% Pass ai-llms-txt
Schema Validity 5% Pass —
Technical SEO 5% Pass sibling skill nuxt-seo-best-practices
AI Crawler Access 4% Partial ai-robots-allowlist

The three consistently-failing factors — E-E-A-T (8%), FAQ Content (8%), Definition Blocks (6%) — total 22% of the score and are among the cheapest to fix. Sites routinely ship perfect llms.txt, valid schema, and 90% Google index coverage while scoring 0 on all three. Start there.

Classic SEO health does not imply AEO visibility. The audited site ranked #3.9 for its own brand name with 90% index coverage, and was cited in zero of ten category queries. Brand search and category discovery are separate problems — see measure-aeo-visibility.

Quick Reference

1. Content Extractability (CRITICAL)

These are the evidence-backed +30-40% visibility levers from the GEO arxiv paper. If you only do three things, do these three.

  • content-statistics — Add quantitative statistics (the single highest-lift change measured)
  • content-citations — Add inline citations to credible sources (Sources component pattern)
  • content-quotations — Add quotations from authoritative figures
  • content-self-contained-chunks — Write paragraphs that retain meaning when extracted (RAG retrieval)
  • content-definition-blocks — "What is X" / "How to X" shapes; lowest-scoring factor in real audits (12/100)
  • content-no-keyword-stuffing — DO NOT bring SEO keyword stuffing into GEO; it actively hurts visibility

2. AI Crawler & Discovery (CRITICAL)

If AI crawlers can't access your content, none of the other rules matter.

  • ai-llms-txt — Generate llms.txt and llms-full.txt via Nitro server routes
  • ai-robots-allowlist — Explicitly allow GPTBot, ClaudeBot, PerplexityBot, Google-Extended, etc.
  • ai-ssr-for-crawlers — Ensure AI crawlers receive rendered HTML, not a JS shell
  • ai-sitemap — Generate AI-friendly XML sitemap with lastmod for fresh-content signals

3. Entity Clarity (HIGH)

Help AI systems disambiguate WHO you are, WHAT category you belong to, and WHAT you're authoritative for.

  • entity-organization-schema — Site-wide Organization JSON-LD with sameAs cross-references
  • entity-faq-howto-schema — FAQPage and HowTo schemas for the question-shaped queries LLMs love
  • entity-author-schema — Person schema with credentials and sameAs for E-E-A-T

4. Page-Level GEO (HIGH)

  • page-use-page-geo — Reusable usePageGeo composable for per-page GEO meta
  • page-canonical-and-fresh — Canonical URL + dateModified for content freshness signals

5. Measurement & Verification (CRITICAL)

Everything above is unfalsifiable without this. Generative engines are stochastic — the same query can be cited on one sweep and not the next with zero content change.

  • measure-aeo-visibility — Repeated sampling, share-of-voice, Wilson intervals, the ≥5-sweeps/month floor, and mention-vs-citation

How to Use

Read individual rule files for detailed explanations and code examples:

rules/content-statistics.md
rules/ai-llms-txt.md
rules/_sections.md

Each rule file contains:

  • Brief explanation of why it matters (with arxiv evidence where applicable)
  • Incorrect code example with explanation
  • Correct Nuxt-specific code example
  • Additional context, measurement notes, and references

Full Compiled Document

For the complete guide with all rules expanded: AGENTS.md