=== Sightable ===
Contributors: sightable
Tags: seo, ai search, geo, structured data, llms.txt
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 8.1
Stable tag: 0.3.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

See how AI assistants read your site, watch which AI crawlers visit it, and fix what's stopping you from being cited — all from inside WordPress.

== Description ==

ChatGPT, Claude, Perplexity and Google's AI Overviews increasingly answer questions instead of linking to a search results page. Sightable tells you whether your content is the kind those systems can find, quote and cite — and shows you what to change if it isn't.

Unlike a crawler-based scanner that has to guess at your site from the outside, Sightable runs inside WordPress and reads what you have: your real post content, your author records, your categories, and — for the free features below — nothing else. It never sends your content anywhere unless you explicitly turn on a Pro feature that requires it.

= What it does, free =

* **In-editor scoring.** Every post is scored across 8 modules — extractability, query fit, structured data, content authority, technical accessibility, content coverage, entity clarity and conversion clarity — right in the block editor sidebar, and again in the pre-publish checklist. Scoring runs as pure PHP on your own server; nothing is sent anywhere.
* **AI crawler log.** See real visits from GPTBot, ClaudeBot, PerplexityBot, Google-Extended, Bytespider and more, with which pages they reached. Hits are verified with reverse DNS so the numbers reflect confirmed crawlers, not just a spoofable header.
* **robots.txt policy per crawler.** Choose which AI crawlers may access your site, one vendor at a time, instead of one blanket rule for all of them.
* **llms.txt.** A generated, always-current index of your content at `/llms.txt`, the emerging convention several AI systems look for.
* **Structured data you can preview before publishing.** Article, Organization, Person, BreadcrumbList and FAQPage markup assembled from data already on the post. If another SEO plugin (Yoast, Rank Math, All in One SEO) already outputs schema, Sightable merges into its graph instead of publishing a conflicting second one.

= What Pro adds =

Pro features send the specific content you ask about to the Sightable API for AI-powered processing — see "External services" below for exactly what that means.

* AI-written diagnosis for each of the 8 modules, specific to the page.
* One-click FAQ generation from your existing content.
* Answer-first rewrites of an opening paragraph that buries its point.
* AI-generated metadata (title and description).

None of this runs, and no request is ever made, unless you enter a licence key and explicitly trigger it.

= Pricing =

The free edition is free forever, with no account and no limits on sites or posts.

Pro is pay as you go. Buy a credit pack once (Starter: 100 credits for $9, Growth: 500 credits for $39, Scale: 2,000 credits for $129). Credits never expire and are shared across every site in your account. 1 credit = 1 AI action on 1 page. Re-running on unchanged content is free, and failed runs are refunded. New accounts get 20 free credits to try Pro. See https://sightable.io/pricing.php for current prices, or **Sightable → Upgrade to Pro** inside WordPress for a side-by-side comparison.

== External services ==

This plugin's **free features run entirely on your own server** and make no external requests.

Its **Pro features** connect to the Sightable API (a paid service operated by Sightable, hosted independently of WordPress.org) to perform AI-powered analysis and content generation using a third-party language model.

When you use a Pro feature, the following is sent to the Sightable API for the single post you requested it for:

* The post's title, headings, and body text (as plain text, not raw HTML)
* The post's existing meta description and structured data types, if any
* Nothing is sent for any other post, and nothing is sent automatically — only when you click a Pro action on a specific post.

This only happens if you have entered a licence key and activated Pro. With no licence key entered, the plugin makes zero external requests.

By using a Pro feature you agree to the Sightable [Terms of Service](https://sightable.io/terms.php) and [Privacy Policy](https://sightable.io/privacy.php).

== Installation ==

1. Upload the plugin to `/wp-content/plugins/` or install it through the WordPress admin.
2. Activate it.
3. Open any post or page — the Sightable score appears in the editor sidebar automatically.
4. Visit **Sightable → Settings** to review what's enabled, and **Sightable → AI Crawlers** to see crawler activity as it comes in.

== Frequently Asked Questions ==

= Does this conflict with Yoast SEO / Rank Math / All in One SEO? =

No. Sightable detects which SEO plugin you're running and merges its generated structured data into that plugin's own output rather than publishing a second, potentially conflicting one. If you don't run an SEO plugin, Sightable publishes its own.

= Will this slow my site down? =

The free scoring engine only runs in the editor (an admin-only REST request) and once when a post is saved — visitors never trigger it. Crawler logging runs a lightweight check on the User-Agent header early in each request; verification (reverse DNS) is deferred to a background task rather than done on the live request.

= What if I use a caching plugin? =

Some full-page caching plugins (WP Rocket, LiteSpeed Cache, W3 Total Cache and others) can serve a page before WordPress — and this plugin — ever runs, which means a crawler hit served from cache goes unrecorded. Sightable detects this and shows a clear warning on the AI Crawlers screen, along with the specific setting to exclude AI bot user agents from your cache.

= Is my data sent anywhere? =

Not by the free features, ever. Pro features send only the specific post you request AI analysis for — see "External services" above.

== Screenshots ==

1. The Sightable score in the block editor sidebar.
2. The AI crawler activity dashboard.
3. Structured data preview before publishing.

== Changelog ==

= 0.3.1 =
* "Get 20 free credits" now opens the free sign-up page directly (it used to open the pricing page, which had no sign-up link).

= 0.3.0 =
* Renamed to Sightable. The download is now sightable-wp.zip; existing installs update in place and keep their settings.
* New: AI Citation Monitor. Track whether ChatGPT, Perplexity and Gemini mention or link to your site for the questions you choose, with a weekly trend. A separate monthly add-on, not part of Pro credits; one free check included.
* New: Bulk optimize. Select many posts (or use the Bulk actions menu on Posts and Pages) and run structured data, title and description, answer-first opening and FAQ fixes in the background. Every change is a revision, and a whole batch can be undone in one click.
* New: Before/after report. Readiness score change and AI crawler visit change for the pages you optimized, per period or per batch, printable as a PDF.
* Credit packs updated: 100 credits $9, 500 credits $39, 2,000 credits $129.

= 0.2.0 =
* Renamed to AI Sightable.
* New Free vs Pro screen with credit pricing.
* Clearer upgrade paths in the editor, dashboard and Settings.

= 0.1.0 =
* Initial release: 8-module local scoring, AI crawler logging with reverse-DNS verification, per-crawler robots.txt policy, llms.txt generation, and deterministic structured data with SEO plugin compatibility.
