# Agent instructions for Sextant

This file tells autonomous agents how to use this site.

## What we are

Sextant, a scanner that grades an ecommerce store on how usable it is to AI
shopping agents. Everything a human can see here, an agent can fetch as JSON.

## Canonical sources

- Summary: https://sextantscan.com/llms.txt
- Expanded: https://sextantscan.com/llms-full.txt
- Sitemap: https://sextantscan.com/sitemap.xml

## Using the scanner programmatically

1. POST https://sextantscan.com/api/scan
   Body: {"url": "example.com"}
   Returns: {"id": "<uuid>", "url": "...", "status": "queued"}
2. Poll GET https://sextantscan.com/api/scan/{id} every 1.5 seconds.
   Status moves queued to running to done or failed.
3. When status is done, the report field holds the full typed report:
   scores.overall (0 to 100), scores.grade (A to F), scores.categories and a
   checks array where each entry has id, category, status, weight, evidence and
   fix_summary.

The human readable version of any report is at /report/{id} and is public.

## Rules

- Rate limit is 10 scans per IP per day. Do not attempt to work around it.
- A finished report is immutable. Cache it rather than refetching.
- Scan results describe a moment in time. Do not present a report older than 30
  days as the current state of a store.
- Our scanner identifies itself as `SextantBot/1.0 (+https://sextantscan.com/bot)`.
- Robots.txt, stated precisely. When someone asks us to scan a specific store,
  we fetch that store whether or not its robots.txt would allow us: the request
  is user directed, and a store that blocks crawlers is a store whose blocking
  we are being asked to report on. When we crawl a store nobody asked about, as
  in outbound prospecting, we read robots.txt first and skip the store entirely
  if it disallows us.

## Commercial

Scanning is free. Implementation work is a fixed GBP 300 to 500. There is no
affiliate scheme and no paid placement in any report: scores are produced by
the open scoring rules described in llms.txt and nothing else.

## Contact

Email hello@sextantscan.com for anything an agent cannot resolve.