The central hub where monitoring, configuration, and optimization converge.

Table of Contents

• Interface Purpose
• Hero Banner & Actions
• First-Time Welcome
• Quick Access Navigation
• Unified Settings Panel
• Weekly Performance Summary
• Bot Visit Predictions
• Content AI Report
• Export Capabilities
• Recommended Workflow
• User Guidance

Interface Purpose

AI View serves as the comprehensive home screen for AISEOmatic, designed to be your primary workspace after plugin activation. This unified dashboard consolidates:

Core Components:

• Welcome guidance for new installations
• Quick configuration shortcuts
• Weekly performance metrics
• Bot activity predictions
• Live content optimization table
• One-click auto-optimizer
• Multiple export options

Landing Behavior: New users automatically arrive here post-activation, ensuring immediate access to essential setup tools and insights.

Hero Banner & Actions

Status Confirmation

A prominent banner at the page top provides immediate reassurance:

Primary Message:

“AISEOmatic is optimizing your site”

Visual Design:

• Blue background for positive reinforcement
• Clear, confident messaging
• Always-visible status indicator

Quick Actions

Refresh Button:

• Updates all dashboard metrics
• Pulls latest bot activity
• Refreshes content scores
• Synchronizes automation status

Open 1-Minute Wizard:

• Direct access to setup assistant
• Available anytime (not just first run)
• Streamlines configuration process
• Useful for reconfiguration

Background Process Reminder

Subtitle text confirms automated systems are active:

• Internal linking generation
• Sitemap updates
• Search engine pings
• Weekly content refresh

Purpose: Reassures users that optimization continues without manual intervention.

First-Time Welcome

Initial Visit Overlay

Upon first opening AI View, a friendly introduction appears:

Overlay Options:

Start 1-Minute Wizard:

• Launches immediate setup process
• Configures essential features
• Guided configuration experience
• Automatically triggers on-page wizard

Maybe Later:

• Dismisses overlay for current session
• Allows manual exploration first
• Can be reopened via hero banner
• Each administrator controls their own preference

Welcome Highlights

The overlay emphasizes three key features:

AI Sitemap & JSON-LD:

• Automated structured data
• Dedicated AI crawler sitemap
• Search engine communication

Bot ETA Prediction:

• Forecasts next crawler visits
• Helps plan content updates
• Monitors discovery patterns

Auto-Optimize Background:

• Continuous improvement
• No manual intervention required
• Set-and-forget functionality

Dismissal Behavior: Each admin user can dismiss once; preference is remembered per account.

Quick Access Navigation

Shortcut Grid

Compact navigation provides instant access to key interfaces:

Configuration Shortcuts:

• AI Experience: Feature management dashboard
• AI Insights: Performance analytics
• AI Local Business: Profile and schema settings
• OpenAI Key: API credential management
• License: Activation and renewal

Navigation Benefits:

• Eliminates WordPress menu navigation
• Reduces clicks to reach common destinations
• Accelerates configuration workflow
• Maintains context while switching views

Unified Settings Panel

Search Console Integration

Property Configuration:

• Display current Search Console property
• One-click jump to Settings → Reading
• Quick verification of connection

Sitemap Quick Links: Direct access to all sitemap types:

• sitemap.xml – WordPress default
• ai-sitemap.xml – AI-optimized sitemap
• hreflang-sitemap.xml – Multi-language support

IndexNow Support

Helper notes guide implementation:

• Configuration guidance
• Setup recommendations
• Integration instructions

AI Budget Management

Resource Controls:

• Daily Cap: Limit AI API calls per day
• Circuit-Breaker: Automatic failsafe activation
• Fallback Configuration: Secondary provider routing

Purpose: Prevents unexpected API costs while maintaining optimization continuity.

Module Toggles

Available Features:

Weekly Content Refresh:

• Automatic content updates
• Freshness signal maintenance
• Scheduled optimization cycles

Title A/B Testing:

• Experimental title variations
• Performance tracking
• Data-driven optimization

GSC Indexing Checks:

• Google Search Console integration
• Index status monitoring
• Coverage verification

Save Modules: Action button with immediate feedback confirmation upon changes.

Weekly Performance Summary

KPI Overview Card

At-a-glance metrics summarizing system health:

Content Activity:

• Posts Refreshed (7d): Count of updated content
• Shows automation effectiveness
• Indicates system activity level

Automation Status:

• Scheduled Jobs: Number of active cron tasks
• Confirms background processes running
• Validates automation configuration

Search Console:

• Property State: Connection status
• Last Check: Most recent verification timestamp
• Ensures data synchronization

Provider Keys: Status chips display validation state for major API providers:

• Visual health indicators
• Daily automatic verification
• Quick identification of authentication issues

Note: All provider keys undergo daily validation checks automatically.

Bot Visit Predictions

Crawler ETA Cards

Predictive analytics for top bot families:

Display Information:

• Bot name/family identification
• Next estimated visit timestamp
• Based on historical patterns
• Updates after each actual visit

Supported Bots: Displays predictions for most active crawlers:

• GPTBot (OpenAI)
• ClaudeBot (Anthropic)
• PerplexityBot
• GoogleBot-Extended
• Other AI crawlers with sufficient history

Export Functions

Bot Activity Data Download:

Export CSV:

• Clean, timestamped bot visit log
• Suitable for spreadsheet analysis
• Audit-ready format
• Stakeholder-friendly reports

Export JSON:

• Structured data format
• API integration compatible
• Development-friendly
• Programmatic processing

Use Cases:

• Client reporting
• Audit documentation
• Trend analysis
• Performance reviews

Content AI Report

Live Optimization Table

Interactive table displaying recent content with optimization status:

Display Scope:

• Last 20 posts/pages shown
• All content statuses included (published, draft, scheduled)
• Real-time score updates
• Instant badge changes

Table Columns

Title:

• Clickable link to public page
• Safe Preview link for unpublished content
• Opens in new tab
• Respects content visibility

Score:

• Current AI optimization score (0-100)
• Color-coded indicator
• Updates immediately after optimization
• Visual performance gauge

Features: Badge indicators show active enhancements:

• Schema: Structured data present
• Summary: AI summary generated
• Visual confirmation of optimization state

Status:

• WordPress content status
• Published, Draft, Scheduled, etc.
• Standard WordPress terminology

Actions: Quick-access buttons per row:

Edit:

• Opens WordPress editor
• Permission-checked access
• Direct modification capability
• Standard editing interface

Auto-Optimizer:

• One-click inline optimization
• Processes content immediately
• Updates Score and badges on success
• Non-technical operation
• Safe for all users

Auto-Optimizer Functionality

Process Flow:

1. User clicks Auto-optimizer button
2. System analyzes content
3. Applies AI enhancements
4. Generates/updates summary
5. Refreshes schema markup
6. Recalculates AI Score
7. Updates table row instantly

Safety Features:

• Permission verification
• Non-destructive process
• Preserves original content
• Reversible enhancements

Ideal For:

• Quick wins demonstration
• Stakeholder presentations
• Immediate value proof
• Editor empowerment

Export Capabilities

Page-Level Exports

Located directly below the “AI View” heading:

Export CSV:

• Basic content audit data
• Title, Score, Features, Status
• Quick snapshot format
• Lightweight download

Export CSV + Details:

• Enhanced report version
• Includes Search Console checks per URL
• Recent indexing status
• Coverage information
• Index state verification

Use Cases:

• External audit documentation
• Client deliverables
• Presentation decks
• Stakeholder updates
• Performance tracking

Format Benefits:

• Timestamped exports
• Clean, professional presentation
• Spreadsheet-compatible
• No WordPress access required for viewing

Recommended Workflow

Optimal Usage Pattern

Step 1: Status Verification (30 seconds)

• Review hero banner confirmation
• Verify “optimizing your site” message
• Check for any alerts or warnings
• Open 1-minute wizard if first time

Step 2: Configuration Check (2 minutes)

• Access Unified Settings panel
• Verify Search Console connection
• Review sitemap availability (click links to test)
• Configure module toggles as needed
• Click Save Modules if changes made

Step 3: Health Assessment (1 minute)

• Review Weekly Report KPIs
• Check Posts Refreshed count
• Verify Scheduled Jobs active
• Examine GSC property state
• Scan Keys Status chips for issues

Step 4: Bot Activity Analysis (2 minutes)

• Review Bot ETA prediction cards
• Note next estimated visit times
• Export CSV/JSON if reporting needed
• Identify which bots are active
• Plan content updates around predictions

Step 5: Content Optimization (Ongoing)

• Scan Content AI Report table
• Identify low-scoring content
• Click Auto-Optimizer for quick fixes
• Use Edit for manual refinements
• Watch scores update in real-time
• Export data for documentation

User Guidance

Access & Permissions

User Level: AI View is administrator-only access:

• Requires manage_options capability
• Displays actionable KPIs
• Shows configuration shortcuts
• Provides lightweight activity logs

Security Measures:

• API keys remain masked in other interfaces
• All actions are permission-checked
• No sensitive data exposure in this view
• Safe for multiple admin users

Getting Started Tips

New Installation:

• Plugin automatically redirects here once post-activation
• Start with 1-minute wizard
• Follow on-screen prompts
• Configuration persists across sessions

Regular Usage:

• Bookmark this page for daily checks
• Use as primary dashboard
• Monitor weekly KPIs regularly
• Run Auto-optimizer opportunistically

Reporting Workflow:

• Use Export CSV + details for comprehensive reports
• Include Search Console data for stakeholders
• Generate before client meetings
• Create regular performance snapshots

Quick Value Demonstration:

• Select one low-scoring post from table
• Click Auto-Optimizer
• Watch score improve instantly
• Show stakeholders immediate results
• Safe to test on single items

Best Practices

Daily Routine:

1. Quick banner check (5 seconds)
2. Weekly Report scan (30 seconds)
3. Bot ETA review (30 seconds)
4. Optimize 1-2 posts (2 minutes)

Weekly Review:

1. Full KPI assessment
2. Export CSV + details
3. Analyze trends
4. Plan optimization priorities
5. Adjust module settings if needed

Monthly Audit:

1. Comprehensive export with Search Console data
2. Bot activity trend analysis
3. Content score distribution review
4. Configuration optimization
5. Stakeholder reporting

Troubleshooting

Common Issues

Auto-Optimizer Not Working:

1. Verify user has edit permissions for content
2. Check OpenAI API key is valid
3. Ensure content meets minimum length
4. Review API budget not exceeded
5. Check error console for specifics

Bot ETA Cards Empty:

1. Allow 7-14 days for prediction data
2. Verify bots have visited site
3. Check bot detection is enabled
4. Confirm AI sitemap is accessible

Weekly Report Shows Zero:

1. Verify automation modules enabled
2. Check WP-Cron is functioning
3. Review scheduled jobs in Debug
4. Confirm sufficient time elapsed

Support

For AI View assistance: Email: contact@aiseomatic.com

The post AISEOmatic AI View — Command Center & Content Dashboard appeared first on AISEOmatic.

Centralized Configuration for Local SEO & AI Integration

Manage your business profile, API connections, and AI policies from one unified interface.

Table of Contents

• Interface Purpose
• Quick Navigation Bar
• API Provider Management
• Business Profile Setup
• Robots & AI Features
• JSON-LD Schema Preview
• Interactive Help System
• Configuration Validation
• Setup Workflow
• Optimization Guidelines

Interface Purpose

The Local Business hub consolidates four critical configuration areas into a single, streamlined interface:

1. API Provider Credentials: Connect and test AI service integrations
2. Public Business Profile: NAP (Name, Address, Phone) and service information
3. Robot Policies: Control AI agent behavior and front-end features
4. JSON-LD Preview: Real-time structured data validation

Additional Benefits:

• Integrated quick-access navigation to other AISEOmatic modules
• One-page configuration eliminates menu hunting
• Immediate validation and testing capabilities
• Centralized control reduces configuration errors

Quick Navigation Bar

Shortcut Buttons

Top-positioned navigation provides instant access to:

Configuration Sections:

• API: Jump to provider settings
• Local: Access business profile
• Robots: Manage policies and features
• JSON-LD: View schema preview

Related Modules:

• AI Cockpit: Command center overview
• AI Insights: Performance analytics
• AI Experience: Feature management
• Debug: System diagnostics

Workflow Enhancement: Configure settings on this page, then immediately verify results in Insights or Cockpit without navigating through WordPress menus.

API Provider Management

Supported AI Services

Connect multiple AI providers for maximum flexibility and reliability:

Available Integrations:

• OpenAI: GPT models for content generation
• Anthropic: Claude for analysis and summaries
• Perplexity: Real-time information access
• Google Gemini: Multi-modal AI capabilities
• You.com: Alternative search integration

Connection Configuration

Key Management: Each provider has a dedicated credential field with instant validation:

• Key Entry: Paste your API key securely
• Test Function: Verify connection immediately (available for all except You.com)
• Status Indicator: Real-time validation feedback
• Error Detection: Specific error messages for troubleshooting

Primary Provider Selection: Choose your preferred AI service via dropdown menu:

• Primary: First provider attempted for all requests
• Fallback: Automatic failover to secondary providers
• Redundancy: Ensures continuous operation if primary fails
• No Interruption: Seamless switching with no user intervention

OpenAI Project Configuration

Optional Enhancement:

• Project ID Field: Specify OpenAI workspace if required
• Header Injection: Automatically includes OpenAI-Project in API calls
• Error Resolution: Prevents 401 “no such project” authentication failures
• Smart Validation: System detects and corrects common entry mistakes

Intelligent Error Prevention

Automated Safeguards:

The system includes protective measures against configuration errors:

Key Misplacement Detection:

• Identifies API keys mistakenly entered in Project ID field
• Automatically relocates to correct credential field
• Clears incorrect values
• Displays brief notification explaining correction

Header Validation:

• Strips malformed OpenAI-Project headers
• Prevents 401 authentication errors
• Operates transparently without user intervention

Save Confirmation: Upon clicking Save Settings, a success notification confirms:

• Credentials stored securely
• Provider connections verified
• Configuration applied system-wide

Business Profile Setup

NAP Information

Complete your business identity for local SEO and AI understanding:

Required Fields:

• Business Name: Your official company name (mandatory)

Contact Information:

• Website URL: Primary domain
• Phone Number: Contact number with country code
• Email: Business correspondence address

Physical Location:

• Street Address: Complete street information
• Postal Code: ZIP/postal code
• City: Municipality name
• Country: Nation designation

Geographic Precision:

• Latitude: Decimal coordinates
• Longitude: Decimal coordinates
• Map URL: Link to your location on mapping service

Service Coverage:

• Service Areas: List of regions you serve
  • Used for areaServed schema property
  • Enhances local search visibility
  • Clarifies geographic scope

Data Application

Information entered here powers:

• Site-wide LocalBusiness JSON-LD: Structured data for search engines
• AI Entity Recognition: Helps AI systems identify your business
• Local Search Signals: Improves “near me” query performance
• Knowledge Graph: Contributes to search engine understanding

Format Guidance: Placeholder text in each field demonstrates proper formatting, ensuring consistent, machine-readable data entry.

Robots & AI Features

AI Agent Policy Controls

Define how AI systems may interact with your content:

Text Usage:

• noai Tag: Prevents AI systems from using text content
  • Applies to all written material
  • Respects content ownership
  • Communicates usage restrictions

Image Usage:

• noimageai Tag: Blocks AI image processing
  • Protects visual assets
  • Prevents training data inclusion
  • Maintains image rights

AI Sitemap Privacy:

• Noindex for AI-Sitemap: Adds X-Robots-Tag to /ai-sitemap.xml
  • Controls sitemap visibility
  • Maintains page optimization
  • Selective disclosure option

Front-End AI Integration

Activate public-facing AI enhancement features:

Structured Data:

• Inject JSON-LD: Outputs AI-friendly schema markup
  • Enhances content understanding
  • Improves search result richness
  • Provides entity context

Sitemap Management:

• AI-Sitemap: Maintains dedicated AI crawler sitemap
  • Located at /ai-sitemap.xml
  • Prioritizes AI-optimized content
  • Updates automatically

Content Connections:

• Entity Linking: Creates contextual “You may also like” blocks
  • Lightweight internal linking
  • Semantic relationship discovery
  • Improves content mesh

Media Optimization:

• Image ALT Auto-Fill: Generates alternative text on upload
  • Improves accessibility
  • Enhances SEO
  • Saves manual effort

Maintenance Operations

Quick Action Buttons:

Check WP-Cron:

• Verifies WordPress scheduler status
• Confirms automated task functionality
• Displays next scheduled run times
• Inline status notification

Sync CRON:

• Synchronizes scheduled tasks
• Updates automation schedule
• Resolves scheduling conflicts
• Confirmation message appears

Run AI Jobs Now:

• Executes pending AI tasks immediately
• Bypasses scheduled timing
• Processes queue manually
• Useful after bulk changes

Status Messaging: A persistent message below action buttons confirms automation is active, allowing editors to continue work confidently.

JSON-LD Schema Preview

Structured Data Display

Read-Only Preview: View your complete site-wide LocalBusiness JSON-LD markup before it goes live:

• Business Information: Name, contact, location
• Service Areas: Geographic coverage
• Operating Details: Hours, services, attributes
• Automatic Additions: Article, WebPage, FAQ schemas added per page type

Schema Actions:

Generate:

• Creates fresh JSON-LD output
• Incorporates latest profile changes
• Updates all schema properties

Validate:

• Checks syntax correctness
• Verifies required properties
• Identifies missing elements
• Google-compatible verification

Pause:

• Temporarily disables JSON-LD output
• Useful during site updates
• Preserves configuration
• Reactivate anytime

Clear:

• Removes all generated schema
• Fresh start option
• Requires regeneration to restore

Note: Preview display is read-only; modifications occur through Business Profile settings, not directly in the preview.

Interactive Help System

Information Modals

Each configuration section includes a help button () providing:

Available Guides:

• API Providers: Connection setup and testing
• Local Business: Profile completion guidelines
• Robots & Features: Policy implications explained
• JSON-LD: Schema structure and purpose

Modal Characteristics:

• Plain-English explanations
• No technical jargon
• Practical examples
• Use case scenarios
• No code references

Access: Click any icon to open relevant help documentation instantly.

Configuration Validation

One-Click Health Check

Located at the bottom of the page, the Validate Configuration button performs comprehensive verification:

Validation Checks:

Business Information:

• Confirms Business Name is populated (required field)
• Verifies contact information completeness
• Checks location data accuracy
• Reviews service area definitions

Provider Configuration:

• Ensures primary provider has valid API key
• Tests provider connectivity
• Verifies fallback providers configured
• Confirms authentication success

System Health:

• Pings WP-Cron scheduler
• Verifies automation status
• Checks background task queue
• Confirms scheduled job timing

Result Display:

• Toast notifications for each check
• Top status bar synchronization
• Clear pass/fail indicators
• Specific error guidance when issues detected

Best Practice: Run validation after any configuration changes to ensure proper setup before going live.

Setup Workflow

Recommended Configuration Sequence

Step 1: Business Profile (2 minutes)

1. Enter complete NAP information
2. Add latitude/longitude for precision
3. Include map URL reference
4. List all service areas
5. Click Save

Step 2: API Provider Connection (3 minutes)

1. Paste API keys for chosen providers
2. Select primary provider from dropdown
3. Add OpenAI Project ID if required
4. Click Test button for each provider
5. Verify successful connection
6. Click Save Settings

Step 3: Policy Configuration (2 minutes)

1. Review AI usage policies (noai/noimageai)
2. Select appropriate restrictions
3. Consider AI sitemap privacy
4. Decide on each policy toggle
5. Click Save

Step 4: Feature Activation (2 minutes)

1. Enable desired front-end signals
2. Activate JSON-LD injection
3. Enable AI-Sitemap if appropriate
4. Configure entity linking preference
5. Activate image ALT automation
6. Click Save

Step 5: Validation & Review (1 minute)

1. Click Validate Configuration
2. Review toast notifications
3. Check status bar
4. Address any errors identified
5. Open JSON-LD Preview to verify schema output

Step 6: Verification (2 minutes)

1. Use quick navigation to open AI Insights
2. Verify business information displays correctly
3. Check schema validation in testing tools
4. Confirm AI sitemap accessibility
5. Return to adjust if needed

Total Time: ~12 minutes for complete setup

Optimization Guidelines

Provider Strategy

Primary + Fallback Approach:

Recommendation:

• Choose most reliable provider as primary
• Configure 2-3 fallback options
• Test all providers before deployment
• Monitor performance over time

Benefits:

• Automatic failover during outages
• Reduced downtime
• Continuous operation
• No manual intervention required

Provider Selection Tips:

• OpenAI: Best for general content generation
• Claude (Anthropic): Excellent for analysis and summaries
• Gemini: Strong multi-modal capabilities
• Consider response time and cost in selection

Project ID Usage

When to Use OpenAI Project ID:

• Your OpenAI account uses project-based organization
• You receive “no such project” authentication errors
• Multiple team members share account with separate projects
• API calls require project specification

When to Skip:

• Personal OpenAI account without projects
• No project-related errors encountered
• Simpler account structure

Protection: The system automatically prevents mis-configuration, so entering information here is safe even if unnecessary.

Content Policy Decisions

Determine Early:

noai Implementation:

• Decide on text usage permissions upfront
• Consider competitive implications
• Evaluate content uniqueness value
• Remember: changeable later without code modifications

noimageai Considerations:

• Assess image proprietary value
• Consider AI training data concerns
• Evaluate visual content uniqueness
• Balance between protection and discovery

Flexibility: All policy settings are reversible; test different configurations to find optimal balance.

Location Precision

Geographic Data Quality:

Latitude/Longitude:

• Provides exact location for AI systems
• Improves local search accuracy
• Essential for “near me” queries
• Use decimal format (e.g., 40.7128, -74.0060)

Map URL:

• Links to your location on mapping service
• Enhances user experience
• Provides verification for AI systems
• Improves voice assistant responses

Service Areas:

• List all regions you serve
• Be specific with city/region names
• Helps AI understand geographic scope
• Improves local search targeting

Quality Impact: Precise location data significantly improves visibility in local AI search results and voice assistant responses.

Troubleshooting

Common Setup Issues

API Connection Failures:

1. Verify API key copied completely (no spaces)
2. Check provider account has valid billing
3. Confirm API key hasn’t expired
4. Test each provider individually
5. Review error message for specifics

Validation Errors:

1. Ensure Business Name is filled (required)
2. Verify primary provider key is valid
3. Check WP-Cron is enabled
4. Confirm no plugin conflicts
5. Clear cache and retry

JSON-LD Not Appearing:

1. Verify “Inject JSON-LD” is enabled
2. Click Generate in preview section
3. Clear site cache
4. Check page source for <script type="application/ld+json">
5. Validate using schema testing tool

Support

For Local Business configuration assistance: Email: contact@aiseomatic.com

AISEOmatic Local Business Configuration Guide

Last Updated: December 13, 2025

The post AISEOmatic Local Business — Profile, JSON-LD & Robots appeared first on AISEOmatic.

Get started in 60 seconds with intelligent presets tailored to your optimization goals.

Table of Contents

• Purpose & Overview
• Access Location
• Welcome Wizard
• Preset Selection
• Custom Configuration
• Instant Activation
• Quick Navigation
• Status Messages
• Getting Started Workflow
• Recommendations by User Type

Purpose & Overview

Quick Setup streamlines your AISEOmatic configuration into a single, efficient process. Select a pre-configured optimization strategy, customize specific features if desired, and activate everything with one click. The entire process takes approximately 60 seconds from start to finish.

What You Get:

• Three expert-designed configuration templates
• Instant feature activation
• No technical knowledge required
• Immediate optimization results
• Easy modification after initial setup

Access Location

Menu Path: WordPress Admin → AISEOmatic AI → Quick Setup

User Requirements:

• Administrator access (manage_options capability)
• Active AISEOmatic installation
• Available to all admin-level users

Additional Access Points:

• Linked throughout the plugin interface
• Accessible during first-run experience
• Available from main dashboard
• Quick links from other AISEOmatic pages

Welcome Wizard

First-Time Experience

Upon initial access to AI View, an intuitive overlay guides you through essential configuration steps. This welcome screen can be activated immediately or postponed based on your preference.

Wizard Components:

Step 1: Provider Connection

• Enter your OpenAI API credentials
• Direct shortcut to API key configuration page
• Connection verification included
• Optional setup for additional AI providers

Step 2: Search Console Integration

• Configure your property in WordPress Reading settings
• Establishes search performance tracking
• Enables organic traffic monitoring

Step 3: Module Activation

• Enable weekly automatic refresh
• Optional Google Search Console verification
• Optional title A/B testing features
• Baseline automation configuration

Wizard Controls

Action Options:

• Start Setup: Begin immediate configuration
• Maybe Later: Postpone wizard (preference saved per administrator)
• Reopen Wizard: Access anytime from AI View via “Open 1-minute wizard”

Your choice is remembered, preventing repeated prompts while maintaining easy access when needed.

Preset Selection

Configuration Templates

Three carefully designed presets accommodate different optimization strategies and risk tolerances:

Conservative Preset

Philosophy: Safe, proven features with minimal automation

Activated Features:

• JSON-LD structured data
• AI sitemap generation
• Content summaries enabled
• Manual approval workflows
• Essential optimization only

Best For:

• First-time users
• Existing heavy SEO stack
• Risk-averse organizations
• Testing AISEOmatic gradually
• Compliance-focused sites

Automation Level: ~75%

Standard Preset

Philosophy: Balanced automation with proven effectiveness

Activated Features:

• Content summaries
• Entity extraction
• Intent analysis
• Trending topic detection
• AI sitemap
• JSON-LD implementation
• Moderate automation

Best For:

• Most websites
• General business sites
• Balanced approach seekers
• Standard publishing workflows
• Mixed content types

Automation Level: ~90%

Aggressive Preset

Philosophy: Maximum automation and cutting-edge features

Activated Features:

• Automatic contextual linking
• Real-time performance optimization
• Multi-language intelligence
• Visual content analysis
• Advanced entity mapping
• Full automation suite
• Proactive optimization

Best For:

• High-volume publishers
• Content-heavy platforms
• Multi-language sites
• Advanced users
• Maximum automation preference

Automation Level: ~99%

Preset Information

Each preset card includes an information button () that reveals:

• Detailed feature breakdown
• Plain-English explanations
• Use case scenarios
• Expected behavior
• Recommended site types

Selection Process:

1. Review preset descriptions
2. Click for detailed information
3. Select the preset matching your needs
4. Click Apply to activate
5. Success banner confirms implementation

Custom Configuration

Feature Toggle Grid

Beyond preset selection, granular control is available through organized feature categories:

AI Discovery

• AI Summaries generation
• Content analysis automation
• Semantic understanding

Content Intelligence

• Entity extraction
• Topic clustering
• Intent mapping
• Trend detection

Technical SEO

• Organization JSON-LD
• Article/Page schema
• AI Sitemap generation
• Meta optimization

Linking & User Experience

• Automatic AI Meshing (internal linking)
• Contextual link building
• Navigation enhancement

Security & Protection

• AI Anti-Scraping measures
• Bot management
• Content protection

Performance

• Caching strategies
• Load optimization
• Resource management

Creative & Marketing

• Multi-language support
• Visual analysis
• A/B testing capabilities

Customization Process

Before Applying:

1. Select base preset
2. Review enabled features via checkboxes
3. Toggle individual features on/off
4. Features are grouped logically for easy navigation
5. Changes persist across all AISEOmatic interfaces

Checkbox Behavior:

• Checked: Feature enabled
• ☐ Unchecked: Feature disabled
• Changes apply to entire site
• Settings sync across Experience, Insights, Reporting
• Modifications saved upon clicking Apply

Instant Activation

Apply Wiring Now

Located in the top-right corner, this action button ensures immediate configuration implementation:

Function:

• Activates selected features instantly
• Bypasses waiting for scheduled tasks
• Synchronizes settings across the plugin
• Updates all dependent systems

When to Use:

• After changing presets
• Following feature toggles
• Before verifying implementation
• When immediate effect needed

System Response:

• Inline status confirmation
• Drift check performed automatically
• Synchronization verification
• Mismatch resolution (if detected)

Background Processing

Drift Detection: The system continuously monitors configuration consistency. If any misalignment is detected between your selections and active features, automatic refresh occurs with status notification.

Synchronization: All settings propagate to:

• AI Experience interface
• Insights dashboard
• Reporting module
• Bot Detection system
• Debug tools

Quick Navigation

Integrated Jump Links

Positioned at the top of the Quick Setup page, these buttons provide instant access to related interfaces:

Available Links:

• AI Experience: Feature management
• AI Insights: Performance metrics
• AI Reporting: Detailed analytics
• AI Bot Detection: Crawler monitoring
• Debug: System diagnostics

Usage Pattern:

1. Apply your preset/configuration
2. Click relevant quick link
3. Verify settings implementation
4. Review immediate results
5. Return to Quick Setup for adjustments if needed

This eliminates menu navigation and accelerates the configuration-verification cycle.

Status Messages

Success Notifications

Preset Application:

✅ Preset applied successfully. Wiring updated.

Feature Changes:

✅ Configuration saved. Features activated.

Synchronization:

✅ Settings synchronized across all modules.

Error Handling

If configuration cannot be applied:

⚠ Unable to apply preset. Please retry or contact support.

Clear, actionable error messages guide resolution without technical jargon.

Information Modals

Clicking any button reveals:

• Feature purpose in plain language
• Expected behavior
• Use case examples
• Compatibility notes
• No technical terminology

Getting Started Workflow

Recommended First-Time Process

Step 1: Initial Assessment (15 seconds)

• Consider your site type
• Evaluate automation comfort level
• Review existing SEO setup
• Determine risk tolerance

Step 2: Preset Selection (15 seconds)

• Read preset descriptions
• Click for details if needed
• Select matching preset
• Note activated features

Step 3: Optional Customization (15 seconds)

• Review feature checkboxes
• Adjust specific features if desired
• Maintain base preset philosophy
• Avoid over-customization initially

Step 4: Activation (10 seconds)

• Click Apply on chosen preset
• Wait for success notification
• Click Apply Wiring Now
• Confirm synchronization message

Step 5: Verification (5 seconds)

• Use Quick Links to access Insights or Reporting
• Verify features activated
• Check initial metrics
• Return to Debug if needed

Total Time: ~60 seconds

Recommendations by User Type

New to AI SEO

Recommended: Standard Preset

Rationale:

• Balanced feature set
• Proven effectiveness
• Manageable complexity
• Room for growth
• Safe defaults

Next Steps:

• Monitor results for 2 weeks
• Review AI Score improvements
• Check bot activity
• Consider adding features gradually

Existing SEO Stack

Recommended: Conservative Preset

Rationale:

• Prevents plugin conflicts
• Minimal overlap with existing tools
• Easy integration
• Low risk of duplication
• Controlled expansion

Next Steps:

• Verify no schema duplication
• Monitor for conflicts
• Enable additional features incrementally
• Test each addition thoroughly

High-Volume Publishers

Recommended: Aggressive Preset

Rationale:

• Maximum automation saves time
• Handles large content volumes
• Proactive optimization
• Multi-language support included
• Contextual linking at scale

Next Steps:

• Monitor automation quality
• Review auto-generated links
• Verify multi-language accuracy
• Adjust if over-optimization occurs

E-Commerce Sites

Recommended: Standard Preset + WooCommerce Features

Rationale:

• Product schema optimization
• Safe Lanes protection
• Balanced automation
• Checkout protection
• Category optimization

Additional Toggles:

• Enable product-specific features
• Activate visual analysis for images
• Consider multi-language for international sales

Local Businesses

Recommended: Standard Preset + Local SEO

Rationale:

• Local schema markup
• “Near me” optimization
• Geographic targeting
• Business information accuracy

Additional Focus:

• Enable Organization JSON-LD
• Verify local entity extraction
• Monitor local search bot activity

Configuration Tips

Preset Modification

Safe Approach:

1. Start with recommended preset
2. Run for 7-14 days
3. Review performance metrics
4. Add one feature at a time
5. Monitor each change impact

Avoiding Common Mistakes

Don’t:

• Switch presets frequently
• Enable all features immediately (if new)
• Ignore compatibility warnings
• Skip the verification step
• Forget to apply wiring

Do:

• Test changes on staging first (if available)
• Document your configuration
• Monitor bot activity after changes
• Check for duplicate schema
• Review AI Scores regularly

Troubleshooting Setup Issues

Preset Won’t Apply:

1. Check user permissions
2. Verify plugin activation
3. Clear WordPress cache
4. Try Apply Wiring Now
5. Contact support if persists

Features Not Working:

1. Confirm Apply Wiring Now clicked
2. Check feature dependencies
3. Review compatibility settings
4. Verify no plugin conflicts
5. Consult Debug panel

Support

For Quick Setup assistance: Email: contact@aiseomatic.com

AISEOmatic Quick Setup Guide

Last Updated: December 13, 2025

The post AISEOmatic Quick Setup — 1-Minute Wizard & Presets appeared first on AISEOmatic.

Table of Contents

• Overview
• Tab Navigation
• General Configuration
• Module Controls
• Front-End Options
• SEO & Schema Management
• System Health
• License Management
• Configuration Tips

Overview

The Settings (Alt) interface serves as your centralized configuration hub for AISEOmatic. This streamlined dashboard organizes all essential controls into logical sections, allowing you to manage API connections, activate features, customize front-end behavior, configure SEO outputs, and monitor system health from a single location.

Key Benefits:

• Unified control panel for all major settings
• Visual confirmation of configuration changes
• Real-time status indicators
• Integrated health monitoring
• Quick access to core functions

Tab Navigation

The settings interface is organized into six primary sections, accessible via the horizontal tab menu:

┌─────────────────────────────────────────────────────┐
│ General | Modules | Front-End | SEO & Schema |      │
│ System | License                                     │
└─────────────────────────────────────────────────────┘

Simply click any tab to access its configuration options. Your current position is highlighted for easy navigation.

General Configuration

API & Credential Setup

OpenAI Integration Configure your AI content generation capabilities:

• API Key Input: Securely store your OpenAI credentials
• Key Masking: Previously entered keys display as sk-proj-****...**** for security
• Connection Verification: Test button validates endpoint accessibility immediately
• Status Display: Real-time feedback shows connection success or specific error codes

Plugin License Manage your AISEOmatic Pro activation:

• Enter your unique license identifier
• Enables automatic updates and premium features
• Required for Pro functionality access
• Validated against licensing server

CRON Enhancement (Optional) Optimize scheduled task reliability:

• Activation Key Field: Improve task execution on low-traffic websites
• Command Generator: Pre-formatted CRON command for easy server setup
• WP-Cron Checker: Instant verification of WordPress scheduler status
• Next Run Display: Shows upcoming scheduled task times

Configuration Results

Upon saving valid credentials:

• OpenAI key is encrypted and stored securely
• Connection test provides immediate validation
• CRON configuration updates background task scheduling
• Status messages confirm each action’s success

Best Practice: Always test your OpenAI connection after entering or updating your API key to ensure proper functionality.

Module Controls

Feature Activation Panel

Enable or disable major functionality with simple toggle switches:

Content Enhancement

• AI Summaries: Automatically generate concise, AI-optimized content descriptions
  • Triggers on content publication
  • Runs via scheduled background processes
  • Improves AI engine comprehension

Link Intelligence

• Auto Meshing: Contextual internal link generation between related content
  • Analyzes semantic relationships
  • Creates natural linking patterns
  • Enhances site structure automatically

Protection Features

• Anti-Scraping: Lightweight crawler protection measures
  • Targets aggressive automated systems
  • Preserves legitimate bot access
  • Maintains search engine compatibility

Administrative Aids

• AI Score Column: Visual optimization indicators in content lists
• Optimization Badge: Quick-reference checkmarks for AI-ready content
  • Displays in post/page tables
  • Helps identify improvement opportunities

Structured Data

• Organization Schema: Site-wide business/entity markup
• Content Schemas: Page-type specific structured data
  • Article schema for blog posts
  • WebPage schema for standard pages
  • Automatically selects appropriate type

All toggles apply changes site-wide without requiring code modifications.

Front-End Options

Public-Facing Configuration

Control what visitors and external systems see:

Search Integration

• Summary Inclusion: Make AI-generated summaries searchable
  • Enhances internal search relevance
  • Improves content discovery
  • Provides richer search results

AI Feature Control

• Master Override: Complete disable of all AI front-end enhancements
  • Useful for testing scenarios
  • A/B testing compatibility
  • Temporary deactivation during site updates
  • Removes all AI-specific DOM additions

This master switch provides instant control over public-facing AI features while maintaining backend optimization processes.

SEO & Schema Management

Search Engine Optimization Controls

Sitemap Configuration

• AI Page Inclusion: Add AI-optimized content to XML sitemaps
  • Improves crawler discovery
  • Prioritizes AI-ready pages
  • Maintains separate tracking

Meta Enhancement

• Entity Injection: Surface extracted entities as HTML meta tags
  • Strengthens topical authority signals
  • Improves content classification
  • Enhances semantic understanding

Schema Coordination

• Force Schema Output: Priority control for JSON-LD generation
  • Detection System: Automatically identifies active SEO plugins
  • Conflict Prevention: Shows warnings when duplicates possible
  • Override Option: Make AISEOmatic schema take precedence

Plugin Compatibility

When third-party SEO plugins are detected:

• Information banner displays active plugin name
• Guidance provided for conflict resolution
• Recommended settings shown
• Force option available to eliminate duplicates

Compatible Plugins:

• Yoast SEO
• Rank Math
• All in One SEO
• SEOPress

System Health

Background Task Management

Scheduler Status Monitor WordPress CRON system:

• Enablement Check: Verify WP-Cron is active
• One-Click Test: Instant scheduler verification
• Status Display: Clear enabled/disabled indicator

Task Schedule Visibility View upcoming automated processes:

• Summary Generation: Next scheduled run time
• Daily Scan: Content analysis schedule
• Task Queue: Pending operations display

Manual Task Control Execute operations on-demand:

• Health Check Re-run: Queue essential verification tasks
  • Useful after configuration changes
  • Validates system integrity
  • Updates task schedule
• Immediate Execution: Bypass scheduler for instant processing
  • No queue waiting
  • Confirmation dialog prevents accidents
  • Completion notice upon finish
  • Runs summary generation and content scan

Documentation Access Direct link to comprehensive online documentation for detailed guidance.

License Management

Activation Status Panel

Information Display:

• Current license status (Active/Expired/Invalid)
• Expiration date visibility
• Renewal timeline
• Update eligibility

Key Management:

• License entry field
• Validation on save
• Status update upon verification
• Error messaging for invalid licenses

Review and update your license credentials directly from this interface.

Configuration Tips

SEO Plugin Integration

Recommended Approach:

1. Initially keep “Force AISEOmatic JSON-LD Schema” disabled
2. Check your site’s markup for duplicates
3. If schema duplication occurs, enable Force option
4. Active SEO plugins trigger automatic notifications
5. Follow on-screen guidance for optimal configuration

Low-Traffic Site Optimization

CRON Enhancement Steps:

1. Add hosting activation key in General tab
2. Implement provided CRON command on server
3. Use “Check WP-Cron” in both General and System tabs
4. Verify scheduled task execution times
5. Confirm regular summary and scan completion

Temporary Feature Deactivation

During Site Redesign:

• Enable “Disable All AI Front-End Injection” in Front-End tab
• Complete your design modifications
• Test thoroughly with AI features disabled
• Re-enable when changes are finalized
• Verifies compatibility before full activation

API Key Security

Best Practices:

• Never share your OpenAI API key
• Test connection immediately after entry
• Monitor masked display for verification
• Update key if compromised
• Check connection status regularly

Saving & Confirmations

Feedback System

Success Indicators: After submitting changes, the interface provides clear confirmation:

• Green banner: “Settings saved successfully”
• Health check actions: “Health check queued”
• Immediate execution: “Run Now completed”
• Connection tests: “Connection successful” or specific error

Status Messages: Each action produces specific feedback:

• Configuration saves: Confirmation with timestamp
• Health operations: Queue or completion status
• Test functions: Success/failure with details
• License updates: Validation results

The interface refreshes to display your updated settings with confirmation banners visible at the top of the page.

Support

For configuration assistance or technical questions: Email: contact@aiseomatic.com

AISEOmatic Settings Configuration Guide

Last Updated: December 13, 2025

The post AISEOmatic Settings (Alt) — Tabs, Toggles & Health Tools appeared first on AISEOmatic.

Master your AI optimization strategy from a single, streamlined dashboard.

What This Page Is For

Cockpit AI is your central command: a fast overview of AI readiness, recent activity, and crawler signals—plus one-click actions to keep everything moving. Figures here mirror AI Reporting and Bot Detection for consistency across the suite.

Navigation & Tabs

A clean tab bar groups tools so editors find what they need quickly:

Overview • Modules • Activity • Bot Detection • Reports

Overview — KPI Strip & Quick Insight

Live Indicators

At the top, a compact strip highlights three live indicators:

AI-Optimized Coverage (%)

• Share of your published content that’s AI-ready
• A small “How it’s calculated” link opens a plain-English explainer

Last AI Task

• The most recent automated action (cron/manual) with a friendly timestamp

Pending Summaries

• Live count of items waiting for an AI summary

Detail Cards

Below, four cards provide more detail:

Pages Optimized by AI

• Shows with-summary / total with an explainer link

Pages Containing AI Schema

• Count and percentage across your site

Pending Summaries (live)

• Mirrors the queue in real time

Distinct Bot Types

• How many crawler families were detected recently

Cron Schedule

A Cron schedule list displays each upcoming AISEOmatic task with the next run (local/GMT), so you can verify automation at a glance.

When you trigger actions from this page, a small notice confirms if something was queued or completed, keeping the workflow crystal clear.

Quick Actions (Safe & Focused)

From the Cockpit you can run three essential actions:

1. Scan for Missing Summaries

• Queues a site-wide check for items that still need an AI summary

2. Generate AI Summaries Now

• Queues summary generation for eligible content

3. Run Now

• Executes both scan and generation immediately (synchronous)
• Useful right after bulk edits
• Each action records activity and updates the “Last AI Task” timestamp automatically

Modules — Toggle Key Capabilities

The Modules tab lists major capabilities with an On/Off button and a short, non-technical description:

• AI Summaries
• Semantic Tagging
• Internal Linking
• Weekly Auto-Reports

Toggling is instant and logs a note in the Activity tab. (Admin permissions apply.)

Activity — What Happened, When

A simple table shows the last 50 actions with four columns:

Time

• Timestamp of the action

Action Type

• Analysis, summary, settings, manual

Content/Task

• What was processed or modified

Outcome

• Scheduled, Started, Completed Successfully

Routine automated entries (cron) are logged for transparency.

Bot Detection (Inside Cockpit)

See a compact snapshot of crawler behavior:

Detected Bot Visits

• Total number of bot visits

Distinct Bot Types

• Unique crawlers identified

Top Crawling Bot

• Most active crawler

Recent Bot Visits Table

• Latest 50 visits displayed

A button opens the full bot log for deeper review.

Reports — Exports & Alignment

From this tab, export your Content Report as CSV or JSON, or jump straight to the full AI Reporting page.

The cards here repeat:

• Optimized Pages
• Schema Pages

This keeps numbers aligned with your main reporting dashboard.

Where Numbers Come From (High Level)

Cockpit pulls its core counts (optimized/pages with schema/total) from the same source as AI Reporting, and bot metrics from Bot Detection, which is why the figures always match.

If you’re curious, the “How it’s calculated” links open a human-readable help page—no code needed.

Typical Workflow This Page Enables

1. Glance at the Overview

• Check coverage, last task, and the queue

2. Trigger an Action

• Scan / generate / run now after content updates

3. Toggle Modules

• Match your goals (automation, enrichment, reporting)

4. Review Activity

• Confirm outcomes and timing

5. Export Reports

• Open the full dashboard when you need deep dives

Access

Cockpit AI appears under the AISEOmatic AI menu for users with standard editorial/admin capabilities, designed to be helpful without exposing sensitive internals.

Support

For questions or assistance: Email: contact@aiseomatic.com

AISEOmatic Cockpit AI Guide

Last Updated: December 13, 2025

The post AISEOmatic Cockpit AI — KPIs, Actions & Quick Reports appeared first on AISEOmatic.

Master the debug tools to monitor system health, troubleshoot issues, manage scheduled tasks, and optimize AISEOmatic AI’s performance.

This comprehensive guide covers the debug dashboard, live health monitoring, scheduled task management, diagnostic tools, log analysis, performance profiling, and troubleshooting utilities.

Table of Contents

1. Debug Dashboard Overview
2. Live System Health
3. Scheduled Tasks & Cron Jobs
4. Debug Logging
5. Performance Profiling
6. Diagnostic Tools
7. Error Tracking
8. Cache Management
9. Database Health
10. Troubleshooting Utilities

1. Debug Dashboard Overview

What is the Debug Dashboard?

The Debug Dashboard is your technical command center for monitoring, diagnosing, and troubleshooting AISEOmatic AI.

Purpose:

• Monitor system health in real-time
• Identify and fix issues
• Optimize performance
• Track resource usage
• Manage maintenance tasks

Access Location

WordPress Admin Panel
└── AISEOmatic AI
    └── Debug Tools (tab)

Admin Bar Quick Access:
└── Top Admin Bar
    └── AISEOmatic
        └── System Health

Pro Features:
└── Advanced debugging
└── Performance profiling
└── Extended logging

Dashboard Layout

┌─────────────────────────────────────────────────────────┐
│  🔧 AISEOmatic Debug & System Health                    │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  System Status: ✅ All Systems Operational              │
│  Last Check: 2 minutes ago                              │
│  Plugin Version: 1.0.0                                  │
│  WordPress: 6.4.2 | PHP: 8.1.12 | MySQL: 8.0.31        │
│                                                         │
│  ┌───────────────────────────────────────────────────┐ │
│  │  🟢 Live Health Indicators                        │ │
│  ├───────────────────────────────────────────────────┤ │
│  │  Core Plugin:        ✅ Operational                │ │
│  │  Database:           ✅ Connected                  │ │
│  │  API Endpoints:      ✅ Responding                 │ │
│  │  Cron System:        ✅ Running                    │ │
│  │  Cache System:       ✅ Active                     │ │
│  │  File System:        ✅ Writable                   │ │
│  │  OpenAI (Optional):  ⚠ Not configured             │ │
│  └───────────────────────────────────────────────────┘ │
│                                                         │
│  ┌───────────────────────────────────────────────────┐ │
│  │  ⚡ Performance Metrics                           │ │
│  ├───────────────────────────────────────────────────┤ │
│  │  Memory Usage:    87 MB / 256 MB (34%)            │ │
│  │  ━━━━━━━━━░░░░░░░░░░░░░░░                        │ │
│  │                                                    │ │
│  │  CPU Usage:       12% (Normal)                    │ │
│  │  Response Time:   187ms (Good)                    │ │
│  │  Active Queries:  3                               │ │
│  │  Cache Hit Rate:  87%                             │ │
│  └───────────────────────────────────────────────────┘ │
│                                                         │
│  ┌───────────────────────────────────────────────────┐ │
│  │  📅 Scheduled Tasks Status                        │ │
│  ├───────────────────────────────────────────────────┤ │
│  │  Next: Sitemap regeneration in 23 minutes         │ │
│  │  Queue: 3 tasks pending                           │ │
│  │  Last Run: Score recalculation (12 minutes ago)   │ │
│  │  [View All Schedules]                             │ │
│  └───────────────────────────────────────────────────┘ │
│                                                         │
│  [View Logs] [Run Diagnostics] [Clear Caches]         │
│                                                         │
└─────────────────────────────────────────────────────────┘

2. Live System Health

Health Check Components

Real-Time Monitoring:

┌─────────────────────────────────────────┐
│  System Health Status                   │
├─────────────────────────────────────────┤
│                                         │
│  🟢 Core Systems                        │
│  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  │
│                                         │
│  Plugin Status:                         │
│  ├─ Version: 1.0.0 ✅                   │
│  ├─ Database: Connected ✅              │
│  ├─ Tables: All present ✅              │
│  ├─ Settings: Valid ✅                  │
│  └─ License: Active (Pro) ✅            │
│                                         │
│  WordPress Environment:                 │
│  ├─ Version: 6.4.2 ✅ (Latest)          │
│  ├─ PHP: 8.1.12 ✅ (Recommended)        │
│  ├─ MySQL: 8.0.31 ✅                    │
│  ├─ Memory Limit: 256M ✅               │
│  └─ Max Execution: 300s ✅              │
│                                         │
│  File System:                           │
│  ├─ Plugin Dir: Writable ✅             │
│  ├─ Uploads Dir: Writable ✅            │
│  ├─ Output Dir: Writable ✅             │
│  └─ Permissions: Correct ✅             │
│                                         │
│  Network Connectivity:                  │
│  ├─ Outbound HTTPS: Working ✅          │
│  ├─ DNS Resolution: Working ✅          │
│  ├─ API Endpoints: Accessible ✅        │
│  └─ Firewall: Configured ✅             │
│                                         │
└─────────────────────────────────────────┘

┌─────────────────────────────────────────┐
│  ⚠ Warnings & Recommendations          │
├─────────────────────────────────────────┤
│                                         │
│  ⚠ OpenAI API Key not configured       │
│  Impact: AI summaries disabled          │
│  Action: Add key to enable summaries    │
│  Priority: Low (Optional feature)       │
│                                         │
│  ⚠ Cache hit rate below 90%            │
│  Impact: Slightly slower performance    │
│  Action: Consider optimizing queries    │
│  Priority: Low (Performance tweak)      │
│                                         │
│  [View All Recommendations]             │
│                                         │
└─────────────────────────────────────────┘

Critical Issues Detection

┌─────────────────────────────────────────┐
│  🔴 Critical Issues (If Any)            │
├─────────────────────────────────────────┤
│                                         │
│  ❌ Database Connection Failed          │
│  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  │
│  Detected: 5 minutes ago                │
│  Impact: Plugin non-functional          │
│  Error: Can't connect to MySQL          │
│                                         │
│  Troubleshooting Steps:                 │
│  1. Check database credentials          │
│  2. Verify MySQL service running        │
│  3. Check firewall rules                │
│  4. Review error logs                   │
│                                         │
│  [View Error Details]                   │
│  [Run Auto-Repair]                      │
│  [Contact Support]                      │
│                                         │
└─────────────────────────────────────────┘

Resource Monitoring

┌─────────────────────────────────────────┐
│  Resource Usage (Real-Time)             │
├─────────────────────────────────────────┤
│                                         │
│  Memory Usage:                          │
│  Current: 87 MB / 256 MB (34%)          │
│  ━━━━━━━━━░░░░░░░░░░░░░░              │
│  Peak: 124 MB                           │
│  Average: 93 MB                         │
│  Status: ✅ Normal                      │
│                                         │
│  CPU Usage (Last 5 min):                │
│  Current: 12%                           │
│  ▓▓▓░░░░░░░░░░░░░░░░░░░░               │
│  Peak: 34%                              │
│  Average: 15%                           │
│  Status: ✅ Normal                      │
│                                         │
│  Database Queries:                      │
│  Active: 3 queries                      │
│  Queued: 0 queries                      │
│  Avg Time: 12ms                         │
│  Slowest: 45ms (acceptable)             │
│  Status: ✅ Optimal                     │
│                                         │
│  Disk I/O:                              │
│  Read: 234 KB/s                         │
│  Write: 87 KB/s                         │
│  Wait Time: 2ms                         │
│  Status: ✅ Good                        │
│                                         │
└─────────────────────────────────────────┘

3. Scheduled Tasks & Cron Jobs

Cron System Overview

┌─────────────────────────────────────────┐
│  Scheduled Tasks Management             │
├─────────────────────────────────────────┤
│                                         │
│  WordPress Cron: ✅ Active              │
│  System Cron: ⚠ Recommended (optional) │
│  Last Execution: 12 minutes ago         │
│  Next Execution: 23 minutes             │
│                                         │
│  Active Schedules:                      │
│  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  │
│                                         │
│  Task Name              Frequency  Next │
│  ─────────────────────────────────────  │
│  Sitemap Regen          Hourly    23m  │
│  Score Recalculation    Daily     11h  │
│  Bot Log Cleanup        Weekly    3d   │
│  Cache Purge            6 Hours   2h   │
│  Health Check           15 Min    8m   │
│  Database Optimization  Weekly    5d   │
│                                         │
│  [View Full Schedule]                   │
│  [Add Custom Task]                      │
│  [Run Task Now]                         │
│                                         │
└─────────────────────────────────────────┘

Individual Task Details

┌─────────────────────────────────────────┐
│  Task: AI Sitemap Regeneration          │
├─────────────────────────────────────────┤
│                                         │
│  Status: ✅ Active                      │
│  Schedule: Every hour                   │
│  Next Run: In 23 minutes                │
│  Last Run: 37 minutes ago (Success)     │
│                                         │
│  Execution History:                     │
│  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  │
│  2025-12-13 10:23 ✅ Success (2.3s)    │
│  2025-12-13 09:23 ✅ Success (2.1s)    │
│  2025-12-13 08:23 ✅ Success (2.5s)    │
│  2025-12-13 07:23 ✅ Success (2.2s)    │
│  2025-12-13 06:23 ✅ Success (2.4s)    │
│                                         │
│  Performance:                           │
│  Avg Duration: 2.3 seconds              │
│  Success Rate: 100% (30 days)           │
│  Resource Usage: Low                    │
│                                         │
│  Configuration:                         │
│  Priority: High                         │
│  Timeout: 60 seconds                    │
│  Retry on Fail: Yes (3 attempts)        │
│                                         │
│  [Run Now] [Disable] [Edit Schedule]    │
│                                         │
└─────────────────────────────────────────┘

Custom Schedule Creation

┌─────────────────────────────────────────┐
│  Create Custom Scheduled Task           │
├─────────────────────────────────────────┤
│                                         │
│  Task Name:                             │
│  [Custom Optimization Task     ]        │
│                                         │
│  Action:                                │
│  [Recalculate Scores ▼]                │
│  • Recalculate AI Scores                │
│  • Regenerate Sitemaps                  │
│  • Clear Specific Cache                 │
│  • Database Cleanup                     │
│  • Custom Hook                          │
│                                         │
│  Schedule:                              │
│  ● Interval                             │
│  ○ Specific Time                        │
│  ○ Cron Expression                      │
│                                         │
│  Frequency: [Every 6 Hours ▼]           │
│  • Every 15 minutes                     │
│  • Hourly                               │
│  • Every 6 hours                        │
│  • Daily                                │
│  • Weekly                               │
│  • Monthly                              │
│                                         │
│  Target:                                │
│  ☑ All posts                            │
│  ☐ Specific post types                  │
│  ☐ Posts with score < 70                │
│  ☐ Posts older than 30 days             │
│                                         │
│  [Create Task] [Cancel]                 │
│                                         │
└─────────────────────────────────────────┘

4. Debug Logging

Log Viewer

┌─────────────────────────────────────────────────────────┐
│  Debug Logs                                             │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  Level: [All ▼]  Category: [All ▼]  Date: [Today ▼]    │
│                                                         │
│  Timestamp          Level  Category     Message         │
│  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  │
│  2025-12-13 11:47  INFO   Core         Plugin init     │
│  2025-12-13 11:47  DEBUG  Sitemap      Generated XML   │
│  2025-12-13 11:46  INFO   Score        Calculated P123 │
│  2025-12-13 11:45  WARNING Cache       Low hit rate    │
│  2025-12-13 11:44  INFO   Bot          GPTBot detected │
│  2025-12-13 11:43  DEBUG  API          OpenAI called   │
│  2025-12-13 11:42  ERROR  Database     Slow query 230ms│
│  2025-12-13 11:41  INFO   Cron         Hourly task run │
│  2025-12-13 11:40  DEBUG  Cache        Cleared old data│
│  2025-12-13 11:39  INFO   Core         Settings saved  │
│                                                         │
│  Showing 1-10 of 1,247 entries                          │
│  [Previous] [1] [2] [3] ... [125] [Next]                │
│                                                         │
│  [Export Logs] [Clear Old Logs] [Download All]          │
│                                                         │
└─────────────────────────────────────────────────────────┘

Log Levels & Categories

Log Levels:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔴 ERROR   - Critical issues requiring attention
⚠ WARNING - Potential problems, not critical
ℹ INFO    - General operational information
🔍 DEBUG   - Detailed diagnostic information

Categories:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Core        - Plugin initialization, settings
Sitemap     - AI Sitemap generation
Score       - AI Score calculations
Bot         - Bot detection & logging
Cache       - Caching operations
Database    - Database queries & optimization
API         - External API calls (OpenAI, etc.)
Cron        - Scheduled task execution
Optimization- Content optimization processes
Error       - Error handling & recovery

Log Configuration

┌─────────────────────────────────────────┐
│  Debug Logging Settings                 │
├─────────────────────────────────────────┤
│                                         │
│  ☑ Enable debug logging                │
│                                         │
│  Log Level:                             │
│  ● INFO and above (Recommended)         │
│  ○ WARNING and above                    │
│  ○ ERROR only                           │
│  ○ DEBUG (Verbose - for developers)     │
│                                         │
│  Log Categories:                        │
│  ☑ Core operations                      │
│  ☑ Database queries                     │
│  ☑ API calls                            │
│  ☑ Cache operations                     │
│  ☐ Detailed debug (Very verbose)        │
│                                         │
│  Storage:                               │
│  Location: /wp-content/debug.log        │
│  Max Size: [10] MB                      │
│  Retention: [30] days                   │
│  Auto-cleanup: ☑ Enabled                │
│                                         │
│  Performance:                           │
│  ☐ Log slow queries (>100ms)            │
│  ☐ Log memory usage                     │
│  ☐ Profile execution time               │
│                                         │
│  [Save Settings]                        │
│                                         │
└─────────────────────────────────────────┘

5. Performance Profiling

Execution Time Tracking

┌─────────────────────────────────────────┐
│  Performance Profile (Last 100 Requests)│
├─────────────────────────────────────────┤
│                                         │
│  Average Response Time: 187ms           │
│  Median: 165ms                          │
│  95th Percentile: 340ms                 │
│  99th Percentile: 520ms                 │
│                                         │
│  Breakdown:                             │
│  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  │
│  WordPress Core:      45ms (24%)        │
│  Database Queries:    67ms (36%)        │
│  AISEOmatic Logic:    52ms (28%)        │
│  External APIs:       18ms (10%)        │
│  Other:                5ms (2%)         │
│                                         │
│  Slowest Operations:                    │
│  1. AI Score Calc:     89ms avg         │
│  2. Sitemap Gen:       67ms avg         │
│  3. Bot Lookup:        34ms avg         │
│  4. Cache Check:       12ms avg         │
│  5. Settings Load:      8ms avg         │
│                                         │
│  [View Detailed Profile]                │
│  [Export Data]                          │
│                                         │
└─────────────────────────────────────────┘

Query Analysis

┌─────────────────────────────────────────┐
│  Database Query Performance             │
├─────────────────────────────────────────┤
│                                         │
│  Total Queries: 47 (Last page load)     │
│  Total Time: 67ms                       │
│  Average: 1.4ms per query               │
│                                         │
│  Slow Queries (>50ms):                  │
│  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  │
│                                         │
│  1. SELECT * FROM wp_aiseoai_scores     │
│     WHERE post_id IN (...)              │
│     Time: 78ms                          │
│     Rows: 150                           │
│     Solution: Add index on post_id      │
│                                         │
│  2. SELECT * FROM wp_aiseoai_bots       │
│     ORDER BY visit_time DESC            │
│     Time: 62ms                          │
│     Rows: 1000                          │
│     Solution: Limit results, add cache  │
│                                         │
│  Recommendations:                       │
│  • Add missing indexes                  │
│  • Enable query cache                   │
│  • Optimize large result sets           │
│                                         │
│  [Run Database Optimization]            │
│                                         │
└─────────────────────────────────────────┘

6. Diagnostic Tools

System Diagnostics

┌─────────────────────────────────────────┐
│  Run System Diagnostics                 │
├─────────────────────────────────────────┤
│                                         │
│  Select Tests to Run:                   │
│  ☑ Core plugin integrity                │
│  ☑ Database connectivity                │
│  ☑ File system permissions              │
│  ☑ API endpoints                        │
│  ☑ Cron system                          │
│  ☑ Cache functionality                  │
│  ☑ Plugin conflicts                     │
│  ☐ OpenAI connection (if configured)    │
│                                         │
│  [Run Diagnostics]                      │
│                                         │
│  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  │
│                                         │
│  Last Run: 2025-12-13 10:30             │
│  Results: ✅ All tests passed            │
│  Duration: 3.2 seconds                  │
│                                         │
│  [View Last Results]                    │
│  [Schedule Regular Tests]               │
│                                         │
└─────────────────────────────────────────┘

Diagnostic Results

┌─────────────────────────────────────────┐
│  Diagnostic Results                     │
├─────────────────────────────────────────┤
│                                         │
│  ✅ Core Plugin Integrity               │
│  All files present and uncorrupted      │
│  Version: 1.0.0                         │
│  Checksum: Valid                        │
│                                         │
│  ✅ Database Connectivity               │
│  Connection: Successful                 │
│  Tables: All present (4/4)              │
│  Indexes: Optimized                     │
│                                         │
│  ✅ File System Permissions             │
│  Plugin directory: Writable             │
│  Uploads directory: Writable            │
│  Cache directory: Writable              │
│                                         │
│  ✅ API Endpoints                       │
│  /wp-json/aiseoai/v1/*: Accessible      │
│  Response time: 45ms (Good)             │
│  Authentication: Working                │
│                                         │
│  ✅ Cron System                         │
│  WordPress Cron: Active                 │
│  Scheduled tasks: 6 active              │
│  Last execution: On time                │
│                                         │
│  ⚠ Cache Functionality                 │
│  Object cache: Working                  │
│  Hit rate: 83% (Below 90% target)       │
│  Recommendation: Review cache strategy  │
│                                         │
│  [Export Report] [Email to Admin]       │
│                                         │
└─────────────────────────────────────────┘

7. Error Tracking

Error Dashboard

┌─────────────────────────────────────────┐
│  Error Tracking (Last 7 Days)           │
├─────────────────────────────────────────┤
│                                         │
│  Total Errors: 12                       │
│  Critical: 0                            │
│  Warnings: 12                           │
│                                         │
│  Error Trend:                           │
│  Mon Tue Wed Thu Fri Sat Sun           │
│   3   2   1   2   1   2   1            │
│  ▓▓  ▓   ░   ▓   ░   ▓   ░            │
│                                         │
│  Recent Errors:                         │
│  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  │
│                                         │
│  2025-12-13 11:42  WARNING              │
│  Slow database query detected           │
│  Query took 230ms (threshold: 100ms)    │
│  Location: Score calculation            │
│  [View Details]                         │
│                                         │
│  2025-12-12 15:23  WARNING              │
│  Cache miss rate high                   │
│  Hit rate: 78% (target: 90%)            │
│  Location: Sitemap generation           │
│  [View Details]                         │
│                                         │
│  [View All Errors] [Clear Error Log]    │
│                                         │
└─────────────────────────────────────────┘

8. Cache Management

Cache Control Panel

┌─────────────────────────────────────────┐
│  Cache Management                       │
├─────────────────────────────────────────┤
│                                         │
│  Cache Status: ✅ Active                │
│  Hit Rate: 87% (Good)                   │
│  Total Size: 23.4 MB                    │
│  Entries: 1,247                         │
│                                         │
│  Cache Types:                           │
│  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  │
│                                         │
│  Object Cache:                          │
│  Size: 12.3 MB                          │
│  Entries: 567                           │
│  Hit Rate: 91%                          │
│  [Clear Object Cache]                   │
│                                         │
│  Transient Cache:                       │
│  Size: 8.7 MB                           │
│  Entries: 432                           │
│  Hit Rate: 85%                          │
│  [Clear Transients]                     │
│                                         │
│  Database Cache:                        │
│  Size: 2.4 MB                           │
│  Entries: 248                           │
│  Hit Rate: 82%                          │
│  [Clear DB Cache]                       │
│                                         │
│  Operations:                            │
│  [Clear All Caches]                     │
│  [Warm Up Cache]                        │
│  [View Cache Stats]                     │
│                                         │
└─────────────────────────────────────────┘

9. Database Health

Database Optimization

┌─────────────────────────────────────────┐
│  Database Health & Optimization         │
├─────────────────────────────────────────┤
│                                         │
│  Tables Status:                         │
│  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  │
│                                         │
│  wp_aiseoai_scores                      │
│  Rows: 150 | Size: 2.3 MB | ✅ Optimal │
│  Last optimized: 3 days ago             │
│  [Optimize Now]                         │
│                                         │
│  wp_aiseoai_bots                        │
│  Rows: 1,247 | Size: 5.7 MB | ✅ Good  │
│  Last optimized: 2 days ago             │
│  [Optimize Now]                         │
│                                         │
│  wp_aiseoai_cache                       │
│  Rows: 432 | Size: 1.2 MB | ⚠ Bloated │
│  Last optimized: 15 days ago            │
│  Recommendation: Clean old entries      │
│  [Optimize Now] [Clean Old Data]        │
│                                         │
│  Overall Health: ✅ Good                │
│  Total Size: 9.2 MB                     │
│  Fragmentation: Low                     │
│                                         │
│  [Optimize All Tables]                  │
│  [Schedule Auto-Optimization]           │
│                                         │
└─────────────────────────────────────────┘

10. Troubleshooting Utilities

Quick Fix Tools

┌─────────────────────────────────────────┐
│  Quick Fix Utilities                    │
├─────────────────────────────────────────┤
│                                         │
│  🔧 Common Issues                       │
│  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  │
│                                         │
│  Reset Plugin Settings                  │
│  Restore factory defaults               │
│  ⚠ Warning: All settings will be lost  │
│  [Reset Settings]                       │
│                                         │
│  Rebuild Database Tables                │
│  Recreate all AISEOmatic tables         │
│  Use if tables corrupted                │
│  [Rebuild Tables]                       │
│                                         │
│  Clear All Caches                       │
│  Remove all cached data                 │
│  Safe to run anytime                    │
│  [Clear Caches]                         │
│                                         │
│  Flush Rewrite Rules                    │
│  Fix permalink/sitemap issues           │
│  Run if sitemap not accessible          │
│  [Flush Rules]                          │
│                                         │
│  Regenerate AI Sitemap                  │
│  Force immediate sitemap rebuild        │
│  Use after bulk content changes         │
│  [Regenerate Sitemap]                   │
│                                         │
│  Recalculate All AI Scores              │
│  Recompute scores for all content       │
│  ⚠ Resource intensive                  │
│  [Recalculate Scores]                   │
│                                         │
│  Test OpenAI Connection                 │
│  Verify API key and connectivity        │
│  (Only if OpenAI configured)            │
│  [Test Connection]                      │
│                                         │
└─────────────────────────────────────────┘

System Information Export

Export System Information:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Generate comprehensive system report
for support or documentation:

Includes:
✅ Plugin version & settings
✅ WordPress environment
✅ Server configuration
✅ Active plugins list
✅ Theme information
✅ Error logs (last 100)
✅ Performance metrics
✅ Health check results

Format: [Text File ▼]
- Plain text (.txt)
- JSON (.json)
- HTML Report (.html)

Privacy: ⚠ May contain sensitive info
Review before sharing

[Generate Report]
[Generate & Download]
[Generate & Email to Support]

AISEOmatic Debug Tools Guide v1.0

Last Updated: December 13, 2025

The post AISEOmatic Debug: Live Health, Schedules & Tools appeared first on AISEOmatic.

Master the AI Experience settings to fine-tune AISEOmatic AI’s behavior, enable/disable features, and customize your optimization strategy.

This comprehensive guide covers the AI Experience dashboard, feature toggles, customization options, performance modes, and best practices for configuring AISEOmatic AI to match your specific needs.

Table of Contents

1. AI Experience Overview
2. Feature Toggle System
3. Core Features
4. Advanced Features
5. Performance Modes
6. Custom Configuration
7. Feature Dependencies
8. Compatibility Settings
9. Optimization Presets
10. Best Practices

1. AI Experience Overview

What is AI Experience?

AI Experience is AISEOmatic’s centralized feature management system that lets you customize which features are active and how they behave.

Purpose:

• Enable/disable features individually
• Optimize performance for your server
• Fine-tune behavior to your needs
• Balance automation vs. control
• Manage resource usage

Access Location

WordPress Admin Panel
└── Settings
    └── AISEOmatic AI
        └── AI Experience (tab)

Alternative Access:
└── AISEOmatic AI
    └── Dashboard
        └── Quick Settings → AI Experience

Dashboard Overview

┌─────────────────────────────────────────────────────────┐
│  ⚙ AISEOmatic AI Experience                            │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  Current Configuration: Custom                          │
│  Active Features: 18 of 31                              │
│  Performance Mode: Balanced                             │
│  Automation Level: 99.2%                                │
│                                                         │
│  ┌───────────────────────────────────────────────────┐ │
│  │  Quick Presets                                    │ │
│  ├───────────────────────────────────────────────────┤ │
│  │  [Recommended]  [Maximum]  [Minimal]  [Custom]    │ │
│  └───────────────────────────────────────────────────┘ │
│                                                         │
│  ┌───────────────────────────────────────────────────┐ │
│  │  📊 Core AI Features                              │ │
│  ├───────────────────────────────────────────────────┤ │
│  │  ☑ AI Sitemap Generation                          │ │
│  │  ☑ LLM HTML Attributes                            │ │
│  │  ☐ Schema Markup (Disabled - Yoast detected)      │ │
│  │  ☑ Bot Detection & Logging (Pro)                  │ │
│  │  ☑ AI Score Calculation (Pro)                     │ │
│  └───────────────────────────────────────────────────┘ │
│                                                         │
│  ┌───────────────────────────────────────────────────┐ │
│  │  🚀 Performance & Optimization                    │ │
│  ├───────────────────────────────────────────────────┤ │
│  │  ☑ Automatic Content Optimization                 │ │
│  │  ☑ Background Processing                          │ │
│  │  ☑ Smart Caching                                  │ │
│  │  ☐ Aggressive Mode (High resource usage)          │ │
│  └───────────────────────────────────────────────────┘ │
│                                                         │
│  ┌───────────────────────────────────────────────────┐ │
│  │  🔧 Advanced Features (Pro)                       │ │
│  ├───────────────────────────────────────────────────┤ │
│  │  ☑ AI Content Summaries (OpenAI key required)     │ │
│  │  ☑ Smart Internal Linking                         │ │
│  │  ☑ Freshness Signals                              │ │
│  │  ☑ Speakable Content Tags                         │ │
│  └───────────────────────────────────────────────────┘ │
│                                                         │
│  [Save Changes]  [Reset to Defaults]  [Test Config]    │
│                                                         │
└─────────────────────────────────────────────────────────┘

2. Feature Toggle System

How Toggles Work

Toggle States:

✅ Enabled (Active)
├─ Feature is running
├─ Processing content
├─ Consuming resources
└─ Contributing to optimization

☐ Disabled (Inactive)
├─ Feature is off
├─ Not processing content
├─ No resource usage
└─ Not affecting optimization

⚠ Auto-Disabled (Conflict Detected)
├─ Automatically disabled by AI Experience
├─ Conflict with another plugin detected
├─ Can be manually overridden
└─ Recommended to keep disabled

🔒 Locked (Pro Only)
├─ Requires Pro license
├─ Not available in Lite version
├─ Upgrade to unlock
└─ Shows feature preview

Toggle Categories

Core Features (Always Available)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ AI Sitemap
✅ LLM HTML Tags
✅ Basic optimization

Pro Features (Requires License)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔒 Bot Detection & Logging
🔒 AI Score Calculation
🔒 Advanced Analytics
🔒 AI Content Summaries
🔒 Priority Support

Optional Features (Recommended)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
☑ Schema Markup (if no conflicts)
☑ Speakable Content
☑ Smart Internal Linking
☑ Freshness Signals

Advanced Features (Power Users)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
☐ Debug Logging
☐ API Access
☐ Custom Webhooks
☐ Advanced Caching

3. Core Features

AI Sitemap

┌─────────────────────────────────────┐
│  AI Sitemap Configuration           │
├─────────────────────────────────────┤
│                                     │
│  ☑ Enable AI Sitemap                │
│                                     │
│  URL: /ai-sitemap.xml               │
│  Update Frequency: [Hourly ▼]      │
│  Max URLs: [1000]                   │
│                                     │
│  Include:                           │
│  ☑ Posts                            │
│  ☑ Pages                            │
│  ☑ Custom post types                │
│  ☐ Archives                         │
│                                     │
│  Priority Algorithm:                │
│  ● AI Score based (Recommended)     │
│  ○ Manual priority                  │
│  ○ Publish date                     │
│  ○ Modified date                    │
│                                     │
│  Exclude:                           │
│  [/admin/, /cart/, /checkout/]     │
│                                     │
│  ☑ Submit to robots.txt             │
│  ☑ Add to HTML <head>               │
│                                     │
│  [Save Sitemap Settings]            │
│                                     │
└─────────────────────────────────────┘

What It Does:

• Generates dedicated AI-optimized sitemap
• Separate from traditional XML sitemap
• Prioritizes by AI Score
• Updates automatically
• Helps AI bots discover content

Impact:

• Faster AI bot discovery
• Better crawl efficiency
• Improved indexing rate
• Higher citation chances

LLM HTML Attributes

┌─────────────────────────────────────┐
│  LLM HTML Tags Configuration        │
├─────────────────────────────────────┤
│                                     │
│  ☑ Enable data-llm attributes       │
│                                     │
│  Apply to:                          │
│  ☑ Headings (H1-H6)                 │
│  ☑ Paragraphs (>100 words)          │
│  ☑ Lists (UL, OL)                   │
│  ☑ Tables                           │
│  ☐ Images (data-llm-caption)        │
│                                     │
│  Attribute Style:                   │
│  ● Semantic (data-llm="heading")    │
│  ○ Minimal (data-llm)               │
│  ○ Verbose (data-llm-type="h2")     │
│                                     │
│  Minimum Element Length:            │
│  Headings: [5] words                │
│  Paragraphs: [50] words             │
│                                     │
│  ☑ Add importance markers           │
│  ☑ Mark key sections                │
│  ☐ Add readability hints            │
│                                     │
│  [Save LLM Settings]                │
│                                     │
└─────────────────────────────────────┘

What It Does:

• Adds invisible markers to HTML
• Helps AI understand structure
• Improves content parsing
• Enhances comprehension

Impact:

• Better AI understanding (+10-15% comprehension)
• More accurate citations
• Improved quotability
• Higher AI Score

Schema Markup

┌─────────────────────────────────────┐
│  Schema Markup Configuration        │
├─────────────────────────────────────┤
│                                     │
│  ⚠ Auto-Disabled - Yoast SEO Found │
│                                     │
│  Status: Conflict detected          │
│  Recommendation: Keep disabled      │
│                                     │
│  [Override Conflict Warning]        │
│                                     │
│  If Enabled:                        │
│  ─────────────────────────────────  │
│  Schema Types:                      │
│  ☐ Organization                     │
│  ☐ WebSite                          │
│  ☐ Article                          │
│  ☐ Product (WooCommerce)            │
│  ☐ Local Business                   │
│                                     │
│  Output Format:                     │
│  ● JSON-LD (Recommended)            │
│  ○ Microdata                        │
│                                     │
│  Location:                          │
│  ● <head> (Recommended)             │
│  ○ Footer                           │
│                                     │
│  ℹ Note: Only enable if no other   │
│     plugin handles schema markup    │
│                                     │
└─────────────────────────────────────┘

What It Does:

• Adds structured data
• Defines content entities
• Enhances search results
• Enables rich snippets

Impact:

• Rich search results
• Better AI context
• Enhanced knowledge graph
• May conflict with SEO plugins

4. Advanced Features

AI Score Calculation (Pro)

┌─────────────────────────────────────┐
│  AI Score Configuration             │
├─────────────────────────────────────┤
│                                     │
│  ☑ Enable AI Score calculation      │
│                                     │
│  Calculation Frequency:             │
│  ● On publish/update (Recommended)  │
│  ○ Hourly batch                     │
│  ○ Daily batch                      │
│  ○ Manual only                      │
│                                     │
│  Score Weights:                     │
│  Structure: [30]%                   │
│  Markup: [25]%                      │
│  Schema: [20]%                      │
│  Quality: [15]%                     │
│  Freshness: [10]%                   │
│  ─────────────                      │
│  Total: 100% ✅                     │
│                                     │
│  Display:                           │
│  ☑ In post editor                   │
│  ☑ In post list                     │
│  ☑ On dashboard                     │
│  ☐ On frontend (for admins)         │
│                                     │
│  Threshold Alerts:                  │
│  ☑ Alert if score < 60              │
│  ☑ Recommend actions for < 80       │
│                                     │
│  [Save Score Settings]              │
│                                     │
└─────────────────────────────────────┘

Bot Detection & Logging (Pro)

┌─────────────────────────────────────┐
│  Bot Detection Configuration        │
├─────────────────────────────────────┤
│                                     │
│  ☑ Enable bot detection             │
│                                     │
│  Detection Methods:                 │
│  ☑ User agent analysis              │
│  ☑ IP verification                  │
│  ☑ Reverse DNS lookup               │
│  ☑ Behavioral analysis              │
│                                     │
│  Log Settings:                      │
│  Max entries: [1000]                │
│  Retention: [90] days               │
│  Auto-cleanup: ☑ Enabled            │
│                                     │
│  Track:                             │
│  ☑ AI bots (GPTBot, Claude, etc.)   │
│  ☑ Traditional bots (Google, Bing)  │
│  ☐ Social media bots                │
│  ☐ Unknown bots                     │
│                                     │
│  Real-Time Monitoring:              │
│  ☑ Live activity counter            │
│  ☑ Dashboard widget                 │
│  ☑ Email alerts (new AI bots)       │
│                                     │
│  [Save Bot Settings]                │
│                                     │
└─────────────────────────────────────┘

AI Content Summaries (Pro + OpenAI)

┌─────────────────────────────────────┐
│  AI Summary Configuration           │
├─────────────────────────────────────┤
│                                     │
│  Status: ⚠ OpenAI key required     │
│                                     │
│  [Connect OpenAI API Key]           │
│                                     │
│  When Enabled:                      │
│  ─────────────────────────────────  │
│  Auto-generate:                     │
│  ☐ On new post publish              │
│  ☐ On post update                   │
│  ☐ Manual only                      │
│                                     │
│  Summary Style:                     │
│  ○ Standard (150-200 words)         │
│  ○ Concise (50-100 words)           │
│  ○ Detailed (250-300 words)         │
│                                     │
│  Apply to:                          │
│  ☐ Posts                            │
│  ☐ Pages                            │
│  ☐ Products                         │
│                                     │
│  Min content length: [500] words    │
│                                     │
│  ℹ Estimated cost: ~$0.03/summary  │
│                                     │
└─────────────────────────────────────┘

5. Performance Modes

Preset Configurations

┌─────────────────────────────────────────────────────────┐
│  Performance Mode Selection                             │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  ● Recommended (Default)                                │
│  ─────────────────────────────────────────────────────  │
│  Best balance of features and performance               │
│  Automation: 99.2%                                      │
│  Resource Usage: Moderate                               │
│  Optimization Speed: Normal                             │
│                                                         │
│  Features Enabled:                                      │
│  ✅ AI Sitemap, LLM Tags, Bot Detection                 │
│  ✅ AI Score, Smart Caching                             │
│  ✅ Auto-optimization on publish                        │
│  ❌ Aggressive processing                               │
│  ❌ Real-time everything                                │
│                                                         │
│  Best For: Most users (95% of sites)                    │
│  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  │
│                                                         │
│  ○ Maximum Performance                                  │
│  ─────────────────────────────────────────────────────  │
│  All features enabled, aggressive optimization          │
│  Automation: 99.9%                                      │
│  Resource Usage: High                                   │
│  Optimization Speed: Fastest                            │
│                                                         │
│  Features Enabled:                                      │
│  ✅ Everything in Recommended                           │
│  ✅ Real-time score updates                             │
│  ✅ Aggressive caching                                  │
│  ✅ Parallel processing                                 │
│  ✅ Background optimization                             │
│                                                         │
│  Best For: High-end servers, enterprise sites           │
│  Requires: VPS/dedicated hosting, 512MB+ RAM            │
│  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  │
│                                                         │
│  ○ Minimal (Resource Saving)                            │
│  ─────────────────────────────────────────────────────  │
│  Essential features only, low resource usage            │
│  Automation: 85%                                        │
│  Resource Usage: Low                                    │
│  Optimization Speed: Slow                               │
│                                                         │
│  Features Enabled:                                      │
│  ✅ AI Sitemap only                                     │
│  ✅ Basic LLM tags                                      │
│  ❌ Bot detection disabled                              │
│  ❌ AI Score disabled                                   │
│  ❌ Auto-processing limited                             │
│                                                         │
│  Best For: Shared hosting, limited resources            │
│  Requires: Budget hosting OK                            │
│  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  │
│                                                         │
│  ○ Custom                                               │
│  ─────────────────────────────────────────────────────  │
│  Manually configure each feature                        │
│  For advanced users who know their needs                │
│                                                         │
│  [Apply Mode] [Customize Settings]                      │
│                                                         │
└─────────────────────────────────────────────────────────┘

6. Custom Configuration

Fine-Tuning Options

┌─────────────────────────────────────┐
│  Advanced Configuration             │
├─────────────────────────────────────┤
│                                     │
│  Processing:                        │
│  Batch size: [50] posts             │
│  Delay between: [2] seconds         │
│  Max concurrent: [3] processes      │
│                                     │
│  Caching:                           │
│  AI Sitemap TTL: [3600] seconds     │
│  Score cache: [1800] seconds        │
│  Bot data: [300] seconds            │
│                                     │
│  Thresholds:                        │
│  Min word count: [300] words        │
│  Max processing time: [30] seconds  │
│  Score recalc trigger: [Major edit] │
│                                     │
│  Automation:                        │
│  ☑ Auto-optimize on publish         │
│  ☑ Auto-optimize on update          │
│  ☐ Auto-optimize on schedule        │
│                                     │
│  Debug:                             │
│  ☐ Enable debug logging             │
│  ☐ Log API calls                    │
│  ☐ Track performance                │
│                                     │
│  [Save Advanced Config]             │
│                                     │
└─────────────────────────────────────┘

7. Feature Dependencies

Dependency Map

Feature Dependencies
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

AI Score Calculation
├─ Requires: Core plugin active
├─ Depends on: LLM Tags (optional)
├─ Depends on: Schema (optional)
├─ Enhances: Bot Detection
└─ Conflicts: None

AI Content Summaries
├─ Requires: Pro license
├─ Requires: OpenAI API key
├─ Depends on: AI Score (recommended)
├─ Enhances: AI Score (+5-10 points)
└─ Conflicts: None

Schema Markup
├─ Requires: Core plugin active
├─ Depends on: None
├─ Enhances: AI Score
└─ Conflicts: Yoast SEO, Rank Math, AIOSEO

Bot Detection
├─ Requires: Pro license
├─ Depends on: AI Sitemap (recommended)
├─ Enhances: Analytics, Insights
└─ Conflicts: None

Smart Internal Linking
├─ Requires: Pro license
├─ Depends on: AI Score
├─ Depends on: Content analysis
├─ Enhances: AI Score, SEO
└─ Conflicts: Some linking plugins

8. Compatibility Settings

Plugin Compatibility

┌─────────────────────────────────────┐
│  Compatibility Configuration        │
├─────────────────────────────────────┤
│                                     │
│  Detected Plugins:                  │
│  ✅ Yoast SEO - Compatible          │
│  ✅ WooCommerce - Compatible        │
│  ✅ Elementor - Compatible          │
│  ⚠ W3 Total Cache - Action needed  │
│                                     │
│  Auto-Adjustments:                  │
│  ☑ Disable schema (Yoast active)    │
│  ☑ Enable WooCommerce Safe Lanes    │
│  ☑ Exclude REST API from cache      │
│  ☑ Whitelist /wp-json/aiseoai/*     │
│                                     │
│  Manual Exclusions:                 │
│  Cache exclusions:                  │
│  [/wp-json/aiseoai/*]              │
│  [/ai-sitemap.xml]                 │
│                                     │
│  Page builder compatibility:        │
│  ☑ Elementor optimization safe      │
│  ☑ Divi builder compatible          │
│  ☑ Beaver Builder ready             │
│                                     │
│  [Test Compatibility]               │
│  [View Conflict Report]             │
│                                     │
└─────────────────────────────────────┘

9. Optimization Presets

Quick Start Templates

Preset: Blogger / Content Creator
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ AI Sitemap (High priority on new posts)
✅ LLM HTML Tags (All content)
✅ AI Score (Focus on readability)
✅ Bot Detection (Track engagement)
✅ Auto-summaries (If OpenAI connected)
❌ Schema (Use Yoast/Rank Math instead)
❌ WooCommerce features

Automation: 99.5%
Focus: Content quality, AI discoverability
Best for: Blogs, news sites, media

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Preset: E-Commerce Store
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ AI Sitemap (Product priority)
✅ LLM HTML Tags (Products + guides)
✅ Product Schema (If no conflicts)
✅ WooCommerce Safe Lanes (Critical!)
✅ Bot Detection (Monitor competitors)
✅ AI Score (Product descriptions)
❌ Auto-summaries (Too costly at scale)

Automation: 99.8%
Focus: Products, checkout protection
Best for: WooCommerce, online stores

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Preset: Local Business
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ AI Sitemap (Location pages priority)
✅ LLM HTML Tags (Services, locations)
✅ Local Business Schema
✅ AI Score (Local relevance weight)
✅ Bot Detection (Track local searches)
✅ Geo-targeting optimization
❌ Advanced analytics (Overkill)

Automation: 98%
Focus: Local SEO, "near me" searches
Best for: Local services, brick & mortar

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Preset: Agency / Multi-Site
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ All core features enabled
✅ Centralized reporting
✅ White-label options
✅ Bulk operations
✅ API access for automation
✅ Custom branding
✅ Client-specific presets

Automation: 99.9%
Focus: Scalability, reporting, branding
Best for: Agencies, large portfolios

10. Best Practices

Configuration Tips

For Best Results:

✅ DO:
├─ Start with "Recommended" preset
├─ Enable features gradually
├─ Monitor performance impact
├─ Test after major changes
├─ Keep OpenAI integration optional
├─ Respect plugin conflicts
├─ Regular backup before changes
└─ Check compatibility reports

❌ DON'T:
├─ Enable everything at once
├─ Ignore conflict warnings
├─ Override compatibility settings
├─ Disable core features without reason
├─ Change modes too frequently
├─ Skip testing after changes
├─ Forget to save settings
└─ Ignore performance warnings

Troubleshooting Feature Issues

Feature Not Working?
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

1. Check if enabled in AI Experience
2. Verify no conflicts detected
3. Clear all caches
4. Check server resources
5. Review error logs
6. Test in isolated environment
7. Contact support if persists

Feature Causing Issues?
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

1. Disable temporarily
2. Monitor if issue resolves
3. Re-enable individually
4. Identify culprit
5. Adjust settings or keep disabled
6. Report bug to support

AISEOmatic AI Experience Guide v1.0

Last Updated: December 13, 2025

The post AISEOmatic AI Experience — Feature Toggles & Overview appeared first on AISEOmatic.

AISEOmatic AI Insights — Live KPIs, Trends & Charts

Complete Guide to Real-Time Analytics & Performance Intelligence

Master the Insights dashboard to track SEO performance, monitor AI optimization, and make data-driven decisions.

This comprehensive guide covers the Insights dashboard, real-time KPIs, trend analysis, visual analytics, performance tracking, and actionable intelligence for optimizing your AI-first SEO strategy.

Table of Contents

1. Insights Dashboard Overview
2. Live KPIs & Metrics
3. Trend Analysis
4. Visual Charts & Graphs
5. Performance Tracking
6. Comparative Analytics
7. Custom Reports
8. Data Interpretation
9. Actionable Insights
10. Export & Sharing

1. Insights Dashboard Overview

What is the Insights Dashboard?

The Insights dashboard is your central command center for AI-first SEO analytics.

Purpose:

• Monitor real-time SEO performance
• Track AI optimization progress
• Identify optimization opportunities
• Spot performance issues early
• Make data-driven decisions

Dashboard Access

WordPress Admin Panel
└── AISEOmatic AI
    └── Insights (tab)

Quick Access Widget:
└── Dashboard
    └── AISEOmatic AI Insights Widget

Dashboard Layout

┌─────────────────────────────────────────────────────────────┐
│  📊 AISEOmatic AI Insights Dashboard                        │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  ┌──────────────────────────────────────────────────────┐  │
│  │  🎯 Live Performance Overview                        │  │
│  ├──────────────────────────────────────────────────────┤  │
│  │                                                       │  │
│  │  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────┐│  │
│  │  │ AI Score │  │ Optimized│  │ Bot Visits│  │Trend ││  │
│  │  │   85     │  │  97%     │  │   1,234   │  │ ↗+7% ││  │
│  │  │  /100    │  │ 145/150  │  │  30 days  │  │      ││  │
│  │  └──────────┘  └──────────┘  └──────────┘  └──────┘│  │
│  │                                                       │  │
│  └──────────────────────────────────────────────────────┘  │
│                                                             │
│  ┌──────────────────────────────────────────────────────┐  │
│  │  📈 AI Score Trend (90 Days)                         │  │
│  │  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  │  │
│  │  100│                                     ╱──        │  │
│  │   90│                               ╱────╯           │  │
│  │   80│                         ╱────╯                 │  │
│  │   70│                   ╱────╯                       │  │
│  │   60│             ╱────╯                             │  │
│  │   50│       ╱────╯                                   │  │
│  │     └────────────────────────────────────────────    │  │
│  │      Sep    Oct    Nov    Dec                        │  │
│  └──────────────────────────────────────────────────────┘  │
│                                                             │
│  ┌──────────────────────────────────────────────────────┐  │
│  │  🤖 Bot Activity Distribution                        │  │
│  │  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  │  │
│  │  AI Bots (45%)        Traditional (55%)             │  │
│  │  ████████████░░░░░░░  ██████████████░░              │  │
│  │                                                       │  │
│  │  Top AI Bots:         Top Traditional:               │  │
│  │  1. GPTBot: 456       1. Googlebot: 892             │  │
│  │  2. ClaudeBot: 287    2. Bingbot: 178              │  │
│  │  3. Perplexity: 234   3. DuckDuck: 45              │  │
│  └──────────────────────────────────────────────────────┘  │
│                                                             │
│  ┌──────────────────────────────────────────────────────┐  │
│  │  💡 Quick Actions & Recommendations                  │  │
│  │  • 5 posts below 60 - Urgent optimization needed    │  │
│  │  • AI bot activity up 35% - Keep publishing!        │  │
│  │  • 12 pages missing summaries - Add AI summaries    │  │
│  └──────────────────────────────────────────────────────┘  │
│                                                             │
│  [View Detailed Report] [Export Data] [Customize View]     │
│                                                             │
└─────────────────────────────────────────────────────────────┘

2. Live KPIs & Metrics

Primary KPIs

Core Performance Indicators:

1. Overall AI Score
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Current: 85/100
Previous Month: 78/100
Change: ↗ +7 points (+9%)
Target: 90+
Status: ✅ On Track

What It Measures:
├─ Site-wide AI optimization
├─ Content readiness for AI engines
├─ Average across all posts/pages
└─ Weighted by importance

Why It Matters:
→ Higher scores = More AI bot visits
→ Better citation in AI responses
→ Improved search visibility

2. Optimization Coverage
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Optimized: 145 posts
Total: 150 posts
Percentage: 97%
Previous: 92% (↗ +5%)
Target: 100%
Status: ✅ Excellent

What It Measures:
├─ Posts with AI optimization applied
├─ Coverage across all content
├─ Completeness of implementation
└─ Progress toward full optimization

Why It Matters:
→ More optimized content = Better results
→ Complete coverage essential
→ Identifies gaps

3. AI Bot Discovery
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Unique Bots: 8
Total Visits (30d): 1,234
AI Bots: 45% (↗ +12%)
New This Month: 2 bots
Target: 10+ different bots
Status: ✅ Growing

What It Measures:
├─ How many AI bots found your site
├─ Visit frequency and patterns
├─ AI vs traditional bot ratio
└─ Discovery rate trends

Why It Matters:
→ More bots = Better AI coverage
→ Validates AI-first strategy
→ Measures discoverability

4. Content Performance Index
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Avg Word Count: 1,247
Avg Readability: 68
Schema Coverage: 92%
LLM Tag Coverage: 98%
Target: All >90%
Status: ⚠ Schema needs improvement

What It Measures:
├─ Content quality metrics
├─ Technical optimization
├─ AI-ready markup coverage
└─ Overall content standards

Why It Matters:
→ Quality drives results
→ Technical foundation essential
→ Identifies improvement areas

Secondary KPIs

Supporting Metrics:

Content Distribution
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Excellent (90-100): 23 posts (15%)
Very Good (80-89): 45 posts (30%)
Good (70-79): 52 posts (35%)
Fair (60-69): 23 posts (15%)
Poor (<60): 7 posts (5%)

Goal: 50%+ in Excellent/Very Good
Current: 45%
Progress: ⚠ Needs improvement

Bot Engagement Rate
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Pages Visited: 127/150 (85%)
Avg Visits/Page: 3.2
Return Rate: 67%
New Discoveries: 12 pages this week

Goal: 95%+ coverage
Current: 85%
Progress: ✅ Good, improving

Response Quality
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Success Rate (200): 98.7%
Not Found (404): 0.8%
Server Errors: 0.5%
Avg Response Time: 187ms

Goal: >99% success
Current: 98.7%
Progress: ⚠ Minor issues

Freshness Score
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Updated Last 30d: 23 posts
Updated Last 90d: 67 posts
Stale (>365d): 12 posts
Avg Post Age: 187 days

Goal: <180 days average
Current: 187 days
Progress: ⚠ Update older content

Real-Time Counters

Live Activity Monitoring:

┌─────────────────────────────────────┐
│  🔴 Live Activity (Last 60 Minutes) │
├─────────────────────────────────────┤
│                                     │
│  Bot Visits: 23                     │
│  ├─ AI Bots: 9                      │
│  └─ Traditional: 14                 │
│                                     │
│  Pages Crawled: 17 unique           │
│  Avg Response: 178ms                │
│                                     │
│  Recent Activity:                   │
│  • GPTBot → /guide/ (2m ago)        │
│  • Googlebot → /home/ (5m ago)      │
│  • ClaudeBot → /faq/ (8m ago)       │
│  • PerplexBot → /blog/ (12m ago)    │
│                                     │
│  [View All Activity]                │
│                                     │
└─────────────────────────────────────┘

3. Trend Analysis

Score Trend Visualization

AI Score Evolution:

┌─────────────────────────────────────────┐
│  AI Score Trend Analysis                │
├─────────────────────────────────────────┤
│                                         │
│  Period: Last 90 Days                   │
│                                         │
│  100│                            ╱───   │
│   90│                       ╱───╯       │
│   80│                  ╱───╯            │
│   70│             ╱───╯                 │
│   60│        ╱───╯                      │
│   50│   ╱───╯                           │
│     └─────────────────────────────────  │
│      Sep    Oct    Nov    Dec           │
│                                         │
│  Key Milestones:                        │
│  • Sep 15: Started at 53                │
│  • Oct 20: Reached 70 (+17)             │
│  • Nov 30: Hit 80 (+10)                 │
│  • Dec 13: Now at 85 (+5)               │
│                                         │
│  Total Improvement: +32 points (60%)    │
│  Monthly Average: +10.6 points          │
│  Current Velocity: +1.6 points/week     │
│                                         │
│  Projection:                            │
│  Jan 2026: ~90 (Target achieved!)       │
│                                         │
└─────────────────────────────────────────┘

Bot Activity Trends

Crawler Engagement Over Time:

┌─────────────────────────────────────────┐
│  Bot Activity Trend (12 Weeks)          │
├─────────────────────────────────────────┤
│                                         │
│  Total Visits                           │
│  600│                          ╱──      │
│  500│                     ╱───╯         │
│  400│                ╱───╯              │
│  300│           ╱───╯                   │
│  200│      ╱───╯                        │
│  100│ ╱───╯                             │
│     └────────────────────────────────   │
│      W1  W3  W5  W7  W9  W11           │
│                                         │
│  ━━━━━ AI Bots (45%)                   │
│  - - - Traditional Bots (55%)           │
│                                         │
│  Insights:                              │
│  • AI bots growing 3x faster            │
│  • Total visits up 156% in 12 weeks     │
│  • New AI bots joining regularly        │
│  • Traditional bots stable              │
│                                         │
│  Recommendation: Keep publishing        │
│  AI-optimized content to maintain       │
│  growth momentum.                       │
│                                         │
└─────────────────────────────────────────┘

Content Performance Trends

Publishing & Optimization Patterns:

┌─────────────────────────────────────────┐
│  Content Performance Trends             │
├─────────────────────────────────────────┤
│                                         │
│  New Content Published (Last 90 Days):  │
│  30│     ▓                              │
│  25│     ▓                              │
│  20│     ▓  ▓     ▓                     │
│  15│  ▓  ▓  ▓     ▓  ▓                  │
│  10│  ▓  ▓  ▓  ▓  ▓  ▓     ▓           │
│   5│  ▓  ▓  ▓  ▓  ▓  ▓  ▓  ▓           │
│     └────────────────────────────────   │
│      Sep  Oct  Nov  Dec                 │
│                                         │
│  Total: 67 new posts                    │
│  Average: 22 posts/month                │
│  Peak: October (30 posts)               │
│                                         │
│  Optimization Rate:                     │
│  Within 24h: 95%                        │
│  Within 1 week: 100%                    │
│                                         │
│  Average AI Score of New Content:       │
│  September: 78                          │
│  October: 82                            │
│  November: 86                           │
│  December: 88 ✅ Improving!             │
│                                         │
└─────────────────────────────────────────┘

4. Visual Charts & Graphs

Score Distribution Chart

Content Quality Breakdown:

┌─────────────────────────────────────────┐
│  AI Score Distribution                  │
├─────────────────────────────────────────┤
│                                         │
│  90-100 (Excellent)    ████████ 23     │
│                                15%      │
│                                         │
│  80-89 (Very Good)     ████████████ 45 │
│                                30%      │
│                                         │
│  70-79 (Good)          ███████████████ │
│                        52          35%  │
│                                         │
│  60-69 (Fair)          ████████ 23     │
│                                15%      │
│                                         │
│  <60 (Poor)            ██ 7            │
│                             5%          │
│                                         │
│  Target Distribution:                   │
│  • 50%+ should be 80+ ⚠               │
│  • <10% should be <60 ✅               │
│                                         │
│  Action Items:                          │
│  1. Improve 45 posts from 70s to 80+   │
│  2. Urgently fix 7 posts below 60       │
│                                         │
└─────────────────────────────────────────┘

Bot Type Breakdown

Crawler Segmentation:

┌─────────────────────────────────────────┐
│  Bot Activity by Type (30 Days)         │
├─────────────────────────────────────────┤
│                                         │
│         AI Bots (45%)                   │
│    ┌────────────────────┐               │
│    │                    │               │
│    │     GPTBot         │ 456 (37%)     │
│    │     ClaudeBot      │ 287 (23%)     │
│    │     PerplexityBot  │ 234 (19%)     │
│    │     Google-Ext     │ 123 (10%)     │
│    │     Others         │ 134 (11%)     │
│    │                    │               │
│    └────────────────────┘               │
│                                         │
│      Traditional Bots (55%)             │
│    ┌────────────────────┐               │
│    │                    │               │
│    │     Googlebot      │ 892 (66%)     │
│    │     Bingbot        │ 178 (13%)     │
│    │     DuckDuckBot    │  45 ( 3%)     │
│    │     Others         │ 241 (18%)     │
│    │                    │               │
│    └────────────────────┘               │
│                                         │
│  Key Insight: AI bot share growing      │
│  from 38% to 45% in last quarter        │
│                                         │
└─────────────────────────────────────────┘

Time-Based Patterns

Peak Activity Hours:

┌─────────────────────────────────────────┐
│  Bot Activity Heatmap (24 Hours)        │
├─────────────────────────────────────────┤
│                                         │
│  Hour (UTC)    Activity Level           │
│  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  │
│  00-02         ▓░░░░░░░ Low             │
│  03-05         ▓░░░░░░░ Low             │
│  06-08         ▓▓▓░░░░░ Moderate        │
│  09-11         ▓▓▓▓▓▓░░ High            │
│  12-14         ▓▓▓▓▓▓▓▓ Very High ★     │
│  15-17         ▓▓▓▓▓▓▓░ High            │
│  18-20         ▓▓▓▓░░░░ Moderate        │
│  21-23         ▓▓░░░░░░ Low-Mod         │
│                                         │
│  Peak Activity: 12:00-14:00 UTC         │
│  Slowest: 00:00-05:00 UTC              │
│                                         │
│  💡 Recommendation:                     │
│  Publish new content between            │
│  08:00-10:00 UTC for same-day           │
│  AI bot indexing.                       │
│                                         │
└─────────────────────────────────────────┘

5. Performance Tracking

Content Type Performance

Comparative Analysis:

┌────────────────────────────────────────────────┐
│  Performance by Content Type               │
├────────────────────────────────────────────────┤
│                                                │
│  Content Type  Count  Avg Score  Bot Visits   │
│  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  │
│  Blog Posts      87      84      ↗ +2.1       │
│  Guides          12      89      ↗ +3.8       │
│  Products        28      91      ↗ +4.2       │
│  Pages           23      78      → +0.3       │
│  FAQs             8      76      ↘ -1.2       │
│                                                │
│  Best Performer: Products (91 avg)             │
│  Needs Work: FAQs (76 avg, declining)          │
│                                                │
│  Action Items:                                 │
│  1. Analyze what makes Products perform well   │
│  2. Apply same strategies to other types       │
│  3. Urgently improve FAQ structure             │
│                                                │
└────────────────────────────────────────────────┘

Page-Level Insights

Top & Bottom Performers:

┌────────────────────────────────────────────────┐
│  Top 10 Performing Pages                      │
├────────────────────────────────────────────────┤
│  Rank  Page                    Score  Visits  │
│  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  │
│  1.    WordPress Complete Guide   97    89    │
│  2.    SEO Checklist 2025         96    76    │
│  3.    AI Optimization Guide      95    67    │
│  4.    Local SEO Strategies       94    54    │
│  5.    Content Strategy 2025      92    45    │
│  6.    Technical SEO Basics       91    43    │
│  7.    Link Building Tactics      90    38    │
│  8.    Keyword Research Guide     90    35    │
│  9.    Mobile SEO Essentials      89    32    │
│  10.   Page Speed Optimization    89    30    │
│                                                │
│  Common Factors:                               │
│  ✅ 2,000+ words                               │
│  ✅ Complete schema markup                     │
│  ✅ AI summaries present                       │
│  ✅ Updated within 90 days                     │
│  ✅ Strong internal linking                    │
│                                                │
└────────────────────────────────────────────────┘

┌────────────────────────────────────────────────┐
│  Bottom 10 - Urgent Attention Needed          │
├────────────────────────────────────────────────┤
│  Rank  Page                    Score  Visits  │
│  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  │
│  141.  About Us                   42     0    │
│  142.  Contact Page               47     1    │
│  143.  Old Blog (2020)            51     0    │
│  144.  Privacy Policy             54     2    │
│  145.  Terms of Service           56     1    │
│  146.  Quick Update               58     3    │
│  147.  Short Announcement         61     2    │
│  148.  Product Launch             63     5    │
│  149.  Event Notice               65     4    │
│  150.  Newsletter Archive         67     3    │
│                                                │
│  Common Issues:                                │
│  ❌ Very short content (<300 words)            │
│  ❌ No schema markup                           │
│  ❌ Missing AI summaries                       │
│  ❌ Not updated in 1+ years                    │
│  ❌ Thin content, poor structure               │
│                                                │
│  [Bulk Optimize These Pages]                   │
│                                                │
└────────────────────────────────────────────────┘

6. Comparative Analytics

Month-over-Month Comparison

┌─────────────────────────────────────────┐
│  Monthly Performance Comparison         │
├─────────────────────────────────────────┤
│                                         │
│  Metric          Nov 2025  Dec 2025 Δ  │
│  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  │
│  AI Score          78        85   ↗+7  │
│  Optimized %       92%       97%  ↗+5% │
│  Bot Visits        987     1,234  ↗+25%│
│  AI Bot Share      38%       45%  ↗+7% │
│  New Content       25        23   ↘-2  │
│  Avg Word Count  1,189     1,247  ↗+58 │
│  Schema Coverage   87%       92%  ↗+5% │
│                                         │
│  Overall Trend: ✅ Strong Improvement   │
│                                         │
│  Highlights:                            │
│  • AI Score up 9% - Excellent!          │
│  • Bot visits up 25% - Keep it up!      │
│  • AI bot share growing - Working!      │
│                                         │
│  Areas to Watch:                        │
│  • Publish rate slightly down           │
│  • Maintain content quality gains       │
│                                         │
└─────────────────────────────────────────┘

Year-over-Year Growth

┌─────────────────────────────────────────┐
│  Annual Growth Metrics                  │
├─────────────────────────────────────────┤
│                                         │
│  Metric          Dec 2024  Dec 2025 Δ  │
│  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  │
│  Total Content      98       150  ↗+53%│
│  AI Score           N/A       85     -- │
│  Unique AI Bots      0         8     -- │
│  Total Bot Visits  645     1,234  ↗+91%│
│  Avg Response     312ms     187ms ✅-40%│
│                                         │
│  Transformation:                        │
│  Before AISEOmatic (Jan 2025):          │
│  • No AI optimization                   │
│  • Only traditional SEO                 │
│  • Limited bot diversity                │
│  • Slower site performance              │
│                                         │
│  After AISEOmatic (Dec 2025):           │
│  • Full AI-first optimization           │
│  • 99.92% automation                    │
│  • 8 different AI bots visiting         │
│  • 40% faster response times            │
│  • 91% more bot engagement              │
│                                         │
│  ROI: Exceptional ⭐⭐⭐⭐⭐            │
│                                         │
└─────────────────────────────────────────┘

7. Custom Reports

Report Builder

┌─────────────────────────────────────────┐
│  Custom Report Builder                  │
├─────────────────────────────────────────┤
│                                         │
│  Report Name:                           │
│  [Monthly Executive Summary    ]        │
│                                         │
│  Date Range:                            │
│  From: [2025-12-01]                     │
│  To:   [2025-12-31]                     │
│                                         │
│  Include Metrics:                       │
│  ☑ AI Score trends                      │
│  ☑ Bot activity                         │
│  ☑ Content performance                  │
│  ☑ Optimization progress                │
│  ☐ Technical diagnostics                │
│  ☐ Error logs                           │
│                                         │
│  Visualizations:                        │
│  ☑ Charts & graphs                      │
│  ☑ Trend lines                          │
│  ☑ Comparison tables                    │
│  ☐ Heatmaps                             │
│                                         │
│  Grouping:                              │
│  [By Content Type ▼]                    │
│  • By content type                      │
│  • By date                              │
│  • By score range                       │
│  • By bot type                          │
│                                         │
│  Export Format:                         │
│  ● PDF                                  │
│  ○ CSV                                  │
│  ○ JSON                                 │
│  ○ Excel                                │
│                                         │
│  [Generate Report] [Save Template]      │
│                                         │
└─────────────────────────────────────────┘

8. Data Interpretation

Understanding Score Changes

Score Movement Analysis:

AI Score Increased (+7 points)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Likely Causes:
✅ 23 new high-quality posts published
✅ Added AI summaries to 12 posts
✅ Improved schema coverage (+5%)
✅ Updated 15 older posts
✅ Better internal linking

Expected Impact:
→ More AI bot visits (+15-25%)
→ Better citation rates
→ Improved search visibility

Recommendations:
- Maintain publishing quality
- Continue adding AI summaries
- Update more older content

AI Score Decreased (-3 points)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Likely Causes:
⚠ Published thin content (<500 words)
⚠ Several old posts became very stale
⚠ Schema markup errors introduced
⚠ Reduced publishing frequency

Expected Impact:
→ Fewer AI bot visits
→ Lower citation rates
→ Reduced discoverability

Recommendations:
- Review recent low-quality posts
- Update stale content immediately
- Fix schema errors
- Increase publishing cadence

9. Actionable Insights

AI-Powered Recommendations

┌─────────────────────────────────────────┐
│  💡 Smart Recommendations                │
├─────────────────────────────────────────┤
│                                         │
│  Based on your data, we recommend:      │
│                                         │
│  🎯 Priority 1 (High Impact):           │
│  • Update 7 posts scoring below 60      │
│    Estimated impact: +3-5 overall score │
│    Time required: 2-3 hours             │
│    Expected ROI: High                   │
│                                         │
│  🎯 Priority 2 (Medium Impact):         │
│  • Add AI summaries to 12 posts         │
│    Estimated impact: +2-3 overall score │
│    Time required: 30 minutes            │
│    Expected ROI: Very High              │
│                                         │
│  🎯 Priority 3 (Long-term):             │
│  • Publish 4 new guides this month      │
│    Estimated impact: Maintains momentum │
│    Time required: Varies                │
│    Expected ROI: High                   │
│                                         │
│  [View Detailed Action Plan]            │
│                                         │
└─────────────────────────────────────────┘

10. Export & Sharing

Export Options

Data Export Formats:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ PDF Report (Executive summary)
✅ CSV Data (Spreadsheet analysis)
✅ JSON (API integration)
✅ Excel (Advanced analysis)

Scheduling:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ Daily email digest
✅ Weekly comprehensive report
✅ Monthly executive summary
✅ Quarterly performance review

Sharing:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ Email to stakeholders
✅ Shareable dashboard link
✅ White-label reports (Agency Pro)
✅ API access for BI tools

AISEOmatic AI Insights Guide v1.0

Last Updated: December 13, 2025

The post AISEOmatic AI Insights — Live KPIs, Trends & Charts appeared first on AISEOmatic.

Unlock advanced AI features by connecting your OpenAI API key to generate automatic content summaries and enhance AI optimization.

This comprehensive guide covers OpenAI API setup, key configuration, automatic summary generation, cost management, troubleshooting, and best practices for AI-powered content optimization.

Table of Contents

1. OpenAI Integration Overview
2. Getting Your OpenAI API Key
3. Connecting Your API Key
4. AI Summary Features
5. Configuration & Settings
6. Cost Management
7. Summary Generation Process
8. Monitoring & Analytics
9. Troubleshooting
10. Best Practices

1. OpenAI Integration Overview

What is OpenAI Integration?

OpenAI integration is an OPTIONAL Pro feature that unlocks advanced AI-powered capabilities.

Important Note:

✅ AISEOmatic AI works FULLY without OpenAI
✅ All core features available without API key
✅ 99.92% automation works independently
✅ OpenAI is OPTIONAL for advanced features only

Features Unlocked with OpenAI Key

What You Get:

1. Automatic AI Summaries
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
→ AI-generated content summaries
→ Optimized for LLM consumption
→ Automatic generation on publish/update
→ Improves AI Score (+5-10 points)
→ Enhances discoverability

2. Advanced Content Analysis
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
→ Deeper semantic understanding
→ Topic extraction
→ Entity recognition
→ Content quality insights

3. Smart Recommendations
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
→ AI-powered optimization suggestions
→ Content improvement tips
→ Internal linking recommendations
→ SEO enhancement guidance

4. Enhanced AI Readiness
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
→ Better preparation for AI engines
→ Improved citation eligibility
→ Optimized for ChatGPT, Claude, etc.
→ Higher AI bot engagement

Do You Need OpenAI Integration?

Decision Guide:

✅ YES, if you want:
├─ Automatic AI-optimized summaries
├─ Maximum AI Score (95-100 range)
├─ Advanced content insights
├─ Competitive edge in AI search
└─ Premium AI optimization

❌ NO, if you:
├─ Are satisfied with 80-90 AI Scores
├─ Want to avoid API costs
├─ Prefer manual summary creation
├─ Have budget constraints
└─ Don't need advanced features

Remember: AISEOmatic AI delivers excellent
results WITHOUT OpenAI integration!

2. Getting Your OpenAI API Key

Step 1: Create OpenAI Account

Account Setup:

1. Visit: https://platform.openai.com
2. Click: "Sign Up"
3. Provide: Email address
4. Verify: Email confirmation
5. Complete: Account setup

Step 2: Set Up Billing

Before You Can Generate an API Key:

⚠ IMPORTANT: You MUST add payment method first

1. Login to: https://platform.openai.com
2. Navigate to: Settings → Billing
3. Click: "Add payment method"
4. Enter: Credit/debit card details
5. Set: Usage limits (recommended)
6. Save: Payment information

Without billing setup, API key won't work!

Step 3: Generate API Key

Creating Your API Key:

1. Go to: https://platform.openai.com/api-keys
2. Click: "+ Create new secret key"
3. Name: "AISEOmatic AI - [Your Site]"
4. Optional: Set permissions (Full access)
5. Click: "Create secret key"
6. COPY: Key immediately (shown only once!)
7. Store: In password manager

Format: sk-proj-xxxxxxxxxxxxxxxxxxxxx
Length: 51-56 characters
Starts with: sk-proj- or sk-

CRITICAL:

⚠ Copy the key IMMEDIATELY!
⚠ It's shown ONLY ONCE
⚠ Cannot be retrieved later
⚠ Store securely

Step 4: Set Usage Limits

Recommended Safety Settings:

Billing → Usage limits

Monthly Limit:
├─ Recommended: $5-20/month
├─ Conservative: $5/month
├─ Moderate: $10/month
└─ Active: $20/month

Hard Limit: Enable
Email Alerts: Enable at 50%, 75%, 90%

Example Costs:
├─ 10 summaries/day: ~$3/month
├─ 50 summaries/day: ~$15/month
└─ 100 summaries/day: ~$30/month

3. Connecting Your API Key

Configuration Location

WordPress Admin Panel
└── Settings
    └── AISEOmatic AI
        └── OpenAI Integration (tab)

Connection Process

Step-by-Step Setup:

┌─────────────────────────────────────────┐
│  OpenAI API Integration                 │
├─────────────────────────────────────────┤
│                                         │
│  ☐ Enable OpenAI Integration            │
│                                         │
│  API Key:                               │
│  [sk-proj-xxxxxxxxxxxxxxxxxxxxx]       │
│                                         │
│  Model: [GPT-4 Turbo ▼]                │
│  Options:                               │
│  • GPT-4 Turbo (Recommended)            │
│  • GPT-4                                │
│  • GPT-3.5 Turbo (Budget)               │
│                                         │
│  [Test Connection]                      │
│                                         │
│  Status: ⚪ Not Connected               │
│                                         │
│  [Save Settings]                        │
│                                         │
└─────────────────────────────────────────┘

Testing Connection

Verification Process:

After entering API key:

1. Click "Test Connection"
   ↓
2. AISEOmatic sends test request
   ↓
3. OpenAI responds with validation
   ↓
4. Status Updates:

✅ Success:
┌─────────────────────────────────────────┐
│  Status: ✅ Connected Successfully       │
│                                         │
│  Details:                               │
│  • Model: GPT-4 Turbo                   │
│  • Latency: 234ms                       │
│  • Account: Active                      │
│  • Rate Limit: 10,000 tokens/min        │
│                                         │
│  Test Summary Generated:                │
│  "This is a test summary to verify      │
│   your OpenAI API connection is         │
│   working correctly..."                 │
│                                         │
│  ✅ Ready to generate AI summaries!     │
│                                         │
└─────────────────────────────────────────┘

❌ Failure:
┌─────────────────────────────────────────┐
│  Status: ❌ Connection Failed            │
│                                         │
│  Error: Invalid API key                 │
│                                         │
│  Possible Issues:                       │
│  • API key incorrect or expired         │
│  • No payment method on file            │
│  • Account suspended                    │
│  • Rate limit exceeded                  │
│                                         │
│  [Retry] [View Troubleshooting]         │
│                                         │
└─────────────────────────────────────────┘

4. AI Summary Features

What Are AI Summaries?

AI Summaries are concise, LLM-optimized descriptions of your content.

Purpose:

✅ Help AI engines understand content quickly
✅ Improve citation in AI responses
✅ Enhance AI Score (Freshness component)
✅ Optimize for ChatGPT, Claude, Perplexity
✅ Provide skimmable content previews

Summary Generation Types

Automatic Generation:

Triggered automatically when:
├─ New post published
├─ Existing post updated
├─ Content significantly changed
└─ Manual regeneration requested

Process:
1. Content extracted from post
2. Sent to OpenAI API
3. AI summary generated (150-200 words)
4. Saved to post meta
5. Added to HTML output
6. AI Score recalculated

Summary Quality Levels

Summary Styles:

Standard Summary (Default)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Length: 150-200 words
Style: Factual, objective
Focus: Key points, main topics
Best for: Blog posts, articles

Concise Summary
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Length: 50-100 words
Style: Brief, essential only
Focus: Core message
Best for: News, updates, short posts

Detailed Summary
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Length: 250-300 words
Style: Comprehensive
Focus: In-depth coverage
Best for: Guides, tutorials, long-form

Technical Summary
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Length: 150-250 words
Style: Technical, precise
Focus: Specs, methods, processes
Best for: Documentation, how-tos

Example AI Summary Output

Before OpenAI Integration:

No summary generated
AI Score: 85/100
Freshness component: 7/10

After OpenAI Integration:

AI Summary:
"This comprehensive guide explores WordPress SEO
best practices for 2025, covering technical
optimization, content strategy, and AI-first
indexing. Learn how to optimize for both
traditional search engines like Google and
emerging AI platforms like ChatGPT and Perplexity.
The guide includes step-by-step instructions for
implementing schema markup, improving site speed,
and creating AI-ready content. Perfect for
beginners and advanced users seeking to future-
proof their SEO strategy."

AI Score: 92/100 (↗ +7 points!)
Freshness component: 10/10 ✅

5. Configuration & Settings

Summary Generation Settings

┌─────────────────────────────────────────┐
│  AI Summary Configuration               │
├─────────────────────────────────────────┤
│                                         │
│  ☑ Enable automatic summaries           │
│                                         │
│  Generation Timing:                     │
│  ☑ On new post publish                  │
│  ☑ On post update                       │
│  ☐ On manual request only               │
│                                         │
│  Summary Style:                         │
│  ● Standard (150-200 words)             │
│  ○ Concise (50-100 words)               │
│  ○ Detailed (250-300 words)             │
│  ○ Technical                            │
│                                         │
│  Post Types:                            │
│  ☑ Posts                                │
│  ☑ Pages                                │
│  ☑ Products (WooCommerce)               │
│  ☐ Custom Post Types                    │
│                                         │
│  Minimum Content Length:                │
│  [500] words                            │
│  (Skip summaries for shorter content)   │
│                                         │
│  Language:                              │
│  [Auto-detect ▼]                        │
│  • Auto-detect from content             │
│  • English                              │
│  • French                               │
│  • Spanish                              │
│  • German                               │
│  • [30+ languages]                      │
│                                         │
│  [Save Settings]                        │
│                                         │
└─────────────────────────────────────────┘

Advanced Options

┌─────────────────────────────────────────┐
│  Advanced Summary Settings              │
├─────────────────────────────────────────┤
│                                         │
│  Model Selection:                       │
│  [GPT-4 Turbo ▼]                        │
│                                         │
│  Temperature: [0.3]                     │
│  (0 = Factual, 1 = Creative)            │
│                                         │
│  Max Tokens: [300]                      │
│  (Approx. 200-250 words)                │
│                                         │
│  Custom Prompt Template:                │
│  [Use default ▼]                        │
│  • Use default                          │
│  • Custom prompt                        │
│                                         │
│  ☐ Include keywords in summary          │
│  ☐ Add call-to-action                   │
│  ☐ Mention author/brand                 │
│                                         │
│  Retry on Failure:                      │
│  Attempts: [3]                          │
│  Delay: [5] seconds                     │
│                                         │
│  [Save Advanced Settings]               │
│                                         │
└─────────────────────────────────────────┘

6. Cost Management

Understanding OpenAI Pricing

GPT-4 Turbo Pricing (as of Dec 2025):

Input Tokens:  $10.00 per 1M tokens
Output Tokens: $30.00 per 1M tokens

Average Summary Cost:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Content Size: 1,500 words (~2,000 tokens)
Summary Size: 200 words (~300 tokens)

Cost per summary:
Input:  2,000 tokens × $10/1M = $0.020
Output:   300 tokens × $30/1M = $0.009
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Total: ~$0.029 per summary (~3 cents)

Monthly Estimates:
├─ 10 posts/month: ~$0.29
├─ 50 posts/month: ~$1.45
├─ 100 posts/month: ~$2.90
└─ 300 posts/month: ~$8.70

Cost Optimization Strategies

Reduce Costs:

1. Use GPT-3.5 Turbo (75% cheaper)
   ├─ Good quality for most content
   ├─ Cost: ~$0.007 per summary
   └─ Recommended for budget-conscious

2. Minimum Word Count Filter
   ├─ Only summarize posts >500 words
   ├─ Skip short news/updates
   └─ Saves 30-50% on API calls

3. Manual Generation Mode
   ├─ Disable automatic generation
   ├─ Generate only for key content
   └─ Maximum control over costs

4. Batch Processing
   ├─ Generate summaries in bulk
   ├─ More efficient API usage
   └─ Slight cost savings

5. Set Monthly Limits
   ├─ Hard limit: $20/month
   ├─ Email alerts at 75%
   └─ Auto-disable at limit

Budget Monitoring

┌─────────────────────────────────────────┐
│  OpenAI Usage Dashboard                 │
├─────────────────────────────────────────┤
│                                         │
│  Current Month: December 2025           │
│                                         │
│  Total Cost: $4.23 / $20.00 limit       │
│  ━━━━━━━━━━━━━━━━░░░░░░░░░ 21%         │
│                                         │
│  Summaries Generated: 147               │
│  Avg. Cost per Summary: $0.029          │
│                                         │
│  Token Usage:                           │
│  Input: 294,000 tokens                  │
│  Output: 44,100 tokens                  │
│                                         │
│  Projected Month End: $8.50             │
│  Status: ✅ Well under budget           │
│                                         │
│  [View Detailed Stats]                  │
│                                         │
└─────────────────────────────────────────┘

7. Summary Generation Process

Automatic Generation Flow

New Post Published
      ↓
┌─────────────────────────────────────┐
│  Check if OpenAI Enabled            │
│  • API key configured?              │
│  • Auto-generation enabled?         │
│  • Post type included?              │
└─────────────────────────────────────┘
      ↓
┌─────────────────────────────────────┐
│  Content Extraction                 │
│  • Get post title                   │
│  • Get post content (cleaned)       │
│  • Remove HTML tags                 │
│  • Extract key sections             │
└─────────────────────────────────────┘
      ↓
┌─────────────────────────────────────┐
│  Prepare API Request                │
│  • Build prompt                     │
│  • Set parameters                   │
│  • Add context                      │
└─────────────────────────────────────┘
      ↓
┌─────────────────────────────────────┐
│  Call OpenAI API                    │
│  • Send request                     │
│  • Wait for response (2-5 seconds)  │
│  • Handle rate limits               │
└─────────────────────────────────────┘
      ↓
┌─────────────────────────────────────┐
│  Process Response                   │
│  • Extract summary text             │
│  • Validate quality                 │
│  • Clean formatting                 │
└─────────────────────────────────────┘
      ↓
┌─────────────────────────────────────┐
│  Save Summary                       │
│  • Store in post meta               │
│  • Add to HTML output               │
│  • Update AI Score                  │
│  • Log usage stats                  │
└─────────────────────────────────────┘
      ↓
✅ Summary Added to Content

Manual Generation

Generate Summaries on Demand:

Method 1: In Post Editor
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
1. Open post in editor
2. Scroll to AISEOmatic metabox
3. Click "Generate AI Summary"
4. Wait 3-5 seconds
5. Review & save

Method 2: Bulk Actions
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
1. Go to Posts → All Posts
2. Select multiple posts
3. Bulk Actions → "Generate AI Summaries"
4. Apply
5. Processing begins in background

Method 3: Dashboard
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
1. AISEOmatic AI → Summaries
2. View posts without summaries
3. Click "Generate All" or select specific
4. Confirm action
5. Monitor progress

8. Monitoring & Analytics

Summary Performance Dashboard

┌─────────────────────────────────────────┐
│  AI Summary Analytics                   │
├─────────────────────────────────────────┤
│                                         │
│  Total Summaries: 147                   │
│  Last 30 Days: 23                       │
│  Success Rate: 98.6%                    │
│                                         │
│  Average Generation Time: 3.2 seconds   │
│  Average Summary Length: 187 words      │
│                                         │
│  Impact on AI Scores:                   │
│  Before: Avg 82/100                     │
│  After:  Avg 89/100 (↗ +7 points!)     │
│                                         │
│  Bot Engagement (Posts with Summaries): │
│  AI Bot Visits: +45% increase           │
│  Citation Rate: +38% increase           │
│                                         │
│  [View Detailed Report]                 │
│                                         │
└─────────────────────────────────────────┘

9. Troubleshooting

Common Issues & Solutions

Issue #1: API Key Not Working

Symptoms:
❌ "Invalid API key" error
❌ Connection test fails

Solutions:
1. Verify key copied correctly (no spaces)
2. Check billing method added to OpenAI account
3. Confirm account has positive balance
4. Try generating new API key
5. Check OpenAI service status

Issue #2: Summaries Not Generating

Symptoms:
⚠ No summary appears
⚠ "Generation failed" message

Possible Causes & Solutions:
→ Content too short
  ✅ Increase word count to 500+

→ Rate limit exceeded
  ✅ Wait 1 minute, retry
  ✅ Reduce generation frequency

→ API quota exhausted
  ✅ Check OpenAI billing dashboard
  ✅ Increase monthly limit

→ Post type not enabled
  ✅ Check summary settings
  ✅ Enable for specific post types

Issue #3: Poor Quality Summaries

Symptoms:
⚠ Summaries too generic
⚠ Missing key points
⚠ Incorrect information

Solutions:
1. Switch to GPT-4 Turbo (better quality)
2. Adjust temperature (try 0.2-0.4)
3. Customize prompt template
4. Ensure content is well-structured
5. Regenerate summary

10. Best Practices

Optimization Tips

Maximize Summary Value:

1. Quality Content First
   ├─ Well-structured posts (H2, H3 headers)
   ├─ Clear main points
   ├─ Proper grammar
   └─ Logical flow

2. Optimal Length
   ├─ Minimum: 500 words
   ├─ Ideal: 1,000-2,500 words
   ├─ Too short: Poor summaries
   └─ Too long: Excessive costs

3. Strategic Generation
   ├─ Prioritize high-value content
   ├─ Skip minor updates
   ├─ Regenerate for major revisions
   └─ Bulk generate older content

4. Monitor Performance
   ├─ Track AI Score improvements
   ├─ Measure bot engagement
   ├─ Review cost efficiency
   └─ Adjust settings as needed

Security Best Practices

✅ Store API key securely
✅ Never commit to version control
✅ Use environment variables if possible
✅ Rotate keys periodically
✅ Set usage limits
✅ Monitor for unusual activity
✅ Disable if compromised immediately

AISEOmatic AI — OpenAI Integration Guide v1.0

Last Updated: December 13, 2025

The post OpenAI Key — Connect & Enable Automatic AI Summaries appeared first on AISEOmatic.

AISEOmatic Bot Detection — Logs, KPIs & Exports Guide

Complete Guide to Bot Activity Monitoring & Analysis

Master bot detection, understand AI crawler behavior, and leverage bot activity data for SEO insights.

This comprehensive guide covers bot detection technology, activity logs, analytics dashboards, KPI tracking, and how to use bot data to optimize your AI-first SEO strategy.

Table of Contents

1. Bot Detection Overview
2. Supported Bot Types
3. Bot Detection Dashboard
4. Activity Logs & Monitoring
5. Bot Analytics & KPIs
6. Export Formats
7. Bot Behavior Patterns
8. Crawler Management
9. Troubleshooting & Verification
10. Advanced Bot Intelligence

1. Bot Detection Overview

What is Bot Detection?

AISEOmatic AI’s bot detection identifies and logs visits from search engine crawlers and AI system bots.

Purpose:

• Track which AI engines are discovering your content
• Measure AI-first SEO effectiveness
• Optimize content for specific AI platforms
• Monitor crawler behavior and patterns
• Verify sitemap effectiveness

How Bot Detection Works

Detection Process:

Incoming Request
      ↓
┌─────────────────────────────────────┐
│  1. User Agent Analysis             │
│  Check HTTP User-Agent string       │
└─────────────────────────────────────┘
      ↓
┌─────────────────────────────────────┐
│  2. IP Verification                 │
│  Validate against known bot ranges  │
└─────────────────────────────────────┘
      ↓
┌─────────────────────────────────────┐
│  3. Reverse DNS Lookup              │
│  Confirm bot identity               │
└─────────────────────────────────────┘
      ↓
┌─────────────────────────────────────┐
│  4. Behavioral Analysis             │
│  Check crawl patterns               │
└─────────────────────────────────────┘
      ↓
┌─────────────────────────────────────┐
│  5. Log & Classify                  │
│  Store visit data in database       │
└─────────────────────────────────────┘

Lite vs. Pro Detection

Lite Version:

✅ Basic bot detection (real-time)
✅ Live bot counter in dashboard
❌ No historical logs
❌ No detailed analytics
❌ No exports
❌ Limited to last 24 hours

Pro Version:

✅ Full bot detection & logging
✅ 1,000+ entry historical logs
✅ Detailed analytics dashboard
✅ CSV/JSON exports
✅ Bot behavior analysis
✅ Crawler ETA predictions
✅ Advanced filtering
✅ Unlimited retention

2. Supported Bot Types

AI Search Engine Bots

Actively Detected AI Crawlers:

🤖 GPTBot (OpenAI/ChatGPT)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
User Agent: GPTBot/1.0
Purpose: Content indexing for ChatGPT
Frequency: Daily to weekly
Respect: robots.txt, AI Sitemap

🤖 ClaudeBot (Anthropic/Claude)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
User Agent: ClaudeBot/1.0
Purpose: Content discovery for Claude
Frequency: 2-3 times per week
Respect: robots.txt, AI Sitemap

🤖 PerplexityBot (Perplexity AI)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
User Agent: PerplexityBot/1.0
Purpose: Real-time search indexing
Frequency: Very active (multiple daily)
Respect: robots.txt

🤖 Google-Extended (Google Bard/Gemini)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
User Agent: Google-Extended
Purpose: AI model training & responses
Frequency: Varies with Googlebot
Respect: robots.txt

🤖 Amazonbot (Amazon Alexa)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
User Agent: Amazonbot/1.0
Purpose: Alexa voice responses
Frequency: Weekly
Respect: robots.txt

🤖 Applebot-Extended (Apple Intelligence)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
User Agent: Applebot-Extended/1.0
Purpose: Apple AI services
Frequency: Moderate
Respect: robots.txt

🤖 Bytespider (TikTok)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
User Agent: Bytespider/1.0
Purpose: Content discovery
Frequency: Variable
Respect: robots.txt

🤖 Meta-ExternalAgent (Meta AI)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
User Agent: Meta-ExternalAgent/1.0
Purpose: Meta AI training
Frequency: Occasional
Respect: robots.txt

Traditional Search Bots

Classic Search Engine Crawlers:

🔍 Googlebot
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
User Agent: Googlebot/2.1
Purpose: Google Search indexing
Frequency: Very high (multiple times daily)
Priority: Critical for SEO

🔍 Bingbot
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
User Agent: bingbot/2.0
Purpose: Bing Search indexing
Frequency: Daily to weekly
Priority: Important

🔍 Yandexbot
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
User Agent: YandexBot/3.0
Purpose: Yandex Search (Russia)
Frequency: Moderate
Priority: Regional

🔍 DuckDuckBot
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
User Agent: DuckDuckBot/1.0
Purpose: DuckDuckGo indexing
Frequency: Weekly
Priority: Privacy-focused users

🔍 Baiduspider
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
User Agent: Baiduspider/2.0
Purpose: Baidu Search (China)
Frequency: Moderate
Priority: Chinese market

3. Bot Detection Dashboard

Dashboard Layout

┌─────────────────────────────────────────────────────────┐
│  🤖 AISEOmatic AI Bot Detection                         │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐    │
│  │ Total Bots  │  │ AI Crawlers │  │ Last 24h    │    │
│  │  Detected   │  │   Active    │  │  Activity   │    │
│  │             │  │             │  │             │    │
│  │    2,847    │  │     8       │  │    234      │    │
│  │  All Time   │  │  Different  │  │   Visits    │    │
│  └─────────────┘  └─────────────┘  └─────────────┘    │
│                                                         │
│  ┌───────────────────────────────────────────────────┐ │
│  │  📊 Bot Activity by Type (Last 30 Days)          │ │
│  │  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  │ │
│  │                                                   │ │
│  │  GPTBot         ████████████ 456 visits         │ │
│  │  Googlebot      █████████████████ 892 visits    │ │
│  │  ClaudeBot      ████████ 287 visits             │ │
│  │  PerplexityBot  ███████ 234 visits              │ │
│  │  Bingbot        ██████ 178 visits               │ │
│  │  Google-Ext.    ████ 123 visits                 │ │
│  │  Amazonbot      ██ 67 visits                    │ │
│  │  Other          ███ 89 visits                   │ │
│  │                                                   │ │
│  └───────────────────────────────────────────────────┘ │
│                                                         │
│  ┌───────────────────────────────────────────────────┐ │
│  │  🎯 Most Visited Pages (AI Bots)                 │ │
│  │  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  │ │
│  │  1. /wordpress-guide/        89 visits (Score:97)│ │
│  │  2. /seo-checklist/          76 visits (Score:96)│ │
│  │  3. /ai-optimization/        67 visits (Score:95)│ │
│  │  4. /local-seo-guide/        54 visits (Score:94)│ │
│  │  5. /content-strategy/       45 visits (Score:92)│ │
│  └───────────────────────────────────────────────────┘ │
│                                                         │
│  [View Full Logs] [Export CSV] [Export JSON]           │
│                                                         │
└─────────────────────────────────────────────────────────┘

Real-Time Bot Counter

Live Activity Widget:

┌─────────────────────────────────────┐
│  🔴 Live Bot Activity                │
├─────────────────────────────────────┤
│                                     │
│  Last 10 Minutes:                   │
│                                     │
│  🤖 GPTBot                          │
│     /wordpress-guide/               │
│     2 minutes ago                   │
│                                     │
│  🔍 Googlebot                       │
│     /seo-checklist/                 │
│     4 minutes ago                   │
│                                     │
│  🤖 ClaudeBot                       │
│     /ai-optimization/               │
│     7 minutes ago                   │
│                                     │
│  [View All Recent Activity]         │
│                                     │
└─────────────────────────────────────┘

4. Activity Logs & Monitoring

Bot Visit Log Table

┌──────────────────────────────────────────────────────────────────┐
│  Bot Activity Log (Last 1,000 Entries)                          │
├──────────────────────────────────────────────────────────────────┤
│ Date/Time          Bot         Page            IP          Code │
├──────────────────────────────────────────────────────────────────┤
│ 2025-12-13 10:47  GPTBot      /guide/         66.249.*.*   200 │
│ 2025-12-13 10:45  Googlebot   /home/          66.249.*.*   200 │
│ 2025-12-13 10:42  ClaudeBot   /about/         52.24.*.*    200 │
│ 2025-12-13 10:38  PerplexBot  /products/      3.16.*.*     200 │
│ 2025-12-13 10:35  Bingbot     /blog/          157.55.*.*   200 │
│ 2025-12-13 10:31  GPTBot      /faq/           66.249.*.*   200 │
│ 2025-12-13 10:28  Google-Ext  /services/      66.249.*.*   200 │
│ 2025-12-13 10:24  ClaudeBot   /contact/       52.24.*.*    200 │
│ ...                                                              │
├──────────────────────────────────────────────────────────────────┤
│ Showing 1-10 of 1,000 entries                                   │
│ [Previous] [1] [2] [3] ... [100] [Next]                        │
└──────────────────────────────────────────────────────────────────┘

[Filter] [Search] [Export] [Clear Old Logs]

Log Entry Details

Complete Log Entry Structure:

┌─────────────────────────────────────────┐
│  Bot Visit Details                      │
├─────────────────────────────────────────┤
│                                         │
│  🤖 Bot Information                     │
│  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  │
│  Name: GPTBot                           │
│  Type: AI Crawler                       │
│  Category: AI Search Engine             │
│  Owner: OpenAI                          │
│  User Agent: GPTBot/1.0 (+https://...)  │
│                                         │
│  📍 Visit Details                       │
│  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  │
│  Date/Time: 2025-12-13 10:47:23 UTC    │
│  URL: /wordpress-guide/                 │
│  Page Title: Complete WordPress Guide   │
│  AI Score: 97/100                       │
│  Response Code: 200 OK                  │
│  Response Time: 234ms                   │
│                                         │
│  🌐 Technical Details                   │
│  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  │
│  IP Address: 66.249.64.12               │
│  Reverse DNS: crawl.openai.com          │
│  Request Method: GET                    │
│  HTTP Version: HTTP/2.0                 │
│  Referrer: (Direct)                     │
│                                         │
│  📊 Context                             │
│  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  │
│  Previous Visit: 3 days ago             │
│  Total Visits: 47 (all time)            │
│  Pages Visited: 23 different pages      │
│  Avg. Crawl Interval: 2.8 days          │
│                                         │
└─────────────────────────────────────────┘

Filtering & Search

Filter Options:

┌─────────────────────────────────────┐
│  Filter Bot Logs                    │
├─────────────────────────────────────┤
│                                     │
│  Bot Type:                          │
│  ☐ All                              │
│  ☑ AI Crawlers Only                 │
│  ☐ Traditional Bots Only            │
│                                     │
│  Specific Bots:                     │
│  ☑ GPTBot                           │
│  ☑ ClaudeBot                        │
│  ☑ PerplexityBot                    │
│  ☐ Googlebot                        │
│  ☐ Bingbot                          │
│  ☐ Other                            │
│                                     │
│  Date Range:                        │
│  From: [2025-12-01]                 │
│  To:   [2025-12-13]                 │
│                                     │
│  Page/URL:                          │
│  [/wordpress-guide/      ]          │
│                                     │
│  Response Code:                     │
│  [All Codes ▼]                      │
│                                     │
│  [Apply Filters] [Reset]            │
│                                     │
└─────────────────────────────────────┘

5. Bot Analytics & KPIs

Key Performance Indicators

Primary Bot KPIs:

1. AI Bot Discovery Rate
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Current: 8 different AI bots detected
Target: 10+ (comprehensive coverage)
Trend: ↗ +2 new bots this quarter

Metric Breakdown:
├─ GPTBot: ✅ Active
├─ ClaudeBot: ✅ Active
├─ PerplexityBot: ✅ Active
├─ Google-Extended: ✅ Active
├─ Amazonbot: ✅ Active
├─ AppleBot-Extended: ⚠ Rare
├─ Bytespider: ⚠ Occasional
└─ Meta-External: ❌ Not yet detected

2. Crawl Frequency
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
AI Bots Average: 2.3 visits/week/bot
Traditional: 5.7 visits/week/bot
Combined: 456 total visits/month

By Bot:
├─ Googlebot: Daily (1.2/day)
├─ GPTBot: 2.1/week
├─ ClaudeBot: 1.8/week
├─ PerplexityBot: 3.4/week (very active!)
└─ Bingbot: 1.1/week

3. Page Coverage
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Total Pages: 150
Pages Visited by AI Bots: 127 (85%)
Never Visited: 23 (15%)
Avg. Visits per Page: 3.2

Priority Pages Coverage:
├─ High-scoring (90+): 100% ✅
├─ Medium-scoring (70-89): 87% ✅
└─ Low-scoring (<70): 45% ⚠

4. Response Quality
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Successful Crawls (200): 98.7%
Not Found (404): 0.8%
Server Errors (5xx): 0.5%
Average Response Time: 187ms

Target: >99% success rate
Status: ⚠ Minor optimization needed

Bot Activity Trends

Weekly Trend Analysis:

┌─────────────────────────────────────────┐
│  Bot Activity Trend (12 Weeks)         │
├─────────────────────────────────────────┤
│ 500│                            ╱─      │
│ 450│                       ╱───╯        │
│ 400│                  ╱───╯             │
│ 350│             ╱───╯                  │
│ 300│        ╱───╯                       │
│ 250│   ╱───╯                            │
│ 200│──╯                                 │
│    └──────────────────────────────────  │
│     W1  W3  W5  W7  W9  W11            │
│                                         │
│  Total Growth: +156% in 12 weeks       │
│  AI Bots: +234% (outpacing traditional)│
│  Conclusion: Strong AI adoption ✅      │
└─────────────────────────────────────────┘

Bot-to-Score Correlation

Correlation Analysis:

┌─────────────────────────────────────────────┐
│  AI Score vs Bot Visits                     │
├─────────────────────────────────────────────┤
│                                             │
│  Pages Score 90-100: Avg 23 bot visits/mo  │
│  Pages Score 80-89:  Avg 12 bot visits/mo  │
│  Pages Score 70-79:  Avg 7 bot visits/mo   │
│  Pages Score 60-69:  Avg 3 bot visits/mo   │
│  Pages Score <60:    Avg 1 bot visit/mo    │
│                                             │
│  Correlation Coefficient: 0.87              │
│  Conclusion: Strong positive correlation    │
│                                             │
│  💡 Insight: +10 points in AI Score =       │
│     ~8.5 additional bot visits per month    │
│                                             │
└─────────────────────────────────────────────┘

6. Export Formats

CSV Export Format

Bot Activity CSV Structure:

csv

Timestamp,Bot_Name,Bot_Type,Bot_Category,User_Agent,IP_Address,Reverse_DNS,URL,Page_Title,AI_Score,Response_Code,Response_Time_ms
2025-12-13T10:47:23Z,GPTBot,AI,OpenAI,"GPTBot/1.0",66.249.64.12,crawl.openai.com,/wordpress-guide/,"Complete WordPress Guide",97,200,234
2025-12-13T10:45:12Z,Googlebot,Traditional,Google,"Googlebot/2.1",66.249.73.15,crawl-66-249-73-15.googlebot.com,/home/,"Homepage",85,200,156
2025-12-13T10:42:08Z,ClaudeBot,AI,Anthropic,"ClaudeBot/1.0",52.24.187.93,ec2-52-24-187-93.compute-1.amazonaws.com,/about/,"About Us",78,200,198

Use Cases:

• Import to Excel/Google Sheets
• Business intelligence tools
• Custom analytics dashboards
• Historical tracking
• Client reporting

JSON Export Format

Bot Activity JSON Structure:

json

{
  "export_metadata": {
    "export_date": "2025-12-13T11:00:00Z",
    "site_url": "https://yoursite.com",
    "total_entries": 1000,
    "date_range": {
      "start": "2025-11-13T00:00:00Z",
      "end": "2025-12-13T11:00:00Z"
    }
  },
  "summary": {
    "total_visits": 2847,
    "unique_bots": 8,
    "ai_bots": 5,
    "traditional_bots": 3,
    "pages_visited": 127,
    "average_response_time_ms": 187
  },
  "bot_breakdown": {
    "GPTBot": {
      "visits": 456,
      "pages": 89,
      "avg_interval_hours": 67.2,
      "success_rate": 99.1
    },
    "ClaudeBot": {
      "visits": 287,
      "pages": 76,
      "avg_interval_hours": 84.5,
      "success_rate": 98.9
    }
  },
  "visits": [
    {
      "timestamp": "2025-12-13T10:47:23Z",
      "bot": {
        "name": "GPTBot",
        "type": "AI",
        "category": "OpenAI",
        "user_agent": "GPTBot/1.0",
        "verified": true
      },
      "request": {
        "url": "/wordpress-guide/",
        "page_title": "Complete WordPress Guide",
        "ai_score": 97,
        "method": "GET",
        "protocol": "HTTP/2.0"
      },
      "response": {
        "code": 200,
        "time_ms": 234,
        "size_bytes": 45678
      },
      "network": {
        "ip": "66.249.64.12",
        "reverse_dns": "crawl.openai.com",
        "verified_origin": true
      }
    }
  ]
}
```

**Use Cases:**
- ✅ API integration
- ✅ Automated workflows
- ✅ Machine learning analysis
- ✅ Advanced analytics
- ✅ Third-party tools

---

### Export Options

**Customizable Export Settings:**
```
┌─────────────────────────────────────┐
│  Export Bot Activity                │
├─────────────────────────────────────┤
│                                     │
│  Format:                            │
│  ○ CSV                              │
│  ● JSON                             │
│  ○ XML (Advanced)                   │
│                                     │
│  Date Range:                        │
│  From: [2025-11-01]                 │
│  To:   [2025-12-13]                 │
│                                     │
│  Bot Filter:                        │
│  ☑ AI Bots                          │
│  ☑ Traditional Bots                 │
│  ☐ Unknown Bots                     │
│                                     │
│  Include:                           │
│  ☑ Visit details                    │
│  ☑ Page information                 │
│  ☑ AI Scores                        │
│  ☑ Response metrics                 │
│  ☑ Network data                     │
│  ☐ User agent strings               │
│                                     │
│  Limit: [1000 ▼] entries            │
│                                     │
│  [Export Now] [Schedule Export]     │
│                                     │
└─────────────────────────────────────┘
```

---

## 7. Bot Behavior Patterns

### Crawl Pattern Analysis

**Typical Bot Behaviors:**
```
GPTBot (OpenAI)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Pattern: Systematic, depth-first
Frequency: 2-3 times per week
Preference: High AI Score pages (90+)
Behavior: Follows internal links
Time: Distributed throughout day
Pages/Visit: 5-12 pages average

Observation: Strongly favors:
├─ FAQ pages
├─ How-to guides  
├─ Long-form content (2000+ words)
└─ Pages with schema markup

ClaudeBot (Anthropic)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Pattern: Selective, quality-focused
Frequency: 1-2 times per week
Preference: Comprehensive content
Behavior: Deep reading (long dwell time)
Time: Business hours (US)
Pages/Visit: 3-8 pages average

Observation: Prefers:
├─ In-depth articles
├─ Technical documentation
├─ Well-structured content
└─ Recent updates

PerplexityBot
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Pattern: Aggressive, broad coverage
Frequency: Multiple times daily
Preference: Real-time content
Behavior: Fast, breadth-first
Time: 24/7 activity
Pages/Visit: 10-20 pages average

Observation: Targets:
├─ News/blog posts
├─ Recent updates
├─ Trending topics
└─ Time-sensitive content
```

---

### Peak Activity Times

**Bot Activity Heatmap:**
```
┌───────────────────────────────────────┐
│  Bot Activity by Hour (UTC)           │
├───────────────────────────────────────┤
│                                       │
│  00:00 ▓░░░░░░░ Low                  │
│  03:00 ▓░░░░░░░ Low                  │
│  06:00 ▓▓▓░░░░░ Moderate             │
│  09:00 ▓▓▓▓▓▓░░ High                 │
│  12:00 ▓▓▓▓▓▓▓▓ Very High ← Peak     │
│  15:00 ▓▓▓▓▓▓▓░ High                 │
│  18:00 ▓▓▓▓░░░░ Moderate             │
│  21:00 ▓▓░░░░░░ Low-Moderate         │
│                                       │
│  Peak Hours: 09:00-17:00 UTC         │
│  Recommendation: Update content      │
│  during 06:00-09:00 UTC for          │
│  maximum same-day indexing           │
│                                       │
└───────────────────────────────────────┘
```

---

## 8. Crawler Management

### Robots.txt Configuration

**AISEOmatic Auto-Generated Directives:**
```
# Added by AISEOmatic AI
# AI Search Engine Bots

User-agent: GPTBot
Allow: /
Crawl-delay: 1
Sitemap: https://yoursite.com/ai-sitemap.xml

User-agent: ClaudeBot
Allow: /
Crawl-delay: 1

User-agent: PerplexityBot
Allow: /
Crawl-delay: 1

User-agent: Google-Extended
Allow: /

User-agent: Amazonbot
Allow: /

User-agent: Applebot-Extended
Allow: /

User-agent: Bytespider
Allow: /

User-agent: Meta-ExternalAgent
Allow: /

# Sitemap Declaration
Sitemap: https://yoursite.com/ai-sitemap.xml
Sitemap: https://yoursite.com/sitemap.xml
```

---

### Bot Throttling (Pro)

**Gentle Throttling Settings:**
```
┌─────────────────────────────────────┐
│  Bot Throttling Configuration       │
├─────────────────────────────────────┤
│                                     │
│  ☑ Enable intelligent throttling   │
│                                     │
│  Mode: [Gentle ▼]                   │
│  • Gentle (recommended)             │
│  • Moderate                         │
│  • Aggressive                       │
│  • Off                              │
│                                     │
│  Rules:                             │
│  Max requests/minute: [30]          │
│  Crawl delay: [1] second            │
│                                     │
│  Whitelist (Never Throttle):        │
│  ☑ Googlebot                        │
│  ☑ Bingbot                          │
│  ☑ GPTBot                           │
│  ☑ ClaudeBot                        │
│  ☐ Unknown bots                     │
│                                     │
│  [Save Settings]                    │
│                                     │
└─────────────────────────────────────┘
```

---

### Crawler ETA Predictions (Pro)

**Next Visit Estimates:**
```
┌─────────────────────────────────────┐
│  📅 Predicted Next Bot Visits        │
├─────────────────────────────────────┤
│                                     │
│  GPTBot                             │
│  Last Visit: 2 days ago             │
│  Avg Interval: 2.8 days             │
│  Next Visit: ~20 hours              │
│  Confidence: 78%                    │
│                                     │
│  ClaudeBot                          │
│  Last Visit: 5 days ago             │
│  Avg Interval: 6.2 days             │
│  Next Visit: ~1-2 days              │
│  Confidence: 65%                    │
│                                     │
│  PerplexityBot                      │
│  Last Visit: 4 hours ago            │
│  Avg Interval: 8.5 hours            │
│  Next Visit: ~4 hours               │
│  Confidence: 85%                    │
│                                     │
│  💡 Tip: Publish updates before     │
│     predicted visits for faster     │
│     indexing                        │
│                                     │
└─────────────────────────────────────┘
```

---

## 9. Troubleshooting & Verification

### Common Issues

**Issue #1: No Bot Activity Detected**
```
Symptoms:
❌ Zero bot visits logged
❌ Empty bot detection dashboard

Possible Causes:
→ New website (< 2 weeks old)
→ No sitemap submitted
→ Robots.txt blocking crawlers
→ Low-quality/thin content
→ Server blocking bot IPs

Solutions:
1. Verify AI Sitemap accessible at /ai-sitemap.xml
2. Check robots.txt allows AI bots
3. Submit sitemap to Google Search Console
4. Ensure content quality (AI Score 70+)
5. Check server firewall settings
6. Wait 7-14 days for initial discovery
```

---

**Issue #2: Only Traditional Bots, No AI Bots**
```
Symptoms:
✅ Googlebot, Bingbot detected
❌ No GPTBot, ClaudeBot, etc.

Possible Causes:
→ AI Sitemap not accessible
→ Content not AI-optimized
→ Low AI Scores across site
→ Geo-restrictions on site

Solutions:
1. Verify /ai-sitemap.xml accessible
2. Improve AI Scores (target 80+)
3. Add data-llm attributes
4. Add schema markup
5. Check no country blocks on bots
6. Be patient (AI bots slower to discover)
```

---

**Issue #3: Bot Verification Failures**
```
Symptoms:
⚠ "Unverified bot" warnings
⚠ Suspicious activity flags

Causes:
→ IP spoofing attempts
→ Fake user agents
→ Malicious crawlers

AISEOmatic Protection:
✅ Reverse DNS verification
✅ IP range validation
✅ Behavioral analysis
✅ Known bot database

Action:
→ Automatic blocking of fake bots
→ Only real bots logged
→ Security maintained
```

---

### Bot Verification Methods

**How AISEOmatic Verifies Bots:**
```
1. User Agent Check
   ├─ Parse UA string
   ├─ Match known patterns
   └─ Initial classification

2. IP Validation
   ├─ Check against known ranges
   ├─ Google: 66.249.0.0/16
   ├─ OpenAI: Various AWS ranges
   └─ Verify ownership

3. Reverse DNS Lookup
   ├─ Query PTR record
   ├─ Verify domain ownership
   ├─ googlebot.com
   ├─ crawl.openai.com
   └─ Must match

4. Behavioral Analysis
   ├─ Crawl patterns
   ├─ Request frequency
   ├─ Header consistency
   └─ Known behavior match

Result: High-confidence bot identification
```

---

## 10. Advanced Bot Intelligence

### Bot Segmentation

**Intelligent Bot Categorization:**
```
AI Search Bots (Primary Focus)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Priority: Critical
Optimization: Maximum
Tracking: Detailed
Impact: High SEO value

Traditional Search Bots
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Priority: High
Optimization: Standard
Tracking: Standard
Impact: Essential baseline

Social Media Bots
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Priority: Medium
Optimization: Moderate
Tracking: Basic
Impact: Share optimization

Research/Academic Bots
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Priority: Low
Optimization: Minimal
Tracking: Logged only
Impact: Negligible

Monitoring/Uptime Bots
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Priority: None
Optimization: None
Tracking: Excluded
Impact: Zero
```

---

### Custom Bot Rules (Pro)

**Advanced Bot Management:**
```
┌─────────────────────────────────────┐
│  Custom Bot Rules                   │
├─────────────────────────────────────┤
│                                     │
│  Rule 1: Priority Bots              │
│  If bot = [GPTBot, ClaudeBot]       │
│  Then:                              │
│    • Allow all pages                │
│    • No rate limiting               │
│    • Priority in logs               │
│                                     │
│  Rule 2: Heavy Crawlers             │
│  If requests > 100/hour             │
│  Then:                              │
│    • Gentle throttling              │
│    • Crawl-delay: 2 seconds         │
│    • Monitor closely                │
│                                     │
│  Rule 3: Unknown Bots               │
│  If bot = unverified                │
│  Then:                              │
│    • Standard rate limit            │
│    • Log but don't prioritize       │
│    • Flag for review                │
│                                     │
│  [Add Rule] [Save All]              │
│                                     │
└─────────────────────────────────────┘

AISEOmatic Bot Detection Guide v1.0

Last Updated: December 13, 2025

The post AISEOmatic Bot Detection — Logs, KPIs & Exports Guide appeared first on AISEOmatic.