# Siteline

> Siteline is a public scanner that evaluates whether a website presents a usable path for AI agents acting on behalf of humans. It scores four pillars: Signal, Navigate, Absorb, and Perform.

## 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}.

- Audit, Pricing, and Scope: https://siteline.to/audit/
  Explains what the paid audit includes, who it is for, and what it does beyond the free scan.

- 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/
  Human contact and next-step path for discussing a deeper engagement.

## API endpoints

- Scan: GET /api/scan?url={url}
  Runs a scan and returns a structured evaluation. One scan per domain per calendar day. Repeat requests 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 by domain (e.g., example.com). Returns the most recent 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)
- 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
- 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 ($1,500-$3,000): https://snapsynapse.com/services/siteline#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 ($297-$497): https://snapsynapse.com/services/siteline#full-audit
  Multi-page assessment, scenario testing, platform-specific intervention planning, and implementation-ready artifacts for sites with protocol and agent-facing gaps.

## 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

## What this product is not

- It is not a general SEO score
- It is not GEO scoring or a protocol-generation tool
- It is not a guarantee of AI traffic or citations
- It is not the full implementation plan

## Security and limits

- Conforms to the Graceful Boundaries specification (Level 4): https://github.com/snapsynapse/graceful-boundaries
- SSRF protection blocks private IPs, loopback, cloud metadata, internal hostnames, and non-standard ports
- One scan per domain 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)

## Developer and agent interfaces

- CLI: node bin/siteline.js scan {url} [--json] [--debug]
- MCP server: node mcp/server.js (stdio transport, tools: scan_url, self_scan, describe_rubric, explain_score)
- Batch scanning: node scripts/batch-scan.js {file or urls} [--json] [--csv] [--label {name}]

## 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.

- MCP Discovery: https://siteline.to/.well-known/mcp.json
  MCP server card for Siteline's stdio MCP server. Tools: scan_url, self_scan, describe_rubric, explain_score.

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

- 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 Snap Synapse: https://snapsynapse.com/
- GitHub: https://github.com/snapsynapse/siteline
- LinkedIn: https://www.linkedin.com/company/snap-synapse