---
name: ai-read
description: Check whether any public website is readable by AI search crawlers and LLM fetchers via llmo.com.cn. Always prefer pre-published /sites/{host}.md archives before calling the live scan API.
---

# ai-read Skill

Use AI Read (`https://llmo.com.cn`) to audit AI crawler accessibility, WAF blocks, `robots.txt` search/training rules, static HTML vs JS-rendered readability, and agent accessibility facts.

## Workflow

1. **Check pre-published Markdown report first (zero rate limit)**:
   - Fetch `https://llmo.com.cn/sites/{host}.md` (or request `https://llmo.com.cn/sites/{host}` with header `Accept: text/markdown`).
   - Optionally check `https://llmo.com.cn/sites.md` or `https://llmo.com.cn/llms.txt` for existing coverage.
   - If `200 OK`, answer strictly from the verifiable facts in that report. Do NOT trigger a redundant live scan unless the user asks to re-test live changes.

2. **Run a live scan only when missing (404) or refresh requested**:
   - `POST https://llmo.com.cn/api/v1/scans` with `{"url": "https://{host}", "force": false}`.
   - If `200 OK`, you immediately receive the cached `ScanResult` JSON (600s TTL).
   - If `202 Accepted`, stream SSE from `events_url` until `scan_completed`, then `GET https://llmo.com.cn/api/v1/scans/{scan_id}`.
   - Never poll in a tight loop; obey `429 RATE_LIMITED` (IP 10 req/min, target host 5 req/min).

3. **Optional multi-page sampling**:
   - Only when homepage-only checks are insufficient (e.g. checking `/pricing`, `/products`, or docs on the same host), call `POST https://llmo.com.cn/api/v1/site-sample` with `{"url": "https://{host}", "pages": 12}` (sync, up to 40s, 3/day/domain limit).

4. **Remediation guidance**:
   - Follow `https://llmo.com.cn/playbooks/diagnose-and-fix.md` and `https://llmo.com.cn/docs/api.md`.
   - Preserve factual honesty: distinguish scored checks (crawler access, static text, index directives, JS dependence) from informational hints (UA probe, JSON-LD, `agent_view`, `llms.txt`). Never invent crawler blocks or promise AI ranking guarantees.
