=== RankBotAI – AI SEO Optimizer for RankMath & Yoast ===
Contributors: ksanyok
Tags: seo, ai, woocommerce, rankmath, yoast
Requires at least: 5.8
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AI-powered SEO optimizer that enhances Rank Math & Yoast SEO — automated meta tags, focus keywords, content optimization, bulk processing, and 24/7 SEO scoring powered by advanced AI.

== Description ==

**RankBotAI** is a next-generation, AI-powered SEO optimization plugin for WordPress. It works as an intelligent assistant that enhances your existing SEO workflow — whether you use **Rank Math**, **Yoast SEO**, or no SEO plugin at all.

Unlike traditional SEO tools that only *analyze* your content, RankBotAI actively **generates and improves** your SEO data using the latest AI models — including GPT-5, GPT-4o, and our own free RankBot AI model.

= Why RankBotAI? =

SEO optimization is time-consuming and requires expertise. RankBotAI automates the most tedious parts while delivering professional-grade results:

**⚡ AI vs. Manual SEO — Speed Comparison**

| Task | SEO Specialist | RankBotAI |
|------|---------------|----------|
| Optimize 1 product page | 15–30 min | ~10 sec |
| Research & set focus keywords (100 pages) | 2–3 days | ~20 min |
| Write meta titles & descriptions (100 pages) | 1–2 days | ~15 min |
| Full SEO audit + optimization (500 pages) | 2–4 weeks | ~2 hours |
| Bulk optimize entire WooCommerce catalog | Weeks/Months | Hours |
| Availability | Business hours | 24/7/365 |

**💰 Cost Comparison**

| | Freelance SEO | Agency | RankBotAI |
|---|---|---|---|
| Monthly cost (100 pages/mo) | $500–$2,000 | $2,000–$10,000 | From $0 (free tier) |
| Per-page optimization | $5–$20 | $10–$50 | ~$0.01–$0.15 |
| Speed to results | Days–Weeks | Weeks | Minutes |
| Works 24/7 | No | No | Yes |
| Consistent quality | Varies | Varies | Always consistent |

= Key Features =

* **AI-Powered Meta Generation** — Automatically generate optimized SEO titles, meta descriptions, and focus keywords
* **Smart Focus Keyword Research** — AI analyzes your content and suggests the best focus keyword
* **100-Point SEO Scoring** — Real-time SEO analysis with actionable recommendations
* **Rank Math & Yoast Integration** — Reads and writes SEO fields for Rank Math, Yoast SEO, and AIOSEO
* **Bulk Optimization** — Process hundreds of pages in the background via WP-Cron
* **WooCommerce Ready** — Optimized for products, categories, and product taxonomies
* **Content Optimization** — AI can improve your post/product content for better SEO
* **Backup & Restore** — Creates snapshots before changes, restore with one click
* **Multiple AI Models** — Choose from GPT-5, GPT-4o, or the free RankBot AI model
* **Optimization History** — Track every optimization with detailed logs
* **Admin Bar Widget** — Quick balance check and active job monitoring
* **Gutenberg Sidebar** — SEO score and quick actions right in the block editor
* **SEO Checklist** — Real-time checklist in post editor: title length, meta description, images, internal links
* **llms.txt Generator** — Create and manage llms.txt for AI search engine visibility
* **Dashboard Widget** — SEO health overview on WordPress main dashboard
* **Multilingual** — Supports English, German, Spanish, Polish, Russian, and Ukrainian

= How It Works =

1. Install and activate the plugin
2. Connect your site to the RankBotAI service (free account)
3. Start optimizing — click "Auto Optimize" on any post, or launch bulk processing
4. AI generates optimized SEO data and applies it to your content
5. Your SEO fields in Rank Math / Yoast are updated automatically

= Works Great With =

* **Rank Math SEO** — Full integration: reads/writes focus keywords, meta titles, and descriptions
* **Yoast SEO** — Full integration: reads/writes focus keywords, meta titles, and descriptions
* **All in One SEO (AIOSEO)** — Basic integration for meta fields
* **WooCommerce** — Optimized for products with enhanced Product JSON-LD schema
* **Works standalone** — If no SEO plugin is installed, RankBotAI stores data in its own meta fields

== Compatibility ==
RankBotAI is designed to work alongside other SEO plugins.

It can read/write common SEO fields used by:
* Yoast SEO
* Rank Math
* All in One SEO

Notes:
* RankBotAI does not disable other SEO plugins.
* If multiple plugins manage the same meta fields, the "last saved" value wins (standard WordPress behavior).
* For best results, we recommend having either Rank Math or Yoast SEO active.

== External Services ==
This plugin connects to an external API service (RankBotAI) to generate SEO suggestions and optimizations.

Service provider:
* RankBotAI: https://rankbotai.link
* BuyReadySite (support/maintenance): https://buyreadysite.com

Service policies:
* Privacy Policy: https://rankbotai.link/privacy
* Terms of Service: https://rankbotai.link/terms

API base URL used by the plugin:
* https://rankbotai.link

The plugin sends requests to the service when you:
* Connect your site (registration/verification)
* Request generation/optimization (for posts, products, and terms)
* View your RankBot history/balance/models/plans (service data)
* Poll background jobs (queued optimizations)

Data sent to the service can include (depending on the action you trigger):
* Your site URL (domain) and basic environment info (WordPress version, plugin version)
* A site connection key (Bearer token) stored in your WordPress database
* Post/product/term data you choose to optimize, such as title, permalink, excerpt, and content (including HTML)
* Existing focus keyword (if present), categories/tags, and basic WooCommerce product attributes (e.g. price, currency, SKU)
* Image IDs/context for generating alt text (if enabled by the optimization action)

Endpoints used by the plugin include:
* POST /api/v1/site/register
* POST /api/v1/site/verify
* GET  /api/v1/balance
* GET  /api/v1/plans
* GET  /api/v1/models
* GET  /api/v1/history
* POST /api/v1/generate
* POST /api/v1/jobs/check
* POST /api/v1/internal/run-job

Please review the RankBotAI website for service terms and privacy information:
* https://rankbotai.link/privacy
* https://rankbotai.link/terms

== Pricing / Tokens ==
RankBotAI uses a token-based service.

* A free tier is available with monthly free tokens and access to the RankBot AI (OSS) model.
* Paid subscriptions unlock premium AI models (GPT-5, GPT-4o, etc.) and higher token limits.
* Pay As You Go option available — top up tokens as needed.
* Billing and plan management happens on the service website (not inside WordPress).

== Data Storage ==
The plugin stores:
* A site connection key in WordPress options (used to authenticate API requests)
* Optimization history and SEO score data in post/term meta
* Background job tracking data in custom database tables (wp_rankbot_jobs, wp_rankbot_bulk_queue)

== Installation ==
1. Upload the plugin folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. **(Recommended)** Install and activate Rank Math SEO or Yoast SEO for the best experience.
4. Go to the RankBotAI menu in wp-admin and connect your site.
5. Start optimizing your content!

== Screenshots ==
1. RankBotAI dashboard and connection status.
2. Editor integration: quick actions and SEO score.
3. Bulk optimization screen.
4. SEO analysis panel and recommendations.
5. History and backups (restore previous state).

== Frequently Asked Questions ==

= Does this plugin require an external service? =
Yes. The plugin connects to the RankBotAI service API to generate SEO suggestions and optimizations. A free tier is available.

= What data does the plugin send to the API? =
It sends only the data needed for the action you trigger. This can include your site URL, environment info (WordPress/plugin version), and the post/product/term content you request to optimize.

= Does RankBotAI work with Yoast SEO / Rank Math? =
Yes! RankBotAI is specifically designed to complement Rank Math and Yoast SEO. It reads existing SEO data from these plugins and writes optimized values back to them.

= Can I use RankBotAI without Rank Math or Yoast? =
Yes. RankBotAI works standalone and stores SEO data in its own meta fields. However, for the best SEO results, we recommend pairing it with Rank Math or Yoast SEO.

= Is this plugin free? =
The plugin is free and GPL-licensed. The RankBotAI service provides a free token tier and offers paid plans for additional usage and premium AI models.

= Does the plugin store any content backups? =
Yes. Before applying optimization changes, the plugin creates a backup snapshot so you can restore if needed.

= How fast is the optimization? =
Most single-page optimizations complete in 5–15 seconds. Bulk optimization of 100+ pages typically finishes within 15–30 minutes using background processing.

= What AI models are available? =
The free tier includes the RankBot AI model. Paid plans unlock GPT-5, GPT-5 Mini, GPT-4o, o3 Mini, and other premium models.

= Does RankBotAI modify my content? =
Only if you explicitly enable content optimization in settings. By default, RankBotAI only updates SEO meta fields (title, description, focus keyword). Content changes require opt-in.

== Changelog ==

= 1.2.0 — 2026-02-17 =
* NEW: llms.txt Generator — create and manage llms.txt file for AI search engine visibility
* NEW: WordPress Dashboard Widget — SEO health overview with average score, missing meta descriptions, and keyword coverage
* NEW: SEO Checklist in post editor sidebar — real-time checks for title length, meta description, focus keyword, content length, image alt text, and internal links
* NEW: Toast notification system — beautiful slide-in notifications replacing standard WordPress notices
* NEW: CSS Design Tokens — unified design system with CSS custom properties for consistent theming
* NEW: Card entrance animations — smooth fade-in animations for dashboard and bulk page elements
* UI: Modernized visual appearance across all admin pages
* Various code quality improvements

= 1.1.0 — 2026-02-16 =
* Added SEO plugin detection — recommends installing Rank Math or Yoast SEO if not present
* Improved compatibility with Rank Math and Yoast SEO field handling
* Enhanced plugin stability and error handling
* Updated AI model pricing and availability
* Improved bulk processing reliability with adaptive concurrency
* Added comparison data for SEO specialist vs AI optimization
* Extended plugin description and FAQ
* Version synchronization fix (header and constant now match)
* Various bug fixes and performance improvements

= 1.0.1 — 2026-02-10 =
* Minor stability improvements.

= 1.0.0 — 2026-02-01 =
* Initial release.
