=== Arb AI SEO — High-Quality Auto Link Builder ===
Contributors: arbsbuy
Tags: seo, internal links, ai, schema, rankmath, openai, claude, gemini
Requires at least: 5.8
Tested up to: 6.7
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later

AI-powered, white-hat internal link builder + FAQ schema. Works with Claude (Anthropic), OpenAI (ChatGPT) or Google Gemini. RankMath-aware, fully reversible.

== Description ==

This plugin uses the AI provider of YOUR choice to intelligently build HIGH-QUALITY
**internal** links and structured data — the safe, white-hat side of SEO that you
fully control. It does NOT create spammy external backlinks (the low-quality kind
that gets sites penalised by Google).

= What it does =
* **AI Internal Link Builder** — the AI reads each post, picks natural anchor
  phrases that already exist in the text, and links them to the most relevant
  internal page. You review and approve before anything goes live.
* **Non-destructive** — approved links are applied at render time via `the_content`.
  Your stored post content is never modified, so removing a link is instant and safe.
* **AI FAQ Schema** — generates FAQPage structured data from your content.
* **RankMath / Yoast aware** — "Gap-filler" mode (default) never duplicates the
  schema your SEO plugin already outputs. "Full takeover" mode is available if you
  deliberately disable your SEO plugin's schema.
* **Multi-provider** — Anthropic Claude, OpenAI (ChatGPT), or Google Gemini.
* **Universal** — works on any WordPress / WooCommerce site.

= Why internal links and not "auto backlinks"? =
There is no plugin that can create genuine high-quality EXTERNAL backlinks — those
come from other websites choosing to link to you. Tools that claim to "auto-build
backlinks" produce spam that Google's SpamBrain/Penguin systems penalise. This
plugin focuses on what is genuinely high-impact AND fully in your control: smart
internal linking and structured data.

== Installation ==
1. Upload the `arb-ai-seo` folder to `/wp-content/plugins/`.
2. Activate the plugin.
3. Go to **Arb AI SEO** in the admin menu, choose a provider, paste its API key,
   and click **Test connection**.
4. Edit any post/page/product → use the **Arb AI SEO** box to generate, review and
   approve internal links and FAQ schema.

== Frequently Asked Questions ==

= Will this conflict with RankMath? =
No. Internal linking does not touch RankMath. For schema, the default "Gap-filler"
mode only adds FAQ schema that RankMath does not auto-generate, so there is no
duplication.

= Can I disable RankMath schema and let this plugin handle it? =
Yes — switch Schema mode to "Full takeover" AND turn off RankMath's schema. Only do
both together, or you will get duplicate schema, which hurts SEO. Gap-filler is
recommended for best results with zero risk.

= Does it modify my content? =
No. Links are injected at render time. Your database content is untouched.

== Changelog ==
= 1.0.0 =
* Initial release: multi-provider AI internal link builder, AI FAQ schema,
  RankMath-aware schema modes, render-time (reversible) link application.
