// middleware/botRouter.ts
import { NextRequest, NextResponse } from 'next/server';

const QUERY_BOTS = [
  'OAI-SearchBot',
  'ChatGPT-User',
  'ClaudeBot',
  'Claude-Web',
  'PerplexityBot',
  'Perplexity-User'
];

const TRAINING_BOTS = ['GPTBot', 'Google-Extended'];

export function botRouter(request: NextRequest) {
  const userAgent = request.headers.get('user-agent')?.toLowerCase() || '';
  const isQueryBot = QUERY_BOTS.some(bot => userAgent.includes(bot.toLowerCase()));
  const isTrainingBot = TRAINING_BOTS.some(bot => userAgent.includes(bot.toLowerCase()));

  // Log bot activity for traffic attribution
  if (isQueryBot || isTrainingBot) {
    console.log(`[BotAccess] ${userAgent} -> ${request.nextUrl.pathname}`);
  }

  // Apply robots.txt compliance at the edge
  if (isTrainingBot && process.env.BLOCK_TRAINING_BOTS === 'true') {
    return new NextResponse('Forbidden', { status: 403 });
  }

  // Allow query-time bots unrestricted access
  if (isQueryBot) {
    const response = NextResponse.next();
    response.headers.set('X-Robots-Tag', 'index, follow');
    return response;
  }

  return NextResponse.next();
}

, allowing teams to adjust permissions without redeploying content.

Step 2: Enforce Extraction-Optimized Content Boundaries

LLMs extract answers most reliably when content adheres to strict semantic boundaries. A single page should address one primary question. The opening 100 words must contain the direct answer. Subsequent sections should expand with context, examples, or implementation details. This pattern aligns with the 50–300 word extraction window used by most answer engines.

// utils/contentChunker.ts
interface ContentBlock {
  heading: string;
  summary: string; // First 100 words
  body: string;
  metadata: {
    version: string;
    lastUpdated: string;
    sources: string[];
  };
}

export function validateExtractionReadiness(block: ContentBlock): boolean {
  const wordCount = block.summary.split(/\s+/).length;
  const hasVerifiableData = /\b\d{4}\b|\b\d+\s*(?:%|users|ms|GB)\b/.test(block.summary);
  const hasPrimarySources = block.metadata.sources.length >= 2;

  return wordCount <= 100 && wordCount >= 40 && hasVerifiableData && hasPrimarySources;
}

Architecture Rationale: Programmatic validation ensures content meets extraction thresholds before publishing. The validateExtractionReadiness function enforces length constraints, requires verifiable metrics (dates, percentages, version numbers), and mandates primary source citations. This prevents generic prose from entering the index and increases citation confidence scores assigned by retrieval models.

Step 3: Inject Dynamic FAQ Schema for Machine Parsing

While traditional search engines have deprioritized FAQ rich results, AI engines heavily weight FAQPage structured data. It explicitly maps questions to answers, reducing extraction ambiguity. Schema should be generated dynamically from content blocks rather than hardcoded, ensuring consistency between rendered HTML and machine-readable markup.

// components/FAQSchema.tsx
import { FAQPage } from 'schema-dts';

interface FAQItem {
  question: string;
  answer: string;
}

export function generateFAQSchema(items: FAQItem[]): FAQPage {
  return {
    '@context': 'https://schema.org',
    '@type': 'FAQPage',
    mainEntity: items.map(item => ({
      '@type': 'Question',
      name: item.question,
      acceptedAnswer: {
        '@type': 'Answer',
        text: item.answer
      }
    }))
  };
}

Architecture Rationale: Dynamic schema generation eliminates manual JSON-LD maintenance. By deriving structured data directly from content blocks, you guarantee alignment between human-readable headings and machine-parsed Q&A pairs. This reduces extraction errors and increases the likelihood of direct citation attribution.

Pitfall Guide

1. Query-Time Bot Blocking

Explanation: Blocking OAI-SearchBot, ClaudeBot, or PerplexityBot under the assumption that it forces click-through traffic. In reality, these bots are required for real-time retrieval. If blocked, your domain is excluded from the candidate pool during answer synthesis. Fix: Explicitly allow all query-time bots in robots.txt and middleware. Reserve blocking for training bots only if data privacy or licensing requires it.

2. Schema Inflation

Explanation: Adding 15+ FAQ entries to a single page to maximize structured data coverage. This increases payload size, degrades Core Web Vitals, and dilutes semantic relevance. AI engines ignore low-signal schema and may deprioritize the page. Fix: Limit FAQ schema to 5–7 highly specific questions per page. Validate schema relevance against actual user queries using search console data.

3. Temporal Keyword Spam

Explanation: Injecting "2026" or "latest" into every paragraph to signal freshness. AI engines rely on lastmod metadata and sitemap timestamps, not prose keywords. Artificial dating reduces readability and provides no retrieval advantage. Fix: Maintain accurate lastmod fields in sitemaps. Keep prose natural. Update content substantively rather than cosmetically.

4. AI-Native Prose Generation

Explanation: Writing content that mimics chatbot responses (e.g., "AI answer: what is the best CRM?"). This reduces human engagement metrics and signals low originality to retrieval models. AI engines prefer content written for humans but structured for machines. Fix: Draft content for human comprehension first. Apply structural constraints (H2 questions, tight summaries, source citations) during the editing phase.

5. Ignoring Traditional Search Rank

Explanation: Assuming AEO replaces traditional SEO. AI engines pull from Bing, Anthropic's retrieval provider, and Perplexity's index. If your page does not rank in conventional search, it will not appear in the initial retrieval set. Fix: Maintain core SEO hygiene: canonical tags, mobile responsiveness, backlink acquisition, and keyword targeting. Treat AEO as a complementary extraction layer, not a replacement.

6. Unstructured Long-Form Walls

Explanation: Publishing 600+ word essays without semantic breaks. LLMs struggle to extract coherent answers from continuous prose. Extraction models prefer discrete chunks with clear boundaries. Fix: Enforce 50–300 word extraction windows. Use H2/H3 headings to segment topics. Place direct answers immediately after headings.

7. Missing Primary Source Citations

Explanation: Writing content without linking to official documentation, research papers, or original reporting. AI engines assign higher citation confidence to pages that demonstrate verifiable sourcing. Fix: Include 2–3 primary source links per major claim. Use descriptive anchor text. Avoid affiliate or low-authority outbound links.

Production Bundle

Action Checklist

• Audit robots.txt and middleware: Verify query-time bots are allowed and training bots are configured per policy.
• Restructure top 5 traffic pages: Apply one-question-per-section format with direct answers in the first 100 words.
• Inject dynamic FAQ schema: Generate JSON-LD from content blocks, limiting to 5–7 high-signal Q&As per page.
• Validate extraction boundaries: Run content through chunk validation to ensure 50–300 word segments and verifiable data points.
• Sync traditional SEO signals: Update sitemaps with accurate lastmod dates, verify canonical tags, and maintain backlink velocity.
• Implement bot traffic logging: Parse User-Agent headers in CDN or edge logs to track AI referral attribution.
• Monitor citation appearance: Use AI search consoles and referral analytics to measure citation frequency and adjust content accordingly.

Decision Matrix

Scenario	Recommended Approach	Why	Cost Impact
Technical documentation sites	Strict chunking + FAQ schema + primary source citations	Developers and AI engines both require precise, versioned answers with verifiable references	Low (automated schema generation, minimal content rewrite)
Consumer comparison guides	H2 question formatting + extraction tables + traditional SEO sync	Comparison data thrives in structured tables; AI engines extract feature matrices efficiently	Medium (table restructuring, schema validation pipeline)
News/opinion publications	Allow query bots + block training bots + focus on definitional content	Opinion pieces lack extraction boundaries; definitional content captures AI citation traffic	Low-Medium (bot routing only, content strategy shift)
E-commerce product pages	Product schema + specification tables + bot access	AI engines extract pricing, specs, and availability from structured data; traditional SEO drives volume	Medium (schema implementation, data feed synchronization)

Configuration Template

# robots.txt (Production-Ready)
User-agent: OAI-SearchBot
Allow: /

User-agent: ChatGPT-User
Allow: /

User-agent: ClaudeBot
Allow: /

User-agent: Claude-Web
Allow: /

User-agent: PerplexityBot
Allow: /

User-agent: Perplexity-User
Allow: /

# Optional: Block training bots if licensing requires
# User-agent: GPTBot
# Disallow: /

# User-agent: Google-Extended
# Disallow: /

Sitemap: https://yourdomain.com/sitemap.xml

// schema/faq-template.json
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "What is the recommended extraction window for AI answer engines?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "AI engines extract answers most reliably in 50–300 word segments. Place direct answers immediately after H2 headings and limit supporting context to discrete paragraphs."
      }
    },
    {
      "@type": "Question",
      "name": "Which bots must be allowed for AI citation eligibility?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Query-time bots including OAI-SearchBot, ChatGPT-User, ClaudeBot, Claude-Web, PerplexityBot, and Perplexity-User must be permitted. Blocking these removes your domain from the retrieval candidate pool."
      }
    }
  ]
}

Quick Start Guide

1. Verify bot access: Run curl -A "OAI-SearchBot" https://yourdomain.com/robots.txt and confirm Allow: / is returned for all query-time bots.
2. Restructure one page: Pick a high-traffic article. Convert the main heading to a question. Place a 2–4 sentence direct answer in the first 100 words. Add 3 primary source links.
3. Inject schema: Generate a FAQPage JSON-LD block with 5 relevant Q&As. Validate using Google's Structured Data Testing Tool or a local JSON-LD linter.
4. Deploy and monitor: Push changes to production. Monitor CDN logs for bot User-Agent hits. Track AI referral traffic in analytics after 7–14 days.
5. Iterate: Identify pages with high impressions but low citations. Apply chunk validation and schema injection. Repeat until extraction success stabilizes.