litespeed/set-crawler-state enables or disables one crawler variant by index, as reported by litespeed/list-crawlers.
An index that does not exist is refused with unknown_crawler and the valid indexes.
At a glance
| Ability | litespeed/set-crawler-state |
| Toolset | LiteSpeed Cache — toolset/litespeed |
| Group | LiteSpeed Cache › The Crawler |
| Requires | LiteSpeed Cache, active on the site |
| Capability | manage_options |
| Safety | Writes data |
| Repeatable | Idempotent — running it twice leaves the same result |
| Ships in | AcrossAI Abilities Manager 0.0.34 and later |
How it works
Indexes are positional. They are derived from the current configuration, which means a change to the simulated roles or cookies renumbers everything — and an index that was variant three yesterday can be variant five today.
Without the check, disabling by a stale index would silently disable the wrong variant, or nothing at all, and report success either way. Refusing with the valid set turns that into something a caller can recover from in one step.
Disabling variants is the usual way to bring a crawl within what a server can carry. The logged-out variant warms the pages most visitors see; the role-specific ones warm copies that only a handful of people will ever request, and on a small site they can cost more than they save.
Idempotent, and it takes effect on the next run rather than interrupting one in progress.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
index | integer | Yes | The crawler index, from litespeed/list-crawlers. |
enabled | boolean | Yes | Whether this variant runs. |
What comes back
| Name | Type | What it is |
|---|---|---|
index | integer | The variant changed. |
enabled | boolean | Its state afterwards. |
success | boolean | Whether the call completed. |
message | string | A one-line summary of what happened, suitable for showing a human. |
error_code | string | Present only on failure — a stable machine-readable reason, such as a missing field, a wrong field type or an unmet confirmation. |
Example
Ask your assistant:
Turn off the mobile crawler variant.
It resolves to one call:
{
"ability": "litespeed/set-crawler-state",
"parameters": {
"index": 2,
"enabled": false
}
}Worth knowing
- Read the list first. Indexes shift when the configuration changes.
- An unknown index is refused with the valid ones listed.
- Takes effect on the next run; it does not stop a crawl in progress.
- Idempotent.
Related abilities
- List Crawlers — get the current indexes
- Get Crawler Status — see which variant is running
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category