Overview
The AI Audit feature uses Google Gemini to analyze your content for AI answer engines (Google AI Overviews, Perplexity, ChatGPT). Get actionable insights with transparent 4-dimensional scoring and automated quick fixes.AI Audits evaluate content across 4 key dimensions: Answerability (40%), Structure (20%), Trust (25%), and Technical (15%).
How It Works
GEO AI analyzes your content by sending it to Google’s Gemini API, which returns structured audit data including scores, issues, schema recommendations, and improvement suggestions.Audit Request Flow
Running Your First Audit
Understanding Audit Scores
Score Breakdown
Answerability
Weight: 40%Measures how well your content directly answers user queries. High scores indicate clear, concise answers that AI engines can extract.
Structure
Weight: 20%Evaluates content organization, headings, lists, and formatting. Well-structured content is easier for AI to parse.
Trust
Weight: 25%Assesses credibility signals like citations, author information, and factual accuracy. Trust signals boost AI visibility.
Technical
Weight: 15%Checks schema markup, semantic HTML, and technical SEO elements. Proper markup helps AI understand context.
Implementation Details
Core Analysis Function
The analyzer uses the Gemini API with structured JSON output:includes/class-geoai-analyzer.php
API Request Structure
includes/class-geoai-analyzer.php
Expected Response Schema
Gemini returns structured JSON with the following format:Auto-Run on Save
Enable automatic audits when publishing or updating content:Background Processing
When Action Scheduler is available, audits run asynchronously:includes/class-geoai-analyzer.php
Quick Fixes
Quick fixes provide one-click solutions to common issues:Insert Answer Card
Insert Answer Card
Issue: Content lacks a concise TL;DR summaryFix: Automatically inserts the Answer Card block at the beginning of your content with AI-suggested summary.
Add Citations
Add Citations
Issue: Missing authoritative sourcesFix: Suggests relevant citation URLs based on your content topic.
Improve Structure
Improve Structure
Issue: Poor heading hierarchy or missing sectionsFix: Recommends heading improvements and section organization.
Add Schema Markup
Add Schema Markup
Issue: Missing or incomplete schema.org markupFix: Enables appropriate schema types (Article, FAQ, HowTo) for your content.
WP-CLI Commands
Audit posts from the command line:Best Practices
Audit Before Publishing
Run audits on draft content to identify issues early in your workflow.
Monitor API Usage
Track your Gemini API quota usage to avoid unexpected charges or rate limits.
Address High-Severity Issues
Focus on fixing high-severity issues first for maximum impact on AI visibility.
Re-audit After Changes
Run new audits after making significant content updates to verify improvements.
Troubleshooting
Audit returns mock data
Audit returns mock data
Cause: No API key configured or invalid keySolution: Add a valid Gemini API key in Settings → General and test the connection.
Request timeout
Request timeout
Cause: API response taking longer than 45 secondsSolution: Reduce content length (limit is 20,000 characters) or try again during off-peak hours.
API error 429
API error 429
Cause: Rate limit exceededSolution: Wait before retrying, or upgrade your Gemini API quota.
Invalid JSON response
Invalid JSON response
Cause: Gemini returned malformed dataSolution: The parser attempts to extract JSON from response. Check error logs for details.
Related Features
Answer Card
Add TL;DR summaries with key facts
Schema Markup
Configure JSON-LD structured data
Meta Titles
AI-generated titles and descriptions