Documentation

Installation

Setup Wizard

After activation, the setup wizard guides you through initial configuration in 3 steps:

1. Choose your site category (blog, business, e-commerce, news, etc.) — this applies optimized defaults
2. Configure modules — choose Simple mode (recommended presets) or Expert mode (toggle individual features)
3. Done — your site is now optimized for AI search engines

AI Crawler Tracking

The tracker automatically detects and logs AI crawler visits. It runs on every request with less than 3ms overhead.

• Detects 16+ known AI crawlers (GPTBot, ClaudeBot, PerplexityBot, Google-Extended, etc.)
• Logs crawler name, company, type, URL path, timestamp, and response code
• Rate-limited: 1 log per crawler per URL per hour (prevents database bloat)
• IP addresses are hashed with a unique salt — never stored in plain text
• Unknown bots are flagged for your review
• Data retention is configurable (default: 90 days raw, 365 days aggregated)

Analytics Dashboard

The dashboard provides visual analytics on AI crawler activity across your site.

• KPI cards: total crawls, active crawlers, pages discovered, average per day
• Crawler leaderboard: top crawlers by hit count
• Activity feed: real-time crawler detection
• Crawl volume timeline with daily bar charts
• Company market share donut chart
• Hourly activity heatmap (7×24 grid)
• GEO Score vs Crawls scatter plot (correlation)
• Content type popularity breakdown
• Most and least crawled content lists
• Unknown bot detection table
• AI referral traffic from ChatGPT, Perplexity, Gemini, etc.
• Access control stats (block rates)

GEO Content Scoring

Every post is scored 0-100 on AI readiness across 11 criteria.

• Content length (1500+ words for full score)
• Heading structure (proper H2/H3 hierarchy)
• Q&A format (questions answered in content)
• Structured lists (bullet points, numbered lists)
• Keyword integration
• Readability metrics
• Multimedia (images, videos)
• Internal links
• External links (authoritative sources)
• Schema markup presence
• AI-specific optimization (meta tags, summary)

AI Meta Tags

Dedicated ai-* namespace meta tags that help AI engines understand your content.

• ai-site-name — your site's name
• ai-site-description — what your site is about
• ai-title — post-specific title for AI
• ai-summary — concise summary of the post
• ai-keywords — relevant keywords
• ai-content-type — article, guide, news, product, faq, how-to, etc.
• ai-publish-date and ai-update-date
• ai-author and ai-category
• Never conflicts with SEO plugins (different namespace)

llms.txt Generator

Auto-generates a /llms.txt file in Markdown format to help AI crawlers understand your site.

• Lists your top posts, categories, and site description
• Automatically regenerated when you publish a new post
• Weekly regeneration fallback via cron
• Respects post privacy settings (excluded posts are hidden)
• Served via WordPress rewrite rules (no physical file required)
• Can also generate a physical file at site root

JSON-LD Schema

Auto-generates structured data schemas optimized for AI consumption.

• FAQPage schema — generated from Q&A content patterns
• HowTo schema — generated from step-by-step content
• Article schema — post metadata
• Organization / Person schema
• WebSite schema with SearchAction
• Speakable specification for voice AI
• Automatically skips schemas if your SEO plugin handles them

AI Access Control

5-layer hierarchy for controlling which AI crawlers can access your content.

• Layer 1: Site-wide mode (allow all, block all, or selective)
• Layer 2: Per-post-type rules (block specific post types)
• Layer 3: Taxonomy rules (block categories/tags)
• Layer 4: URL pattern rules (regex-based blocking)
• Layer 5: Per-post override (block individual posts)
• Response options: 403 Forbidden, 401 Unauthorized, noindex, or content placeholder
• Shortcodes: [wpgeo_noai] and [wpgeo_aionly] for inline control

AI Content Generation

Optional feature to generate AI summaries, FAQ schemas, and keywords using OpenRouter.

• Requires a free OpenRouter API key (you provide your own)
• Generate AI summaries for the ai-summary meta tag
• Generate FAQ content for FAQPage schema
• Generate keywords for ai-keywords meta tag
• Bulk generation tool for existing posts
• Works with multiple AI models (GPT, Claude, Mixtral, etc.)
• API key stored encrypted (AES-256-CBC)
• Your content is only sent when you click Generate — never automatically