=== Botpass - AI Crawler Optimizer & GEO ===
Contributors: botpass
Tags: ai, seo, llms.txt, ai crawler, structured data
Requires at least: 6.0
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 2.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Boost AI visibility: Botpass serves clean Markdown, llms.txt and JSON-LD to AI crawlers (ChatGPT, Gemini, Perplexity) and scores your GEO.

== Description ==

**Botpass makes your WordPress content visible, readable and citable by AI.** Search is shifting from "ten blue links" to AI answers. Botpass prepares your content so AI crawlers and Large Language Models (LLMs) can understand and cite it — and tells you how you are doing with an actionable GEO (Generative Engine Optimization) score.

When an AI crawler visits your site, Botpass detects it in real time and serves a clean, machine-readable version of your content (Markdown with structured metadata) instead of heavy HTML. Human visitors keep seeing your normal site.

= ✨ Why Botpass is different =

Most plugins in this space only generate a static `llms.txt` file. Botpass goes further:

* **Real-time AI crawler detection** — identifies AI bots by user-agent and request signals and serves machine-optimized content through content negotiation.
* **Clean Markdown delivery (M2M)** — converts your pages into LLM-friendly Markdown with YAML frontmatter and AI instructions.
* **Structured data (JSON-LD)** — injects Schema.org markup so machines understand entities, authorship and relationships.
* **llms.txt generation** — a complete, standards-aligned index of your content for LLMs.
* **GEO Score** — a per-post score with concrete recommendations to improve how AI engines read and cite you.
* **Fan-out coverage** — anticipates the sub-queries AI engines fan out from a single prompt and prepares your content to answer each one, widening how often you are retrieved and cited.
* **Semantic llms.txt with pillar content** — builds a meaning-aware llms.txt organized around pillar pages and topic clusters, so LLMs understand your site's structure and topical authority, not just a flat list of URLs.

= ⭐ Key features =

* 🕷️ Automatic detection of 50+ AI crawlers, autonomous agents and stealth bots
* 📝 HTML to Markdown conversion optimized for machines
* ⚡ Faster delivery to AI crawlers through intelligent content caching
* 🗂️ llms.txt and llms-full.txt endpoints, plus per-page Markdown
* 🧩 JSON-LD / Schema.org injection
* ✅ Author authority and fact-check signals (EEAT) to reduce AI hallucination
* 🏷️ Enriched metadata (author, categories, tags, language) in the AI output
* 📊 GEO scoring and actionable recommendations per post
* 🎛️ Per-post editorial control to exclude any content from AI optimization
* 🤝 Works alongside your existing SEO plugin
* 🔀 Fan-out coverage to match the sub-queries AI engines generate from a single prompt
* 🧠 Semantic llms.txt with pillar content for topic-cluster authority
* 🪶 Lightweight: heavy processing runs on the Botpass service, not on your server

= ⚙️ How it works (Serviceware) =

Botpass is the official WordPress client for the Botpass service. The plugin detects AI crawlers and delegates content processing (cleaning, Markdown conversion, enrichment and scoring) to the Botpass API. This keeps your site fast and your output always up to date. After installing, choose a Pro or Agency plan (7-day free trial) on our website and connect your API key to link your site to the service. See "External services" below for the data that is processed.

== Installation ==

1. Install the plugin from Plugins → Add New (or upload it to /wp-content/plugins/) and activate "Botpass" through the Plugins menu in WordPress.
2. Select a Pro or Agency plan (7-day free trial) on our website: https://botpass.io.
3. Connect your API key in Botpass → Settings to link your site to the service.

== Frequently Asked Questions ==

= 🤖 What is GEO (Generative Engine Optimization)? =

GEO is the practice of optimizing content so generative AI engines (ChatGPT, Gemini, Perplexity, Claude and others) can find, understand and cite it. Botpass measures and helps you improve your GEO.

= 📄 What is llms.txt? =

llms.txt is a proposed standard file that gives LLMs a clean map of your site's content. Botpass generates and keeps it updated automatically.

= 🕸️ Which AI crawlers are supported? =

Botpass detects 50+ AI crawlers and LLM user-agents across OpenAI, Anthropic, Google, Perplexity, Meta, Apple, Amazon, xAI, DeepSeek, Mistral, Cohere and more — including autonomous agents (ChatGPT-Agent, Operator, Gemini Deep Research) and stealth bots that disguise themselves as regular browsers.

= 🔌 Does it work with Yoast SEO or Rank Math? =

Yes. Botpass complements traditional SEO plugins. They optimize for classic search engines; Botpass optimizes for AI engines and crawlers.

= 👀 Will it change what my human visitors see? =

No. Human visitors see your normal site. Only detected AI crawlers receive the machine-optimized version.

= 🔑 Do I need to create an account or enter an API key? =

Yes. After installing the plugin, select a Pro or Agency plan (7-day free trial) on our website and connect the API key in Botpass → Settings to link your site to the service.

= 🔒 Is my content sent to a third party? =

Yes. Content is processed by the Botpass API to generate the optimized output. See "External services" for exactly what is sent and for links to our Terms and Privacy Policy.

== External services ==

This plugin relies on the Botpass API, a service operated by Botpass, to process and optimize your content for AI crawlers.

What the service does: it receives the content of the pages you choose to optimize and returns machine-readable Markdown, llms.txt, JSON-LD and GEO scoring.

What data is sent and when: when you optimize a post, or when an AI crawler requests a page, the plugin sends the post URL, the post content to be converted, and your site URL, together with your API key for authentication. No WordPress security keys, salts or user passwords are ever transmitted.

Service provi=== Botpass - AI Crawler Optimizer & GEO Optimization ===
Contributors: botpass
Tags: ai, seo, llms.txt, ai crawler, geo optimization
Requires at least: 6.0
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 2.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

GEO Optimization for WordPress: Botpass serves clean Markdown, llms.txt & JSON-LD to AI crawlers (ChatGPT, Gemini, Perplexity) and scores your GEO.

== Description ==

**Botpass makes your WordPress content visible, readable and citable by AI.** Search is shifting from "ten blue links" to AI answers. Botpass prepares your content so AI crawlers and Large Language Models (LLMs) can understand and cite it — and tells you how you are doing with an actionable GEO Optimization score (Generative Engine Optimization).

When an AI crawler visits your site, Botpass detects it in real time and serves a clean, machine-readable version of your content (Markdown with structured metadata) instead of heavy HTML. Human visitors keep seeing your normal site.

= ✨ Why Botpass is different =

Most plugins in this space only generate a static `llms.txt` file. Botpass goes further:

* **Real-time AI crawler detection** — identifies AI bots by user-agent and request signals and serves machine-optimized content through content negotiation.
* **Clean Markdown delivery (M2M)** — converts your pages into LLM-friendly Markdown with YAML frontmatter and AI instructions.
* **Structured data (JSON-LD)** — injects Schema.org markup so machines understand entities, authorship and relationships.
* **llms.txt generation** — a complete, standards-aligned index of your content for LLMs.
* **GEO Score** — a per-post score with concrete recommendations to improve how AI engines read and cite you.
* **Fan-out coverage** — anticipates the sub-queries AI engines fan out from a single prompt and prepares your content to answer each one, widening how often you are retrieved and cited.
* **Semantic llms.txt with pillar content** — builds a meaning-aware llms.txt organized around pillar pages and topic clusters, so LLMs understand your site's structure and topical authority, not just a flat list of URLs.
* **Agency plan with white-label reporting** — request custom reports branded with your agency's logo, built for agencies running GEO Optimization across multiple client sites.

= ⭐ Key features =

* 🕷️ Automatic detection of 50+ AI crawlers, autonomous agents and stealth bots
* 📝 HTML to Markdown conversion optimized for machines
* ⚡ Faster delivery to AI crawlers through intelligent content caching
* 🗂️ llms.txt and llms-full.txt endpoints, plus per-page Markdown
* 🧩 JSON-LD / Schema.org injection
* ✅ Author authority and fact-check signals (EEAT) to reduce AI hallucination
* 🏷️ Enriched metadata (author, categories, tags, language) in the AI output
* 📊 GEO scoring and actionable recommendations per post
* 🏢 Agency plan: request white-label custom reports featuring your agency's logo
* 🎛️ Per-post editorial control to exclude any content from AI optimization
* 🤝 Works alongside your existing SEO plugin
* 🔀 Fan-out coverage to match the sub-queries AI engines generate from a single prompt
* 🧠 Semantic llms.txt with pillar content for topic-cluster authority
* 🪶 Lightweight: heavy processing runs on the Botpass service, not on your server

= ⚙️ How it works (Serviceware) =

Botpass is the official WordPress client for the Botpass service. The plugin detects AI crawlers and delegates content processing (cleaning, Markdown conversion, enrichment and scoring) to the Botpass API. This keeps your site fast and your output always up to date. After installing, choose a Pro or Agency plan (7-day free trial) on our website and connect your API key to link your site to the service. See "External services" below for the data that is processed.

== Installation ==

1. Install the plugin from Plugins → Add New (or upload it to /wp-content/plugins/) and activate "Botpass" through the Plugins menu in WordPress.
2. Select a Pro or Agency plan (7-day free trial) on our website: https://botpass.io.
3. Connect your API key in Botpass → Settings to link your site to the service.

== Frequently Asked Questions ==

= 🤖 What is GEO Optimization (Generative Engine Optimization)? =

GEO Optimization (Generative Engine Optimization) is the practice of optimizing content so generative AI engines (ChatGPT, Gemini, Perplexity, Claude and others) can find, understand and cite it. Botpass measures and helps you improve your GEO.

= 📄 What is llms.txt? =

llms.txt is a proposed standard file that gives LLMs a clean map of your site's content. Botpass generates and keeps it updated automatically.

= 🕸️ Which AI crawlers are supported? =

Botpass detects 50+ AI crawlers and LLM user-agents across OpenAI, Anthropic, Google, Perplexity, Meta, Apple, Amazon, xAI, DeepSeek, Mistral, Cohere and more — including autonomous agents (ChatGPT-Agent, Operator, Gemini Deep Research) and stealth bots that disguise themselves as regular browsers.

= 🔌 Does it work with Yoast SEO or Rank Math? =

Yes. Botpass complements traditional SEO plugins. They optimize for classic search engines; Botpass optimizes for AI engines and crawlers.

= 👀 Will it change what my human visitors see? =

No. Human visitors see your normal site. Only detected AI crawlers receive the machine-optimized version.

= 🔑 Do I need to create an account or enter an API key? =

Yes. After installing the plugin, select a Pro or Agency plan (7-day free trial) on our website and connect the API key in Botpass → Settings to link your site to the service.

= 🔒 Is my content sent to a third party? =

Yes. Content is processed by the Botpass API to generate the optimized output. See "External services" for exactly what is sent and for links to our Terms and Privacy Policy.

= 🏢 Do you offer an Agency plan with white-label reports? =

Yes. The Agency plan is built for agencies and consultants running GEO Optimization for multiple clients. You can request custom, white-label reports featuring your agency's logo to share results with your clients.

== External services ==

This plugin relies on the Botpass API, a service operated by Botpass, to process and optimize your content for AI crawlers.

What the service does: it receives the content of the pages you choose to optimize and returns machine-readable Markdown, llms.txt, JSON-LD and GEO scoring.

What data is sent and when: when you optimize a post, or when an AI crawler requests a page, the plugin sends the post URL, the post content to be converted, and your site URL, together with your API key for authentication. No WordPress security keys, salts or user passwords are ever transmitted.

Service provider: Botpass — https://botpass.io
Terms of Service: https://botpass.io/terms
Privacy Policy: https://botpass.io/privacy

To use the service you create a Botpass account and choose a Pro or Agency plan (7-day free trial) on our website, then connect your API key in the plugin. By using the plugin you agree to the Botpass Terms of Service and Privacy Policy.

== Screenshots ==

1. Botpass dashboard with GEO scores across your content.
2. Per-post GEO score and recommendations.
3. Settings screen with API key and content types.
4. Example of an automatically generated llms.txt.

== Changelog ==

= 2.1.0 =
* New: guided onboarding — install the plugin, choose a Pro or Agency plan (7-day free trial) on our website and connect your API key.
* New: expanded AI crawler dictionary (50+ bots) with autonomous-agent and stealth-bot detection.
* New: author authority and fact-check signals in the machine-readable output to strengthen EEAT and reduce AI hallucination.
* New: enriched metadata (author, categories, tags, language, word count) in the AI output.
* New: llms-full.txt endpoint alongside llms.txt.
* New: per-post editorial control to exclude any post from AI optimization, llms.txt or JSON-LD.
* New: manage your Pro or Agency plan and connect your API key from Botpass → Settings.
* Improvement: faster delivery to AI crawlers through intelligent content caching.
* Security: API key stored encrypted (AES-256); debug headers exposed only when WP_DEBUG is enabled.

= 2.0.0 =
* New: serviceware architecture — all advanced processing is handled by the Botpass API; no plan-gated code ships in the plugin.
* Security: registration token is no longer derived from WordPress AUTH_KEY/salts; it now uses an independent random secret.
* Improvement: all CSS and JavaScript are loaded via wp_enqueue_* functions.
* Improvement: all output is escaped; JSON-LD output hardened.
* Change: Chart.js is now bundled locally instead of loaded from a CDN.
* Docs: readme rewritten in English with full external-services disclosure.

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 2.1.0 =
Adds guided onboarding (Pro/Agency plan with a 7-day free trial and API key connection), broader AI crawler and agent detection, EEAT and fact-check signals, faster cached delivery and security hardening. Recommended for all users.

= 2.0.0 =
Compliance and security update. Adds external-services disclosure, removes the CDN dependency and hardens output escaping. Recommended for all users.der: Botpass — https://botpass.io
Terms of Service: https://botpass.io/terms
Privacy Policy: https://botpass.io/privacy

To use the service you create a Botpass account and choose a Pro or Agency plan (7-day free trial) on our website, then connect your API key in the plugin. By using the plugin you agree to the Botpass Terms of Service and Privacy Policy.

== Screenshots ==

1. Botpass dashboard with GEO scores across your content.
2. Per-post GEO score and recommendations.
3. Settings screen with API key and content types.
4. Example of an automatically generated llms.txt.

== Changelog ==

= 2.1.0 =
* New: guided onboarding — install the plugin, choose a Pro or Agency plan (7-day free trial) on our website and connect your API key.
* New: expanded AI crawler dictionary (50+ bots) with autonomous-agent and stealth-bot detection.
* New: author authority and fact-check signals in the machine-readable output to strengthen EEAT and reduce AI hallucination.
* New: enriched metadata (author, categories, tags, language, word count) in the AI output.
* New: llms-full.txt endpoint alongside llms.txt.
* New: per-post editorial control to exclude any post from AI optimization, llms.txt or JSON-LD.
* New: manage your Pro or Agency plan and connect your API key from Botpass → Settings.
* Improvement: faster delivery to AI crawlers through intelligent content caching.
* Security: API key stored encrypted (AES-256); debug headers exposed only when WP_DEBUG is enabled.

= 2.0.0 =
* New: serviceware architecture — all advanced processing is handled by the Botpass API; no plan-gated code ships in the plugin.
* Security: registration token is no longer derived from WordPress AUTH_KEY/salts; it now uses an independent random secret.
* Improvement: all CSS and JavaScript are loaded via wp_enqueue_* functions.
* Improvement: all output is escaped; JSON-LD output hardened.
* Change: Chart.js is now bundled locally instead of loaded from a CDN.
* Docs: readme rewritten in English with full external-services disclosure.

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 2.1.0 =
Adds guided onboarding (Pro/Agency plan with a 7-day free trial and API key connection), broader AI crawler and agent detection, EEAT and fact-check signals, faster cached delivery and security hardening. Recommended for all users.

= 2.0.0 =
Compliance and security update. Adds external-services disclosure, removes the CDN dependency and hardens output escaping. Recommended for all users.