30 days free. No credit card. Full access from the moment you connect your site.

Start free trial

Reset The Crawl Position

litespeed/reset-crawler resets the crawl position, so the next run starts at the beginning of the sitemap instead of resuming.

It discards progress, not data. Nothing cached is lost.

At a glance

Abilitylitespeed/reset-crawler
ToolsetLiteSpeed Cache — toolset/litespeed
GroupLiteSpeed Cache › The Crawler
RequiresLiteSpeed Cache, active on the site
Capabilitymanage_options
SafetyWrites data
RepeatableIdempotent — running it twice leaves the same result
Ships inAcrossAI Abilities Manager 0.0.34 and later

How it works

The crawler stores where it got to so a run picks up rather than starting over. That is right almost always, and wrong in one specific case: when the sitemap itself changed.

A stored position is an index into the old map. After the sitemap is regenerated, that index points somewhere arbitrary in the new one — so the crawler resumes in the middle, and the pages before that point are never visited on this pass.

Resetting after a sitemap change is therefore not housekeeping, it is correctness. The same applies after changing the crawler configuration in a way that changes the variant set.

It is also the fix for a crawl that is stuck: a position that points at a URL the crawler cannot get past will keep failing at exactly the same place every cycle.

Idempotent, and cheap.

Input

This ability takes no input.

What comes back

NameTypeWhat it is
resetbooleanWhether the position was reset.
successbooleanWhether the call completed.
messagestringA one-line summary of what happened, suitable for showing a human.
error_codestringPresent 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:

We changed the sitemap — make the crawler start over.

It resolves to one call:

{
  "ability": "litespeed/reset-crawler",
  "parameters": {}
}

Worth knowing

  • Discards progress only. No cached page is affected.
  • Necessary after a sitemap change, not merely tidy.
  • The fix for a crawl that fails at the same place every cycle.
  • Idempotent.

Related abilities


Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager

Browse the rest: Every ability, by category


Keep reading