=== Crawlit — AI Search Visibility ===
Contributors: crawlit
Tags: seo, ai, visibility, geo, search
Requires at least: 6.0
Tested up to: 6.7
Requires PHP: 8.0
Stable tag: 1.0.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Connect your WordPress site to Crawlit.eu and monitor your AI search visibility score directly from your dashboard.

== Description ==

Crawlit is an AI Search Visibility Platform that helps businesses appear inside AI-generated answers from ChatGPT, Claude, Perplexity, Gemini, and Google AI Overviews.

This plugin connects your WordPress site to your Crawlit account so you can:

* Run AI visibility scans with one click from your WordPress admin
* View your overall AI Visibility Score and per-pillar breakdown in a dashboard widget
* Automatically scan when you publish new content
* Schedule daily scans to track score changes over time
* Jump directly to your full Crawlit report for detailed findings and recommendations

**Pillars analysed:**

* AI Crawlability & Indexing — checks whether AI bots (GPTBot, ClaudeBot, Perplexity, etc.) can access your site
* GEO / Entity Visibility — validates your local schema, NAP consistency, and entity signals
* AI Readability & SEO — scores title tags, meta descriptions, heading hierarchy, and semantic clarity
* Structured Data — audits your JSON-LD schemas for completeness and citation potential
* Security & Trust — checks HTTPS headers and TLS configuration

A Crawlit Plus or Pro account is required to use the API. Sign up at [crawlit.eu](https://crawlit.eu).

== Installation ==

1. Upload the `crawlit` folder to your `/wp-content/plugins/` directory, or install via the WordPress plugin installer.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Go to **Settings → Crawlit** and enter your API key.
4. Click **Run Scan Now** to trigger your first AI visibility scan.

== Frequently Asked Questions ==

= Do I need a Crawlit account? =

Yes. You need a Crawlit account on the Plus or Pro plan to use the API. Free accounts do not have API access. You can sign up and upgrade at [crawlit.eu/pricing](https://crawlit.eu/pricing).

= Where do I get an API key? =

Log in to your Crawlit account and go to **Dashboard → API Keys**. Generate a new key and paste it into the plugin settings under **Settings → Crawlit**. Your key starts with `cs_`.

= Is my API key stored securely? =

Your API key is stored in the WordPress options table (standard WordPress practice). It is never logged, never output in HTML, and is only sent over HTTPS to the Crawlit API.

= How often are scans run automatically? =

If you enable **Auto-scan on publish**, a scan is triggered when you publish a post or page (rate-limited to once per hour). If you enable **Daily scheduled scan**, a scan runs once per day via WP-Cron. You can also run a scan manually at any time from the settings page.

= What URL is scanned? =

By default your site's home URL is scanned. You can change this in **Settings → Crawlit** under "Site URL to scan".

== Changelog ==

= 1.0.0 =
* Initial release. Manual scan trigger, auto-scan on publish, daily WP-Cron scan, dashboard widget with score circle and pillar bars, admin settings page with live status polling.
