# AiVisibility SEO-GEO Agent

Report-only WordPress plugin for AI-assisted SEO-GEO analysis.

- Plugin name: `AiVisibility SEO-GEO Agent`
- Plugin slug and folder: `aivisibility-seo-geo-agent`
- Version: `0.10.73`
- WordPress: `6.0+`, tested up to `7.0`
- PHP: `7.4+`

## What it does

The plugin scans published pages, posts, and WooCommerce products and stores an AI recommendation report for each URL. Reports can include suggested metadata, Open Graph/social tags, JSON-LD, headings, keyword targeting, and image alt text.

This distribution does not contain site-content modification or rollback functionality. It does not register front-end metadata or content filters. The administrator reviews each recommendation and makes any desired changes independently.

## Credits and checkout

A newly registered domain receives 5 complimentary AiVisibility service credits. One service credit produces one page, post, or product report. Additional service credits can optionally be purchased through Stripe Checkout from the plugin admin screen.

The WordPress plugin and report interface are fully available without a paid plugin license. Service-credit validation and purchases use both the normalized site domain and generated site ID. The API server owns all credit changes.

## External service

The plugin communicates with the AiVisibility API hosted at `https://api1.aivisibility.gr`:

- `https://api1.aivisibility.gr/v1/seo/analyze`
- `https://api1.aivisibility.gr/first_requests.php`
- `https://api1.aivisibility.gr/stripe/create_checkout.php`

The plugin sends page scan data, site identity, a generated site ID, and saved SEO strategy/business profile fields. AI provider credentials remain server-side.

- Service: https://ai-visibility.io
- Privacy: https://ai-visibility.io/privacy/
- Terms: https://ai-visibility.io/terms/

## Source layout

- `aivisibility-seo-geo-agent.php`: plugin bootstrap
- `includes/class-aiseo-plugin.php`: lifecycle and settings
- `includes/class-aiseo-admin.php`: admin screen, queue, reports, and checkout handoff
- `includes/class-aiseo-scanner.php`: local and public page-source collection
- `includes/class-aiseo-openai-client.php`: AiVisibility API client
- `assets/js/admin.js`: admin interactions and report rendering
- `assets/css/admin.css`: admin styling
- `uninstall.php`: plugin data cleanup

## Security

Admin actions require WordPress capabilities and nonces. REST routes use capability checks. External requests use WordPress HTTP APIs. Database wildcard cleanup in `uninstall.php` uses prepared parameters.

AI analysis and service-credit purchases are validated server-side against both domain and generated site ID. The initial activation endpoint creates the first domain record and complimentary service-credit balance only when the domain does not already exist.

## License

GPLv2 or later.