=== RankCue ===
Contributors: thecodearena
Tags: seo, ai, claude, gemini, groq, local seo, schema
Requires at least: 6.0
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 1.2.1
License: GPLv2 or later

AI-powered SEO assistant for WordPress, built on Claude by Anthropic.

== Description ==

RankCue helps you improve rankings by fixing on-page SEO and improving content, with you approving every change.

**Content Optimizer (in the page editor)**
* Live SEO score out of 100 with a checklist: keyword in title, H1, intro, subheadings, meta description and URL; keyword density; word count; heading structure; title vs H1 duplication; image alt text; internal links; readability; local area mentions.
* Google search result preview with character counters.
* AI keyword suggestions (focus, secondary, local variants, questions people search).
* AI title and meta description (3 options, one click to apply).
* AI content review: top fixes, missing topics, related terms (with which ones you already use), unanswered questions and trust signals.
* AI FAQ generator that inserts the FAQ section and adds FAQ schema.
* AI "expand thin content" drafts new sections in your brand voice.
* AI introduction writer and paragraph rewriter.
* AI internal link suggestions from your own published pages.

**Site Audit**
* Crawls your published pages and finds duplicate titles, title = H1, missing H1, multiple H1, missing or duplicate meta descriptions, thin pages, noindex pages, images missing alt text, low text-to-HTML ratio and broken external links.
* Separates real broken links from social sites that block bots (common false positives in Semrush).
* Detects the "Discourage search engines" setting.
* One-click AI fix for titles and descriptions, unique across the site.

**Image Alt Text**
* Claude looks at each image and writes accurate alt text. Review and save one by one or in bulk.

**Schema**
* LocalBusiness (home page), Service (per page) and FAQPage JSON-LD.

**Safety**
* Nothing is published automatically. Every AI change is a suggestion you apply.
* Full change history with one-click undo.
* Monthly AI request limit and token usage counter.
* Works alongside Yoast SEO, Rank Math and SEOPress by reading and writing their title and description fields.

== Installation ==

1. Plugins → Add New → Upload Plugin → choose rankcue.zip → Install → Activate.
2. Go to SEO AI → Settings.
3. Choose an AI connection:
   * Claude app (default, free with Claude Pro): each AI button gives you a prompt to paste into claude.ai; you paste the answer back.
   * Google Gemini API (free tier): get a key at https://aistudio.google.com/apikey. One click, reads images for alt text.
   * Groq API (free tier): get a key at https://console.groq.com/keys. One click, very fast.
   * Anthropic API (paid): key from https://console.anthropic.com.
   For API options: paste the key, Save, then click "Test connection".
4. Fill in your business details (same name, address and phone as your Google Business Profile).
5. Go to SEO AI → Site Audit → Start scan.
6. Open any page and use the RankCue box below the editor.

== Frequently Asked Questions ==

= Can I use my Claude Pro subscription? =
Yes, with Claude app mode (the default). The plugin prepares each prompt; you paste it into claude.ai and paste the answer back. It uses your normal Claude plan limits and costs nothing extra. The plugin never logs in to your Claude account.

If you want one-click automatic results and bulk actions, switch to API mode, which needs an Anthropic API key billed separately per use.

= Which model should I pick? =
Gemini: Gemini 3.5 Flash (default) is reliable on the free tier; Flash-Lite has the highest free limits. Groq: Llama 3.3 70B for writing. Anthropic: Claude Sonnet 5. If a model stops working (providers retire models), click "Show models available to my key" in Settings and pick another.

= Are Gemini and Groq really free? =
Both have free tiers with per-minute and daily limits, no card needed. If you hit a limit you'll see a message; wait a minute (or until tomorrow for daily limits). Bulk alt text pauses a few seconds between images to stay within limits. Note: Google may use free-tier Gemini prompts to improve its products, so don't send private information.

= Will this rank my site automatically? =
No plugin can guarantee rankings. This plugin fixes on-page issues and helps you write better, more complete content, which is what you control. Reviews, your Google Business Profile and backlinks also matter.

= Does it send my content anywhere? =
In Claude app mode the plugin sends nothing; you choose what to paste into Claude. With an API provider (Gemini, Groq or Anthropic), only when you click an AI button: the page text (or the image, for alt text) is sent to that provider to generate the suggestion. The score, checklist and audit run entirely on your server.

= The audit says "analysed from saved content". =
Your host blocks the site from requesting its own pages. Results are still useful but approximate for those pages.

== Changelog ==

= 1.2.1 =
* When Gemini or Groq is busy, the plugin retries automatically and falls back to a lighter Gemini model.

= 1.2.0 =
* Added Google Gemini and Groq as AI providers (free tiers).
* "Show models available to my key" helper in Settings.
* Friendlier rate-limit and model errors; bulk alt text paces itself on free tiers.

= 1.1.0 =
* New Claude app mode: use your Claude Pro plan with copy/paste, no API key needed. This is now the default.

= 1.0.0 =
* First release.
