# Siteline

> Siteline is a public scanner for agent accessibility and machine usability. It evaluates whether a website presents a usable public path for AI agents acting on behalf of humans. It scores four pillars: Signal, Navigate, Absorb, and Perform. Every scan is a composite of three views: an attributed Cloudflare Agent Readiness protocol baseline (informational, never feeds the grade), Siteline's SNAP quality judgment, and conformance checks against open agent-web standards (Graceful Boundaries, GuideCheck). Cloudflare tells you the files exist. Siteline tells you whether they help an agent, and whether you conform to the open standards agents rely on.

## Primary pages

- Home: https://siteline.to/
  Public scanner with live scan form. Type a URL, get a grade with pillar scores, findings, remediation guidance, and confidence levels.

- Results: https://siteline.to/results/{domain}
  Server-rendered result page for any previously scanned domain. Returns the most recent scan with full OG meta tags for social sharing. Also accepts result IDs: /results/{domain-slug}-{YYYYMMDD} for homepage scans and /results/{domain-slug}-{path-scope}-{hash}-{YYYYMMDD} for path/query scoped scans.

- Services: https://siteline.to/services/
  Current general-purpose services: free scan, monitoring & alerts ($19/mo), full audit ($899), and site ontology workshop ($2,499). Contextual paid offer: white-label reports ($499/mo). Hosted API keys and higher quotas are not self-serve yet; ask via https://siteline.to/contact/?topic=api.

- Monitoring: https://siteline.to/monitoring/
  Strong monitoring for one public website. $19/mo with an annual discount available, plus a monthly agentic-web landscape and tips newsletter.

- White-Label Reports: https://siteline.to/white-label/
  Branded, client-ready Siteline reports for agencies and consultants. $499/mo founding agency subscription.

- White-Label Report Link Builder: https://siteline.to/white-label/report-link/
  Helper for generating client-ready report links with agency name and accent color.

- Full Audit: https://siteline.to/audit/
  Detailed scope, pricing, and next steps for the paid audit service.

- Site Ontology Workshop: https://siteline.to/workshop/
  Detailed scope for the facilitated workshop on site structure and taxonomy.

- About: https://siteline.to/about/
  What Siteline is, who it is for, what agents can use today, roadmap, and rate limit transparency.

- History: https://siteline.to/history/
  Verifiable timeline of Siteline and the agent-readiness scanner category: live since 2026-03-19, category context, competitor links, and the design decisions behind two-layer scoring.

- FAQ: https://siteline.to/faq/
  Answers practical questions about what Siteline measures, what it does not measure, and how to interpret the result.

- Contact: https://siteline.to/contact/
  Contact form for questions, feedback, or general inquiries.

- Terms: https://siteline.to/terms/
  Terms of service for using Siteline.

## API endpoints

- Scan: GET /api/scan?url={url}
  Runs a scan and returns a structured evaluation. One scan per submitted URL scope per calendar day. Repeat requests for the same scope return the cached result. Rate limit: 10 per IP per hour.

- Result lookup: GET /api/result?id={resultId or domain}
  Retrieves a stored scan result by result ID (e.g., example-com-20260321 or example-com-pricing-a1b2c3d4-20260321) or by domain (e.g., example.com). Returns the most recent unexpired result for domain lookups. Rate limit: 60 per IP per minute.

- OG image: GET /api/og?domain={domain}&grade={grade}&score={score}&label={label}
  Generates a 1200x630 branded grade card image. Also accepts ?resultId={id} for automatic lookup. Rate limit: 30 per IP per minute.

- Rate limits: GET /api/limits
  Returns all rate limits, SSRF protection policy, response headers, and endpoint links as structured JSON. Call this once to understand the entire API surface.

- Debug mode: append &debug=1 to any scan request for fetch timing, route-following details, and internal diagnostics.

## Scan result structure

Every scan result includes:
- Grade (A-F) and numeric score (0-100)
- SNAP pillar scores (Signal, Navigate, Absorb, Perform)
- Agentic enablement: promise-relative Layer 2 over base purposes (commerce sites also carry a Transactability purpose at a higher bar); protocol-agnostic, content-validated, Standards Library v1 (RFC 8288 Link, RFC 9727 api-catalog, RFC 8414/9728 OAuth, MCP server-card, /index.md, Web Bot Auth)
- Findings with status (pass/warn/fail/blocked), impact, remediation guidance, and confidence level (high/medium/low)
- Remediation tier: self-fix (access problems), workshop (content structure), audit (protocol gaps), or none
- Scan provenance: rubric version, scanner version, pages fetched with status codes, checks run with statuses, agent user-agents tested
- Content model health: clear, mixed, or confused
- Content divergence: whether the origin serves different content to agents via Accept: text/markdown (containment-based detection)
- Informational signals: llms.txt, agents.json, feeds, robots.txt detection
- Detection-only semantic resources: assistant guides, ontology files, relationship maps, and HTML machine-resource discovery links are reported under informational.semanticResources and do not affect scoring while calibration remains open
- Public schema contract: schemas/scan-result.schema.json is tested against current scan output, including extended provenance roles
- Evidence ledger: per-check probe trail (id, purpose, url, status, content-type, duration, verdict, reason, SHA-256, 512-byte body excerpt); fetched bodies are byte-capped before parsing, then excerpted and hashed; no auth/cookies recorded; additive, does not affect scoring
- External baseline panel: external.cloudflare carries an attributed Cloudflare Agent Readiness protocol-presence baseline (level 0-5, per-check results); informational only, never feeds score, grade, or level; their outage never fails a Siteline scan
- Standards conformance panel: standards.entries carries open-standard checks — Graceful Boundaries passive evidence (limits discovery, proactive RateLimit headers; full verification requires the GB checker) and GuideCheck assistant-guide.txt shape validation; informational only, absence never penalized
- Stable result ID for permalinks and later retrieval

## Services (tiered by scan findings)

- Self-fix: Access and infrastructure problems the site owner can resolve directly. No paid service needed.

- Site Ontology Workshop ($2,499): https://siteline.to/services/#ontology-workshop
  Facilitated workshop for sites with content structure and taxonomy problems. The scanner detects symptoms (undifferentiated content, duplicate routes, incoherent headings); the workshop resolves them.

- Full Audit ($899): https://siteline.to/services/#full-audit
  Multi-page assessment, scenario testing, platform-specific intervention planning, and implementation-ready artifacts for sites with protocol and agent-facing gaps.

- White-Label Reports ($499/mo): https://siteline.to/white-label/
  Branded, client-ready Siteline reports for agencies and consultants. Surfaced contextually through agency and report flows.

## What this product is for

- Site owners who want to know whether AI agents can actually use their public site
- Consultants and agencies who need a fast baseline before a deeper engagement
- Teams preparing public sites for machine-assisted navigation, comparison, and human handoff
- Agents evaluating whether a site can be detected, navigated, absorbed, and acted through
- Teams that need observable machine accessibility before automation failures become operationally expensive

## What this product is not

- It is not a general SEO score
- It is not GEO scoring, chatbot optimization, prompt engineering, LLM manipulation, or a protocol-generation tool
- It is not a guarantee of AI traffic or citations
- It is not the full implementation plan
- It is not a guarantee that agents can complete authenticated or private workflows

## Security and limits

- Conforms to the Graceful Boundaries specification (Level 4): https://github.com/snapsynapse/graceful-boundaries
- SSRF protection blocks private IPs, IPv4-mapped private IPv6, loopback, cloud metadata, internal hostnames, non-standard ports, DNS-preflight targets that resolve internally, and unsafe redirect targets
- One scan per submitted URL scope per calendar day (global, not per-user)
- All rate limits documented at /api/limits (proactive discovery)
- All 429 responses include structured retry guidance with retryAfterSeconds and why
- All successful responses include proactive RateLimit headers
- Content consistency enforced: scanner probes for content divergence via Accept: text/markdown. Sites with <60% containment are flagged for cloaking and capped to agentic Level 1 (grade cap D)
- Static portfolio and catalog sites are not treated as ecommerce merely because they expose Offer or SoftwareApplication schema. Ecommerce profile expectations require stronger transaction evidence such as cart, checkout, product/store schema, purchase language, pricing, or a validated agentic transaction surface.

## Developer and agent interfaces

- REST API: GET https://siteline.to/api/scan?url={url}
  Returns SNAP score, agentic enablement level, and prioritized findings. Rate limits apply — check GET /api/limits for the current policy.

## Agentic resources

For the full inline LLM context (no API calls needed), see: https://siteline.to/llms-full.txt

- LLMs-Full: https://siteline.to/llms-full.txt
  Extended version of this file with full SNAP scoring model, check criteria, scan result schema, and API details inlined.

- Agent Discovery: https://siteline.to/agents.json
  Describes Siteline's capabilities, public pages, and API integration details for agents.

- MCP Discovery: https://siteline.to/.well-known/mcp.json
  MCP discovery pointing to the hosted Siteline API.

- Security Policy: https://siteline.to/.well-known/security.txt
  RFC 9116 security contact and policy.

- [Assistant Guide](https://siteline.to/.well-known/assistant-guide.txt): bounded assistant install and operational instructions
  GuideCheck-conformant assistant-guide.txt covering the bounded run-one-scan task. Also served at /assistant-guide.txt (byte-identical).

- OpenAPI Spec: https://siteline.to/api/v1/openapi.json
  OpenAPI 3.1 specification covering all API endpoints with JSON Schema for the scan result type.

- API Manifest: https://siteline.to/api/v1/index.json
  Machine-readable index of all endpoints and discovery files.

- Changelog: https://siteline.to/api/v1/changelog.json
  Version history with build dates and summaries.

- Agents Manifest: https://siteline.to/agents.json
  Agent capability declaration with tools, fit signals, and endpoints.

## Organization

- Built by PAICE: https://paice.work/
- LinkedIn: https://www.linkedin.com/company/paice-work/