# AICitare

**Generative Engine Optimization for WordPress.** Measure and improve how well AI search engines — ChatGPT, Perplexity, Google AI Overviews, Gemini, Claude, Grok — can read, understand and cite your content.

AICitare gives you a single GEO Score for the whole site and for every page, diagnoses the gaps, and offers one-click fixes. It runs as a React single-page app inside wp-admin (using WordPress' bundled `wp-element`, no build step) talking to a custom `aicitare/v1` REST namespace.

## Features

- **GEO Score (0–100)** for the site and per page, broken into five weighted sub-scores: Structured Data, Content Structure, Crawlability, Authority, Freshness.
- **Per-page diagnosis** with a prioritized issue list and **one-click fixes**.
- **Schema analysis** for Product / Review / ItemList / FAQ, with a Complementary mode that avoids duplicating schema your SEO plugin already emits (Yoast-aware).
- **AI crawler management** — allow/block AI bots (GPTBot, ClaudeBot, PerplexityBot, Google-Extended and more); rules are written to `robots.txt`.
- **llms.txt generation** — a curated, auto-updating index served at `/llms.txt`.
- **AI bot activity log** — see which AI crawlers visit which pages.
- **AI visibility tracking** — citations across ChatGPT, Perplexity, Gemini, Claude, plus competitor share of voice and content-gap analysis.
- **Rephrase for GEO** — three AI rewrites per passage tuned for citability, using your own LLM keys, saved as a draft for review.
- **In-editor GEO Readiness metabox** — live score and checklist while you write.
- **Reports & alerts** — monthly HTML email report and score-drop / blocked-crawler alerts.
- **Google Search Console integration** — real impressions & clicks (OAuth).

## Requirements

- WordPress 6.2+
- PHP 8.0+

## Installation

1. Download this repository (or the packaged ZIP) into `/wp-content/plugins/aicitare/`.
2. Activate **AICitare** in Plugins.
3. Open **AICitare** in the admin menu and click **Run scan**.

The plugin scans your real published posts by default. To explore with the bundled Pillow Fair sample dataset, turn **Demo data** on in **Settings**.

## Privacy & external services

All third-party integrations are **optional** and used only when you enter an API key or enable the feature. API keys are stored encrypted and never exposed to the browser. No data is sent to the plugin author. See `readme.txt` (External services) for the full list.

## Development

The admin UI is a no-build React SPA (`assets/js/app.js`) using WordPress' bundled `wp-element` and `wp-api-fetch`; state persists in options and scans run via WP-Cron. Back-end logic lives in `includes/` (scanner, schema, REST, visibility, reports, etc.). No compilation step is required — edit and reload.

## License

GPLv2 or later — see [LICENSE](LICENSE).