Title: Cleotic AI Traffic
Author: cleotic
Published: <strong>June 23, 2026</strong>
Last modified: June 23, 2026

---

Search plugins

![](https://s.w.org/plugins/geopattern-icon/cleotic-ai-traffic.svg)

# Cleotic AI Traffic

 By [cleotic](https://profiles.wordpress.org/cleotic/)

[Download](https://downloads.wordpress.org/plugin/cleotic-ai-traffic.1.0.0.zip)

 * [Details](https://wordpress.org/plugins/cleotic-ai-traffic/#description)
 * [Reviews](https://wordpress.org/plugins/cleotic-ai-traffic/#reviews)
 *  [Installation](https://wordpress.org/plugins/cleotic-ai-traffic/#installation)
 * [Development](https://wordpress.org/plugins/cleotic-ai-traffic/#developers)

 [Support](https://wordpress.org/support/plugin/cleotic-ai-traffic/)

## Description

Cleotic AI Traffic helps site owners understand how AI systems interact with their
site.

The plugin works immediately after activation, without a Cleotic account. In local
mode it records AI-positive events only, such as visits from known AI crawlers and
referrals from AI assistants, then shows the totals in site admin.

If you connect a Cleotic account, the plugin can send signed batches of eligible
traffic events to Cleotic so your site traffic appears alongside your Cleotic AI
traffic analytics.

#### Features

 * Local admin report for AI crawler visits and AI assistant referrals.
 * Optional dashboard widget with recent AI traffic totals.
 * Curated, explainable detection for AI crawler user agents and AI referral sources.
 * Optional Cleotic connection key for signed server-side sync.
 * Optional AI-events-only sync mode.
 * Optional frontend beacon for AI-positive referral capture on cached pages. This
   is off by default.
 * Configurable retention up to 90 days.
 * Uninstall cleanup for plugin tables and options.

#### Local mode

Cleotic AI Traffic is useful without a Cleotic account. When no Cleotic connection
key is configured, the plugin sends nothing to Cleotic or any other external service.
It stores AI-positive evidence locally in your site database and displays it in 
admin.

#### Connected mode

When a Cleotic connection key is configured, the plugin can sync traffic to Cleotic
using signed HTTPS requests. The default sync mode is all eligible pageviews because
it allows Cleotic to calculate AI traffic share. You can choose AI events only if
you prefer a narrower sync mode.

#### Cache limitations

Server-side crawler detection only works when the request reaches PHP. Full-page
caches, CDN caches, and static hosting layers can serve pages before PHP runs, which
means those crawler requests may not be visible to the plugin. The optional frontend
beacon can help capture AI-positive referrals from cached pages, but it cannot detect
crawlers that never execute browser JavaScript.

#### Privacy

Without a Cleotic connection key, this plugin sends no data to Cleotic.

Local mode stores AI-positive event evidence in your site database. Raw visitor 
IP addresses are never sent to Cleotic. Query strings and URL fragments are stripped
from stored URLs and referrers.

When connected, the plugin sends signed HTTPS batches to Cleotic. Depending on your
sync mode, batches may include eligible public pageview details such as URL path,
method, status code, user agent, referrer, timestamp, and page title. Sync uses 
a timestamp-bound HMAC signature.

#### External services

This plugin connects to the Cleotic service only when you add a Cleotic connection
key or use the Test connection button after saving a key. Cleotic AI Traffic does
not send data to Cleotic in local mode.

Cleotic is an AI visibility and AI traffic analytics service provided by General
Dataworks DWC-LLC. The plugin can be used to populate AI traffic analytics for Cleotic
tracked sites.

The service endpoint used is `https://t.cleotic.ai`. When connected, the plugin 
posts signed HTTPS JSON batches to a URL in this format:

    ```
    https://t.cleotic.ai/<site-token>/wordpress
    ```

The site token comes from the Cleotic connection key entered by the site administrator.
The secret part of the connection key is used locally to create an HMAC signature
and is not sent as a separate field.

Each request includes the JSON body, a timestamp header, and an HMAC signature header.
The JSON body includes the site URL, plugin version, WordPress version, PHP version,
selected sync mode, and the event batch. Depending on the selected sync mode, event
batches may include eligible public pageview details such as URL path, HTTP method,
status code, user agent, referrer, UTM source, timestamp, and page title. Query 
strings and URL fragments are stripped from stored URLs and referrers before sync.
Raw visitor IP addresses are not sent to Cleotic by this plugin.

Data is sent when WordPress cron or the manual Sync now action processes queued 
events. The Test connection button sends the same signed request structure with 
an empty event batch to verify that the connection key and endpoint work.

Service website: https://cleotic.ai/

Terms of service / Privacy policy: https://static.clickterm.com/clickwrap/d9ad49df-
902a-494f-8dc6-be5ee2686e6e/latest

## Screenshots

[⌊Cleotic AI Traffic admin overview with date range filters, summary metrics, and
AI traffic charts.⌉⌊Cleotic AI Traffic admin overview with date range filters, summary
metrics, and AI traffic charts.⌉[

Cleotic AI Traffic admin overview with date range filters, summary metrics, and 
AI traffic charts.

[⌊Events log showing AI crawler and AI referral evidence for detected visits.⌉⌊Events
log showing AI crawler and AI referral evidence for detected visits.⌉[

Events log showing AI crawler and AI referral evidence for detected visits.

[⌊Settings panel with local tracking, optional dashboard widget, optional frontend
beacon, and Cleotic connection options.⌉⌊Settings panel with local tracking, optional
dashboard widget, optional frontend beacon, and Cleotic connection options.⌉[

Settings panel with local tracking, optional dashboard widget, optional frontend
beacon, and Cleotic connection options.

## Installation

 1. Upload the plugin files to the `/wp-content/plugins/cleotic-ai-traffic` directory,
    or install the plugin zip through the Plugins screen.
 2. Activate the plugin through the Plugins screen.
 3. Open **Cleotic > AI Traffic**.
 4. Review the local AI traffic report.
 5. Optional: paste your Cleotic connection key and save settings.
 6. Optional: click **Test connection** after saving the connection key.

## FAQ

### Do I need a Cleotic account?

No. The plugin works in local mode without a Cleotic account and stores AI-positive
events locally.

### Does the plugin send data to Cleotic automatically?

No. Nothing is sent to Cleotic unless you configure a Cleotic connection key.

### What happens when I connect Cleotic?

The plugin sends signed batches of traffic events to the connected Cleotic tracking
site. The default sync mode sends all eligible pageviews so Cleotic can calculate
AI traffic share. You can switch to AI events only.

### What is an eligible pageview?

The plugin focuses on public front-end requests and skips admin, AJAX, REST API,
cron, feeds, previews, robots and sitemap routes, non-GET or non-HEAD requests, 
and obvious static or framework paths.

### Can the plugin detect AI crawlers behind a full-page cache or CDN?

Only if the request reaches PHP. If a cache serves the page before PHP runs, server-
side detection will not see that request.

### What does the frontend beacon do?

The optional frontend beacon captures AI-positive referral evidence from browser
visits, which can help on cached pages. It is off by default.

### How long is local data kept?

Retention is configurable up to 90 days.

### What happens on uninstall?

Deleting the plugin removes the local Cleotic database tables and plugin options.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Cleotic AI Traffic” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ cleotic ](https://profiles.wordpress.org/cleotic/)

[Translate “Cleotic AI Traffic” into your language.](https://translate.wordpress.org/projects/wp-plugins/cleotic-ai-traffic)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/cleotic-ai-traffic/),
check out the [SVN repository](https://plugins.svn.wordpress.org/cleotic-ai-traffic/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/cleotic-ai-traffic/)
by [RSS](https://plugins.trac.wordpress.org/log/cleotic-ai-traffic/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.0.0

 * Initial release.
 * Added local AI crawler and AI referral reporting in admin.
 * Added optional dashboard widget.
 * Added optional Cleotic connection key sync.
 * Added signed batched ingest with all-pageview and AI-events-only sync modes.
 * Added optional frontend referral beacon, disabled by default.
 * Added uninstall cleanup for plugin data.

## Meta

 *  Version **1.0.0**
 *  Last updated **11 hours ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.5 or higher **
 *  Tested up to **7.0**
 *  PHP version ** 8.1 or higher **
 * Tags
 * [AI](https://wordpress.org/plugins/tags/ai/)[analytics](https://wordpress.org/plugins/tags/analytics/)
   [crawler](https://wordpress.org/plugins/tags/crawler/)[referrals](https://wordpress.org/plugins/tags/referrals/)
   [traffic](https://wordpress.org/plugins/tags/traffic/)
 *  [Advanced View](https://wordpress.org/plugins/cleotic-ai-traffic/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/cleotic-ai-traffic/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/cleotic-ai-traffic/reviews/)

## Contributors

 *   [ cleotic ](https://profiles.wordpress.org/cleotic/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/cleotic-ai-traffic/)