AIScan.site
?
Framework

Custom / Unknown

https://cardscan.site/
B71 / 100
Grade B · Level 4InteractiveGood — solid foundations, with room to polish.
Discoverability77
2/3 passing
Content56
2/3 passing
Bot Access85
2/3 passing
Capabilities75
2/4 passing
Score breakdown by dimension
Discoverability77
Content56
Bot Access85
Capabilities75
2 checks need fixing

2 failed out of 7 that apply to your site.

See top fixes

Quick Wins

Top 2 fixes ranked by score impact

  • 01Fail

    Markdown content negotiation

    +8 pts if fixed

    Serve text/markdown when the client sends Accept: text/markdown, or expose /path/index.md.

    See full details
  • 02Fail

    Link header for discovery

    +3 pts if fixed

    Add a Link header with rel="api-catalog" or rel="describedby".

    See full details
Hand-off prompt for your coding agent4 issues
# Agent-readiness remediation brief

Site: https://cardscan.site/
Platform: unknown (0% confidence)
AIScan score: 71/100 — Level 4 (Interactive)
Rubric: v2026-06-08.1

## Failing checks (sorted by weight)
- **[C1] Markdown content negotiation** — FAIL
  - Evidence: Accept: text/markdown → 200 (text/html)
  - Fix: Serve text/markdown when the client sends Accept: text/markdown, or expose /path/index.md.
- **[P2] MCP Server Card** — PARTIAL
  - Evidence: HTTP 200
  - Fix: Optional: publish /.well-known/mcp/server-card.json if you expose an MCP server.
- **[D3] Link header for discovery** — FAIL
  - Evidence: no Link response header
  - Fix: Add a Link header with rel="api-catalog" or rel="describedby".
- **[B3] Web Bot Auth key directory** — PARTIAL
  - Evidence: HTTP 200
  - Fix: Optional: serve a JWKS-style key directory at /.well-known/http-message-signatures-directory.

## General guidance
- Static-first: `robots.txt`, `llms.txt`, `/.well-known/*` JSON cards.
- Markdown negotiation: serve `text/markdown` when requested via `Accept` header or `?format=md`.
- Bot access: explicit allow/deny per AI user-agent (GPTBot, ClaudeBot, PerplexityBot, Google-Extended, Applebot-Extended, Bytespider, Amazonbot, CCBot, meta-externalagent, cohere-ai, Diffbot).
- Capabilities: publish an MCP server card and (optionally) an Agent Skills manifest even if the runtime isn't live — discovery first.
- Re-scan at aiscan.site after deploying.

Discoverability

77

Can agents find your pages? robots, sitemaps, llms.txt.

21

  • Your site is missing this right now, so AI agents can't use it. The fix below is what to change.

    ID · D3

    What we found

    no Link response header

    How to fix it

    Add a Link header with rel="api-catalog" or rel="describedby".

    1.Add a Link response header

    Set this header on your homepage and/or root document. Most CDNs (Cloudflare, Vercel, Netlify) support response-header rules.

    2.Example
    Link: </.well-known/api-catalog>; rel="api-catalog"
    3.Verify

    After deploying, re-run this scan. You can also test with `curl -I` or `curl` directly.

    Fix in ChatGPT Fix in Claude

Content

56

Can agents read your content cleanly? Markdown, structured data.

21

  • Your site is missing this right now, so AI agents can't use it. The fix below is what to change.

    ID · C1

    What we found

    Accept: text/markdown → 200 (text/html)

    How to fix it

    Serve text/markdown when the client sends Accept: text/markdown, or expose /path/index.md.

    1.Serve text/markdown on Accept negotiation

    When a client sends `Accept: text/markdown`, return a markdown rendering of the same content. The simplest path is to publish parallel `.md` files (e.g. `/about` → `/about.md`) and rewrite based on the Accept header.

    2.Test it
    curl -H "Accept: text/markdown" https://yoursite.com/
    3.Verify

    After deploying, re-run this scan. You can also test with `curl -I` or `curl` directly.

    Fix in ChatGPT Fix in Claude

Bot Access

85

Are AI crawlers explicitly allowed or blocked?

21

Capabilities

75

Can agents do things? APIs, auth, MCP, Agent Skills.

21
Share the result

Share as a social image

Download a 1200×630 social card or post straight to X, LinkedIn or Facebook — sized for every feed.

AIScan share card — cardscan.site graded B
Post on X Share on LinkedIn Share on Facebook

Tip: for X and LinkedIn, upload the downloaded PNG with your post so the card shows in the feed. Posts that include just the link will still preview AIScan.site.

Showcase your grade

Embed your AIScan badge

Drop this badge into your site footer, GitHub README, or docs. It links back to a fresh scan of cardscan.site on AIScan.site.

AIScan.site grade B
HTML
<!-- AIScan.site agent-readiness badge -->
<a href="https://aiscan.site/?u=https%3A%2F%2Fcardscan.site%2F" target="_blank" rel="noopener" title="Agent-Readiness Grade B (71/100) — AIScan.site">
  <img src="https://aiscan.site/api/public/badge.svg?score=71&grade=B&host=cardscan.site" alt="AIScan.site Grade B — 71/100" width="240" height="64" loading="lazy" />
</a>
Markdown
[![AIScan.site Grade B — 71/100](https://aiscan.site/api/public/badge.svg?score=71&grade=B&host=cardscan.site)](https://aiscan.site/?u=https%3A%2F%2Fcardscan.site%2F)

Track this over time

Coming soon: save sites, schedule re-scans, get email when something material changes. Standards land weekly — your tracker shouldn't be one-shot.

Free · No signup · ~20 seconds

Scan your own site

Get a plain-English agent-readiness report you can hand straight to ChatGPT or Claude.

Scan your site
Or browse the community feed to see what others have scanned.