# AIScan.site

> Platform-aware agent-readiness scanner. Audit how prepared any website is for AI agents, then share or save the result.

AIScan.site grades how well a website talks to AI agents (ChatGPT, Claude, Perplexity, etc.). It detects the underlying platform (WordPress, Shopify, Lovable, Replit, Bolt, v0, Framer, Wix, Webflow, Ghost, Squarespace, HubSpot, Next.js) and applies the right rubric so content sites are not unfairly penalized for missing API surfaces.

## What's on the site

- [Scanner](/): Run an agent-readiness scan on any URL. Free, no signup for the first scans.
- [Community scans](/): Latest 10 public scans appear on the homepage as a browsable feed.
- [Public scan reports](/scan/<id>): Every public scan has a permanent shareable URL with full report, OG share card, and JSON-LD metadata.
- [How it works](/how-it-works): Methodology and scoring rubric.
- [Profile](/profile): Signed-in users can edit their display name and view their full scan history (public + private).
- [Admin panel](/admin): Internal dashboard for the site operator (role-gated).

## Public vs private scans

- Anyone can run a scan. Signed-out scans are always public.
- Signed-in users choose **Public** (visible in the feed, indexed by search engines, shareable URL) or **Private** (only the owner can view).
- Private scans 404 for everyone except their owner.

## For AI agents

- [Programmatic scan API](/api/public/scan): POST `{url}` or GET `?url=` — returns full ScanResult JSON. Rate limit 5/min/IP.
- [MCP server](/api/mcp): Streamable HTTP MCP endpoint exposing `scan_website`, `get_fixes`, `get_grade`.
- [Agent Skill manifest](/aiscan-skill.json): Claude Agent Skills JSON describing trigger phrases and usage.
- [Claude Code instructions](/CLAUDE.md): Plain-English skill doc for Claude Code and similar agent IDEs.
- [MCP server card](/.well-known/mcp/server-card.json): MCP discovery metadata.
- [llms-full.txt](/llms-full.txt): Long-form description of every endpoint and surface.

## Example

```
curl https://aiscan.site/api/public/scan?url=https://example.com
```