=== Metapilot Smart SEO ===
Contributors: wpstrativ, joystrativ, shuvostrativ, sayed24, redwanstrativ, mariumstrativ
Tags: seo, ai seo, schema markup, xml sitemap, redirects
Requires at least: 5.8
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AI-powered SEO plugin with meta generation, content analysis, schema markup, XML sitemaps, redirect manager, and robots.txt editor.

== Description ==

Metapilot Smart SEO is a comprehensive, professional-grade SEO plugin for WordPress that combines AI-powered optimization with essential SEO tools. Whether you're a beginner or an SEO expert, Metapilot Smart SEO provides everything you need to improve your search engine rankings.

= AI-Powered Meta Generation =

Generate SEO-optimized meta titles and descriptions using cutting-edge AI technology:

* Support for **Anthropic Claude** and **Google Gemini**
* One-click generation with smart content analysis
* Bulk generation support for multiple posts
* Natural, engaging meta descriptions that drive clicks

= Content Analysis =

Comprehensive real-time analysis to ensure your content is fully optimized:

* **17 SEO checks** covering all major ranking factors
* **8 readability checks** for better user engagement
* **Focus keyword analysis** including density and placement
* **Structure analysis** for headings, links, and images
* Tabbed interface with color-coded scores
* Live analysis as you write

= XML Sitemap =

Automatic sitemap generation to help search engines discover your content:

* Generates sitemap at `/sitemap_index.xml`
* Separate sitemaps for posts, pages, and categories
* Exclude specific posts or pages from sitemap
* Auto-redirect `/sitemap.xml` to `/sitemap_index.xml`
* Ping search engines automatically on content updates

= Redirect Manager =

Powerful redirect management with 404 monitoring:

* Create 301 (permanent) and 302 (temporary) redirects
* Monitor and log 404 errors automatically
* One-click redirect creation from 404 logs
* CSV export for redirects and 404 logs
* Regex support for advanced redirect patterns

= Robots.txt Editor =

Full control over search engine crawling:

* Virtual robots.txt generation (no file needed)
* **One-click block AI crawlers:** GPTBot, ChatGPT-User, Google-Extended, ClaudeBot, Claude-Web, Bytespider, Omgilibot, FacebookBot, Diffbot, Applebot-Extended, PerplexityBot, cohere-ai, CCBot
* **One-click block aggressive SEO bots:** AhrefsBot, SemrushBot, MJ12bot, DotBot, BLEXBot, SearchmetricsBot, PetalBot, MegaIndex, and more
* Custom rules editor with syntax reference
* Live preview with copy to clipboard

= Schema Markup Generator =

Add structured data to improve rich snippets in search results.

**14 Schema Types Supported:**

* **Local Business** - Name, address, hours, geo coordinates, price range
* **Organization** - Name, logo, founders, contact information
* **Person** - Name, job title, works for, social profiles
* **Website** - Name, search action, language
* **Article** - Headline, author, publisher, dates
* **Product** - Name, price, availability, rating
* **Service** - Name, description, provider, area served, price, offer catalog
* **FAQ Page** - Question and answer pairs
* **How To** - Steps, tools, supplies, time required
* **Event** - Date, venue, tickets, performer
* **Recipe** - Ingredients, instructions, nutrition
* **Video** - Title, duration, thumbnail
* **Breadcrumb** - Navigation path
* **Software Application** - Category, OS, rating, download URL

**Flexible Display Rules:**

* All pages (default)
* Homepage only
* Specific post types
* Include only specific pages/posts
* Exclude specific pages/posts

= Site Connections =

Easy webmaster tools verification:

* Google Search Console
* Bing Webmaster Tools
* Baidu Webmaster
* Yandex Webmaster
* Pinterest
* Ahrefs Analytics

Smart paste detection automatically extracts verification codes from full meta tags.

= Social Media Integration =

Optimize how your content appears when shared:

* Open Graph meta tags for Facebook and LinkedIn
* Twitter Card meta tags
* Custom social images per post
* Default fallback image for posts without a featured image

= Additional Features =

* Search engine preview (Google SERP simulator)
* Custom post type support
* Advanced options per post (noindex, nofollow, canonical)
* Clean, modern admin interface
* WordPress coding standards compliant

== External Services ==

This plugin connects to the following third-party services to provide its features. Please review the information below to understand what data is sent and when.

= Anthropic Claude API =

This plugin optionally connects to Anthropic's Claude API to generate AI-powered SEO meta titles and descriptions.

**What data is sent:** When you click "Generate with AI" on a post or page, the plugin sends your post title, post content (up to 2000 words), and focus keyword (if provided) to Anthropic's API servers.

**When data is sent:** Data is only sent when you explicitly click the "Generate Now with AI" button in the post editor, or when you enable "Auto-generate on save" and save a post. No data is sent automatically without user action.

**Service Links:**
* [Anthropic Terms of Service](https://www.anthropic.com/legal/terms)
* [Anthropic Privacy Policy](https://www.anthropic.com/legal/privacy)

= Google Gemini API =

This plugin optionally connects to Google's Generative AI (Gemini) API to generate AI-powered SEO meta titles and descriptions.

**What data is sent:** When you click "Generate with AI" on a post or page, the plugin sends your post title, post content (up to 2000 words), and focus keyword (if provided) to Google's Generative AI API servers.

**When data is sent:** Data is only sent when you explicitly click the "Generate Now with AI" button in the post editor, or when you enable "Auto-generate on save" and save a post. No data is sent automatically without user action.

**Service Links:**
* [Google API Terms of Service](https://developers.google.com/terms)
* [Google Privacy Policy](https://policies.google.com/privacy)

= Google Sitemap Ping =

This plugin optionally pings Google to notify them that your sitemap has been updated when you publish or update content.

**What data is sent:** When you publish or update a post or page, the plugin sends your sitemap URL to Google's ping endpoint to request re-crawling.

**When data is sent:** Data is sent automatically when a post or page is published or updated, but only if sitemap ping is enabled in the plugin settings. Pings are throttled to once per hour to prevent excessive requests.

**Service Links:**
* [Google Terms of Service](https://policies.google.com/terms)
* [Google Privacy Policy](https://policies.google.com/privacy)

= Bing Sitemap Ping =

This plugin optionally pings Bing to notify them that your sitemap has been updated when you publish or update content.

**What data is sent:** When you publish or update a post or page, the plugin sends your sitemap URL to Bing's ping endpoint to request re-crawling.

**When data is sent:** Data is sent automatically when a post or page is published or updated, but only if sitemap ping is enabled in the plugin settings. Pings are throttled to once per hour to prevent excessive requests.

**Service Links:**
* [Bing Webmaster Tools Terms of Use](https://www.bing.com/toolbox/webmaster/terms)
* [Microsoft Privacy Statement](https://privacy.microsoft.com/en-us/privacystatement)

= Ahrefs Analytics =

This plugin optionally loads the Ahrefs Analytics script on your website's homepage for site verification and analytics purposes.

**What data is sent:** If you configure an Ahrefs verification key in the plugin settings, the Ahrefs Analytics JavaScript file is loaded on your homepage. Ahrefs may collect visitor data based on their script functionality.

**When data is sent:** The Ahrefs script loads only on the homepage/front page and only when you have configured an Ahrefs verification key in the Site Connections settings. If no key is configured, no connection to Ahrefs is made.

**Service Links:**
* [Ahrefs Terms of Service](https://ahrefs.com/terms)
* [Ahrefs Privacy Policy](https://ahrefs.com/privacy)

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/metapilot-smart-seo/` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Go to **Metapilot Smart SEO → Settings** to configure the plugin.
4. (Optional) Enter your AI API key for AI-powered features.
5. Start optimizing your content!

= AI Provider Setup =

1. Navigate to **Metapilot Smart SEO → Settings → AI API**
2. Select your AI provider (Anthropic Claude or Google Gemini)
3. Enter your API key
4. Save settings

= Sitemap Configuration =

1. Go to **Metapilot Smart SEO → XML Sitemap**
2. Enable sitemap generation
3. Configure included post types
4. Set posts per sitemap page
5. View your sitemap at yoursite.com/sitemap_index.xml

= Schema Setup =

1. Go to **Metapilot Smart SEO → Schema**
2. Click "Add Schema"
3. Select schema type from the dropdown
4. Fill in the required fields
5. Configure display rules
6. Save your schema

== Frequently Asked Questions ==

= Do I need an API key to use this plugin? =

An API key is only required for AI-powered meta generation features. All other features including XML sitemaps, redirects, schema markup, and the robots.txt editor work without an API key.

= Which AI provider should I choose? =

Both providers work excellently. Anthropic Claude excels at natural, engaging language, while Google Gemini is Google's own powerful AI. Choose based on your preference or existing subscriptions.

= Does Metapilot Smart SEO work with custom post types? =

Yes! You can enable Metapilot Smart SEO for any public custom post type in the settings. The plugin will add the SEO meta box and include custom post types in sitemaps.

= Will this plugin conflict with other SEO plugins? =

We recommend deactivating other SEO plugins before using Metapilot Smart SEO to avoid conflicts and duplicate meta tags.

= Can I show different schemas on different pages? =

Yes! Each schema you create has flexible display rules. You can target specific pages, post types, or exclude certain content from showing a particular schema.

= How do I verify my site with Google Search Console? =

1. Go to **Metapilot Smart SEO → Settings → Site Connections**
2. Paste your Google verification code or the full meta tag
3. Save settings
4. Complete verification in Google Search Console

= Is the sitemap automatically updated? =

Yes! The sitemap is dynamically generated and always reflects your current content. Search engines are automatically pinged when you publish or update content.

= Can I block AI crawlers from scraping my content? =

Yes! Go to **Metapilot Smart SEO → Robots.txt** and use the one-click buttons to block AI crawlers like GPTBot, ChatGPT-User, ClaudeBot, and many others.

= Does the plugin support multilingual sites? =

The plugin is translation-ready and works with multilingual plugins. All strings use proper internationalization functions.

= Where can I get support? =

For support questions, please use the WordPress.org support forum for this plugin.

== Screenshots ==

1. Dashboard - Overview of your site's SEO status and active modules
2. Meta Box - AI-powered meta generation with live SERP preview
3. SEO Analysis - Comprehensive checks with color-coded scores
4. Schema Generator - Easy-to-use interface with 14 schema types
5. Redirect Manager - Create and manage redirects with 404 monitoring
6. Robots.txt Editor - Live preview with one-click bot blocking
7. XML Sitemap - Automatic sitemap generation settings
8. Site Connections - Webmaster tools verification

== Changelog ==

= 1.0.0 =
* Initial release
* AI-powered meta generation supporting Anthropic Claude and Google Gemini
* Content analysis with 17 SEO checks and 8 readability checks
* XML Sitemap generation with post type and taxonomy support
* Redirect Manager with 301/302 support and 404 monitoring
* Robots.txt Editor with AI crawler and SEO bot blocking
* Schema Generator with 14 schema types and flexible display rules
* Site Connections for 6 webmaster tools
* Open Graph and Twitter Card meta tags
* Search engine preview (SERP simulator)

== Upgrade Notice ==

= 1.0.0 =
Initial release of Metapilot Smart SEO. Install to start optimizing your WordPress site with AI-powered SEO tools.

== Privacy Policy ==

Metapilot Smart SEO respects your privacy:

* The plugin does not collect any personal data from your visitors.
* If you use AI features, your content is sent to your chosen AI provider (Anthropic or Google) for processing. Please review their privacy policies linked in the External Services section above.
* Webmaster verification codes are stored locally in your WordPress database only.
* 404 logs store only URLs and timestamps — no visitor personal information is collected.

== Credits ==

Developed by [Strativ AB](https://strativ.se).

== Minimum Requirements ==

* WordPress 5.8 or higher
* PHP 7.4 or higher
* MySQL 5.6 or higher

= Recommended =

* PHP 8.0 or higher for best performance
* HTTPS enabled site
