# GEO Analysis Tool

Flagship Generative Engine Optimization (GEO/AEO) plugin for the PEWIT Labs suite.
Slug: `ai-visibility-toolkit` · Prefix: `AIVT` / `aivt_`

## What it does

The all-in-one toolkit for being found, trusted and cited by AI answer engines
(ChatGPT, Perplexity, Gemini, Google AI Overviews):

| Module | Free (manual, BYOK) | Pro / Agency |
| --- | --- | --- |
| GEO Score 0–100 | per page | bulk + auto-on-publish + trends |
| Entity detection | per page | bulk + `knowsAbout`/`sameAs` |
| E-E-A-T analysis | per page | bulk |
| AI citability | per page | bulk + history |
| FAQ & Q&A generation | manual + insert | bulk + auto |
| Schema generator | manual | bulk + auto |
| Prompt testing | manual (BYOK) | scheduled monitoring + history |
| Competitor share-of-voice | — | Pro (3) / Agency (10) |
| White-label / multi-site | — | Agency |

Philosophy (suite-wide): **Free = full manual workflow with your own key. Pro/Agency = automation, not better AI.**

## Pricing

| Plan | Regular | Launch promo |
| --- | --- | --- |
| Pro (1 site) | €99/yr | €79/yr |
| Agency (unlimited) | €349/yr | €299/yr |

14-day trial (BYOK only during trial).

## Architecture

- `ai-visibility-toolkit.php` — bootstrap (Freemius-first, defines, require chain, cron, boot)
- `includes/`
  - `helpers.php` — settings, plan gating (`aivt_can_automate()`), LLM glue, provider select
  - `class-license.php` — Freemius wrapper
  - `class-aivt-llm-api.php` — shared OpenAI/Claude/Gemini client (prefixed)
  - `class-api.php` — prompt/context orchestration, JSON parsing
  - `class-store.php` — per-post meta + site reports + prompt history
  - `class-geo-score.php`, `class-entities.php`, `class-eeat.php`, `class-citability.php`
  - `class-faq.php`, `class-qa.php`, `class-schema.php`
  - `class-prompt-test.php`, `class-competitors.php`
  - `class-queue.php` — bulk GEO jobs (Pro), `class-lifecycle.php`, `class-render.php`
- `admin/class-admin.php` — 6 pages (Dashboard, Content, Prompt testing, Competitors, Jobs, Settings) + AJAX
- `admin/class-post-editor.php` — per-post analysis metabox
- `assets/` — shared `pewit-admin-shell.css` + plugin `admin.css`/`admin.js`

## Build

```bash
./build.sh
```

Outputs `dist/ai-visibility-toolkit-<version>.zip`.
