=== UP SEO Assistant ===
Contributors: sobiluciano
Tags: seo, ai, geo, aeo, audit
Requires at least: 5.8
Requires PHP: 7.4
Tested up to: 7.1
Stable tag: 1.4.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AI-powered SEO assistant. Identifies high-converting pages, suggests targeted optimizations, and tracks progress to increase leads and sales.

== Description ==

**UP SEO Assistant** is an advanced WordPress plugin that uses artificial intelligence (Google Gemini and Anthropic Claude) to analyze your website and identify the most concrete SEO growth opportunities.

Unlike traditional SEO plugins that stop at meta tags, this assistant analyzes **real content** and **search intent** to suggest structural and conversion improvements.

All AI processing is performed by the UP-SEO external SaaS server (up-seo.it). The plugin connects to this service to deliver its core functionality. No AI processing happens locally inside the plugin.

= Features =

* **Value Page Analysis**: Detect which pages have the highest potential to drive sales or leads.
* **AI On-Page Audit**: Receive specific suggestions based on CRO (Conversion Rate Optimization) signals.
* **SERP Reverse Engineering**: Analyze the top search results for any keyword and get a winning content formula.
* **AI-Proof Content**: Find content angles that AI cannot replicate, based on your real GSC data and sitemap.
* **AI Writer**: Generate full SEO-optimized articles with H1/H2/H3 structure, meta title and meta description.
* **Niche Keyword Finder**: Find high-intent keywords and discover competitor gaps in your niche.
* **Auto FAQ Schema**: Automatically generate and inject structured FAQ schemas to increase SERP clicks.
* **Internal Linker**: AI-powered suggestions for internal links based on your actual content.
* **Google Search Console Integration**: Analyze real Google data to identify "Quick Wins" and pages at risk of AI Overviews.
* **GEO/AEO Strategy**: Generate a complete strategic document to make your brand visible in AI-generated answers (ChatGPT, Claude, Gemini, Perplexity, Google AI Overviews). Includes a live discovery of your site and niche, an editorial plan, off-site authority actions, robots.txt and llms.txt templates, schema markup priorities, KPIs and a 12-month roadmap. Available on paid plans, once per month.

== External Services ==

This plugin connects to the following external services to provide its core functionality:

**1. UP-SEO SaaS Server (up-seo.it)**
Used for: All AI-powered analyses (SEO audit, keyword research, content suggestions, SERP analysis, AI Writer, AI-Proof content, internal linking, GEO/AEO strategy). The plugin sends your website URL, Google Search Console data (page URLs, clicks, impressions, positions), and content snippets to our server for processing. The plugin never contacts this server automatically or in the background: the very first connection only happens after you explicitly click "Attiva il trial gratuito" (Activate free trial) on the Settings tab, or enter a license key. After that explicit action, the plugin periodically checks your trial/license status to keep it in sync, and sends data whenever you trigger an analysis from the plugin dashboard. The server acts as a proxy to the AI providers listed below: the plugin never contacts them directly, except for the optional Gemini key validation described in section 2.
- Service URL: https://www.up-seo.it
- Terms of Service: https://www.up-seo.it/termini-di-servizio-plugin/
- Privacy Policy: https://www.up-seo.it/cookie-policy/

**2. Google Gemini API (Google LLC)**
Used for: AI-powered content analysis, SEO suggestions, and content generation. Requests are routed through the UP-SEO SaaS server. If you provide your own Gemini API key in the settings, the plugin also calls the Gemini API directly to validate the key.
- Service URL: https://ai.google.dev/
- Terms of Service: https://ai.google.dev/gemini-api/terms
- Privacy Policy: https://policies.google.com/privacy

**3. Anthropic Claude API (Anthropic PBC)**
Used for: The GEO/AEO Strategy feature only. When you trigger this analysis, the UP-SEO server sends your website URL to Claude, which visits your public pages and performs web searches about your brand, niche and competitors in order to write the strategic document. Requests are routed exclusively through the UP-SEO SaaS server; the plugin never contacts Anthropic directly and no API key is stored in the plugin. Only publicly accessible information about your website is processed, and only when you explicitly start the generation.
- Service URL: https://www.anthropic.com/
- Terms of Service: https://www.anthropic.com/legal/commercial-terms
- Privacy Policy: https://www.anthropic.com/legal/privacy

**4. DataForSEO API (DataForSEO LLC)**
Used for: Search engine results data and keyword metrics that power the SERP Reverse Engineering and Niche Keyword Finder features (organic SERP results, keyword ideas, search volume, search intent). When you run one of these analyses, the UP-SEO server sends the keyword you typed together with the target language and country. Requests are routed exclusively through the UP-SEO SaaS server; the plugin never contacts DataForSEO directly. No personal data and no content from your website is sent to this service.
- Service URL: https://dataforseo.com/
- Terms of Service: https://dataforseo.com/terms-of-service
- Privacy Policy: https://dataforseo.com/privacy-policy

**5. Google Search Console API (Google LLC)**
Used for: Fetching real traffic data (clicks, impressions, rankings) for your website to power GSC-based analyses. Authentication is handled via OAuth2 through the UP-SEO server. Data is retrieved only when you connect your GSC account and trigger an analysis.
- Service URL: https://search.google.com/search-console/
- Terms of Service: https://developers.google.com/terms
- Privacy Policy: https://policies.google.com/privacy

== Installation ==

1. Upload the `up-seo-assistant` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin via the 'Plugins' menu in WordPress.
3. Go to the new 'UP SEO Assistant' menu in the WordPress admin sidebar.
4. Follow the Quick Setup wizard to connect your Google Search Console account.
5. Once connected, all features are immediately available from the dashboard.

== Frequently Asked Questions ==

= Is an API key required? =
The plugin connects to the UP-SEO SaaS server (up-seo.it) which handles all AI processing. You can activate a free trial directly from the plugin settings without any API key. Optionally, you can also provide your own Google Gemini API key for direct validation.

= Does it support search engines other than Google? =
The analysis is optimized for Google and uses Google Search Console data for maximum precision.

= What data is sent to external servers? =
The plugin sends your website URL, GSC performance data (page URLs, clicks, impressions, positions), and content snippets to the UP-SEO SaaS server when you trigger an analysis. The server then forwards the relevant data to the providers it needs for that specific feature: Google Gemini for most AI analyses, Anthropic Claude for the GEO/AEO Strategy, and DataForSEO for SERP and keyword data (keyword, language and country only). No data is sent automatically in the background. See the External Services section for full details.

= Is the plugin fully functional without a paid plan? =
Yes. The plugin connects to the UP-SEO external service which offers a free trial. All plugin features are fully available — any service limits are managed entirely by the external UP-SEO service, not by the plugin code itself.

== Screenshots ==

1. Main dashboard with value page analysis.
2. SERP Reverse Engineering tool.
3. AI-Proof Content analysis.
4. AI Writer in action.
5. Quick Setup configuration panel.

== Changelog ==

= 1.4.0 =
* Added GEO/AEO Strategy tab: generates a complete strategic document to make your brand visible in AI-generated answers.
* The GEO/AEO Strategy is powered by the Anthropic Claude API through the UP-SEO server, with live discovery of your site, niche and competitors.
* The analysis is limited to the site where the plugin is installed, and can be regenerated once per month.
* Added the GEO/AEO section to the built-in plugin guide.
* Declared the Anthropic Claude API and the DataForSEO API in the External Services section.
* Updated the plugin description to list all AI and data providers.
* Removed automatic background registration with the UP-SEO server on plugin activation. The plugin now stays completely silent until you explicitly activate the free trial (new consent button on the Settings tab) or enter a license key.

= 1.3.0 =
* Added SERP Reverse Engineering tab with keyword + location analysis.
* Added AI-Proof Content tab: finds content angles AI cannot replicate.
* Added AI Writer clone for AI-Proof content generation.
* Added "Pages at Risk of AI Overviews" detection in GSC tab.
* Added built-in plugin guide modal with 11 sections.
* Major UI redesign: new floating button navigation.
* All functionality limits enforced server-side only (Serviceware model).
* Plugin Check compliance: fixed all errors (date functions, escaping, text domain).
* Updated Chart.js to v4.5.1.

= 1.2 =
* Improved server-side security for the Niche Finder.
* Added support for the unlimited Sandbox plan.
* Fixed FAQ suggestion system for pages with thin content.

= 1.1 =
* Integration with Gemini 2.0 Flash.
* New SEO progress visualization.

= 1.0 =
* Initial release.
