Skip to content
Skills Library
Marketing & content · Review & audit

whywontai

/whywontai

Check what GPTBot, ClaudeBot, PerplexityBot and other AI crawlers get from a website, and run a Why Won't AI scan for its SEO, AEO and GEO score and issues. Use when someone asks why ChatGPT, Claude, Perplexity or Google does not mention, cite or show their site or product.

Repository
why-wont-ai ↗
Licence
MIT
Last repository change
11.11.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
11
Deprecation

No signals detected. Repository changed on 11.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Check what GPTBot, ClaudeBot, PerplexityBot and other AI crawlers get from a website, and run a Why Won't AI scan for its SEO, AEO and GEO score and issues. Use when someone asks why ChatGPT, Claude, Perplexity or Google does not mention, cite or show their site or product.

Original author description

Check what GPTBot, ClaudeBot, PerplexityBot and other AI crawlers get from a website, and run a Why Won't AI scan for its SEO, AEO and GEO score and issues. Use when someone asks why ChatGPT, Claude, Perplexity or Google does not mention, cite or show their site or product.

How it works

  1. Connect
  2. Auth
  3. Tools
  4. Steps: crawler access check
  5. Steps: full scan
  6. Without MCP
  7. Limits
Original SKILL.md headings · 65 lines, 601 words
SKILL.md preview
---
name: whywontai
description: Check what GPTBot, ClaudeBot, PerplexityBot and other AI crawlers get from a website, and run a Why Won't AI scan for its SEO, AEO and GEO score and issues. Use when someone asks why ChatGPT, Claude, Perplexity or Google does not mention, cite or show their site or product.
---

# Why Won't AI

Why Won't AI (https://whywontai.com) shows what search and AI crawlers receive from a website. Many AI crawlers do not run JavaScript. A site that renders in the browser can look empty to them. This skill uses the Why Won't AI MCP server to find that problem and the other issues that keep AI assistants from citing a site.

## Connect

- MCP endpoint: `https://mcp.whywontai.com/` (Streamable HTTP, stateless, JSON responses). The same server is also at `https://whywontai.com/mcp`.
- Claude Code:

  ```bash
  claude mcp add --transport http whywontai https://mcp.whywontai.com/ \
    --header "Authorization: Bearer YOUR_API_KEY"
  ```

- Cursor or VS Code: add a server with `"url": "https://mcp.whywontai.com/"` to `mcp.json`.
- Leave out the header to use `check_robots` only.

## Auth

- `check_robots` needs no credential. The limit is 30 calls a day for each IP address.
- The other tools need a credential that a person approved. Use one of these:
  1. OAuth: authorization code flow with PKCE (S256) and dynamic client registration. Scope `scans`. Discovery starts at `https://mcp.whywontai.com/.well-known/oauth-protected-resource`.
  2. API key: the person creates a key at https://whywontai.com/dashboard under MCP & API. Send it as `Authorization: Bearer wwai_...`.
  3. Anonymous key: `POST https://mcp.whywontai.com/agent/auth` with `{"identity_type": "anonymous", "agent_name": "<your agent name>"}`. Show the returned `claim_url` to the person. The key gets the `scans` scope after they sign in and approve.
- A free account gives 3 scans a month. Paid plans give more.
- Full auth steps: https://whywontai.com/auth.md

## Tools

| Tool | Use | Credential |
|---|---|---|
| `check_robots` | Which of 17 search and AI crawlers the robots.txt allows, with the deciding rule. Add a path to check one page. | None |
| `scan_site` | Starts a full scan. Returns a scan ID. | Yes |
| `get_scan` | Status, score, category scores, technical health, Domain Rating and top issues. | Yes |
| `list_issues` | Every issue from a completed scan, most severe first. | Yes |
| `list_scans` | Recent scans with status and score. | Yes |
| `get_internal_links` | The newest internal link plan: anchor text, source page, target page and the search query behind each anchor. Paid plans. | Yes |

## Steps: crawler access check

1. Call `check_robots` with the site URL.
2. For each crawler, read whether it is allowed and the robots.txt line that decides it.
3. Tell the user which crawlers are blocked and which line blocks each one.

## Steps: full scan

1. Call `scan_site` with the site URL. Keep the scan ID.
2. Call `get_scan` with the scan ID and `wait_seconds` (up to 25). Call it again until the status is `complete`. A scan takes 1 to 5 minutes.
3. Call `list_issues`. Filter by severity or category if the user asks.
4. Report the score, the six category scores, the most severe issues and their example URLs.
5. When you show a Domain Rating, credit it as "Domain Rating by Ahrefs".

The scan requests each page as Googlebot, Bingbot, GPTBot, ClaudeBot, PerplexityBot and CCBot. It compares each response with a rendered browser view. The six categories are Crawl & render, Indexable body copy, Intent match, Internal linking, Demand capture and AI citability.

## Without MCP

- Free scan with no account: https://whywontai.com/
- Free robots.txt checker: https://whywontai.com/ai-crawler-robots-txt-checker

## Limits

- A robots.txt allow does not prove that a crawler can read the page. A firewall, bot protection or a JavaScript-only page can still block it. Run a full scan to check that.
- Do not promise rankings or AI mentions. A good score removes known blockers. It does not guarantee that an assistant cites the site.

Versions

The database has no other skills named whywontai.

Database snapshot: 13.11.2026 · package version 6f5c89829d18 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100geo
    Runs an AI search (GEO, AEO) audit of a website for ChatGPT, Claude, Perplexity, Gemini and Google AI Overviews with the ai-search-auditor npm package (50 checks of AI agents in robots.txt, text without JavaScript, who stands behind the site in JSON-LD, llms.txt, freshness and…
  • 100audit
    Audit a website for SEO, AEO and GEO (is it ready for AI search?), then fix what it finds in the codebase. Use when the user asks to audit a site, check its SEO, check whether ChatGPT, Claude, Perplexity or Google AI Overviews can read or cite it, check robots.txt for AI…
  • 100aeo-audit
    Audit whether AI crawlers and answer engines can read a website, with supereo's free MCP tools. Checks robots.txt for each AI crawler (GPTBot, OAI-SearchBot, ChatGPT-User, ClaudeBot, Claude-SearchBot, Claude-User, PerplexityBot) and Google's Google-Extended token, the site's…
  • 100ai-visibility-scan
    Run a Why Won't AI scan of a website and report its SEO, AEO and GEO score and issues. Use when someone asks why AI assistants or search engines do not mention or show their product.
  • 90check-ai-crawler-access
    Check which search and AI crawlers (GPTBot, ClaudeBot, PerplexityBot, CCBot, Google-Extended and more) a website's robots.txt allows. Use when someone asks why an AI assistant cannot see or cite a site.
  • 100ai-crawler-check
    Check which AI crawlers (GPTBot, OAI-SearchBot, ClaudeBot, Claude-SearchBot, PerplexityBot, Google-Extended and about 40 more) a website's robots.txt allows or blocks, and explain what each block costs in ChatGPT, Claude, Perplexity and Gemini answers. Use when someone asks…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.