AISEOmatic Local Business — Profile, JSON-LD & Robots #

🏢 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:

API Provider Credentials: Connect and test AI service integrations
Public Business Profile: NAP (Name, Address, Phone) and service information
Robot Policies: Control AI agent behavior and front-end features
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)

Enter complete NAP information
Add latitude/longitude for precision
Include map URL reference
List all service areas
Click Save

Step 2: API Provider Connection (3 minutes)

Paste API keys for chosen providers
Select primary provider from dropdown
Add OpenAI Project ID if required
Click Test button for each provider
Verify successful connection
Click Save Settings

Step 3: Policy Configuration (2 minutes)

Review AI usage policies (noai/noimageai)
Select appropriate restrictions
Consider AI sitemap privacy
Decide on each policy toggle
Click Save

Step 4: Feature Activation (2 minutes)

Enable desired front-end signals
Activate JSON-LD injection
Enable AI-Sitemap if appropriate
Configure entity linking preference
Activate image ALT automation
Click Save

Step 5: Validation & Review (1 minute)

Click ✅ Validate Configuration
Review toast notifications
Check status bar
Address any errors identified
Open JSON-LD Preview to verify schema output

Step 6: Verification (2 minutes)

Use quick navigation to open AI Insights
Verify business information displays correctly
Check schema validation in testing tools
Confirm AI sitemap accessibility
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:

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

Validation Errors:

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

JSON-LD Not Appearing:

Verify “Inject JSON-LD” is enabled
Click Generate in preview section
Clear site cache
Check page source for <script type="application/ld+json">
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