CrazySEO MCP server
✓ VerifiedAudits website visibility and readiness for AI search engines like ChatGPT, Gemini, and Perplexity through blind visibility checks and technical audits.
Also known as bolidee/crazyseo
- Stars
- 4
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.1.2
- Last commit
- Aug 5, 2026
- License
- AGPL-3.0
What is CrazySEO MCP?
CrazySEO audits website visibility and readiness for AI search engines like ChatGPT, Gemini, and Perplexity through blind visibility checks and technical audits.
Summary generated from the project's README
About CrazySEO MCP server
Auditing website visibility and readiness for AI search engines like ChatGPT, Gemini, and Perplexity is the primary function of CrazySEO. It helps developers and marketers understand if their brand is being recommended by AI assistants or if competitors are being cited instead. The server performs blind visibility checks, meaning it asks questions without mentioning the brand name to ensure the results reflect what a real buyer would see.
Users can run technical readiness audits locally using npx without any API keys or accounts. For deeper visibility audits across multiple engines, you can provide your own OpenAI, Google, or Perplexity API keys. The server provides 11 specific technical checks, including schema.org markup, robots.txt crawler permissions, and image alt-text coverage. It also identifies the citation gap by showing which third-party sources, such as Reddit or YouTube, AI models trust more than your own website.
What you can do with it
- 1Measure blind brand visibilityDetermine if AI models recommend your brand when asked generic buyer questions.
- 2Identify competing citationsFind out which specific websites and platforms are being cited by AI instead of your own.
- 3Automate deployment gatesUse the non-zero exit code to prevent deploying a site that fails AI readiness checks.
Written from the project's README. Every use case is checked against a quote from it.
How to install CrazySEO MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall CrazySEO MCP in Claude Code
$ claude mcp add --env 'GOOGLE_API_KEY=<YOUR_GOOGLE_API_KEY>' --env 'OPENAI_API_KEY=<YOUR_OPENAI_API_KEY>' --env 'PERPLEXITY_API_KEY=<YOUR_PERPLEXITY_API_KEY>' crazyseo -- npx -y crazyseoInstall CrazySEO MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"crazyseo": {
"command": "npx",
"args": [
"-y",
"crazyseo"
],
"env": {
"GOOGLE_API_KEY": "<YOUR_GOOGLE_API_KEY>",
"OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
"PERPLEXITY_API_KEY": "<YOUR_PERPLEXITY_API_KEY>"
}
}
}
}Install CrazySEO MCP in VS Code
.vscode/mcp.json
{
"servers": {
"crazyseo": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"crazyseo"
],
"env": {
"GOOGLE_API_KEY": "<YOUR_GOOGLE_API_KEY>",
"OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
"PERPLEXITY_API_KEY": "<YOUR_PERPLEXITY_API_KEY>"
}
}
}
}Install CrazySEO MCP in VS Code CLI
$ code --add-mcp '{"name":"crazyseo","type":"stdio","command":"npx","args":["-y","crazyseo"],"env":{"GOOGLE_API_KEY":"<YOUR_GOOGLE_API_KEY>","OPENAI_API_KEY":"<YOUR_OPENAI_API_KEY>","PERPLEXITY_API_KEY":"<YOUR_PERPLEXITY_API_KEY>"}}'Install CrazySEO MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"crazyseo": {
"command": "npx",
"args": [
"-y",
"crazyseo"
],
"env": {
"GOOGLE_API_KEY": "<YOUR_GOOGLE_API_KEY>",
"OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
"PERPLEXITY_API_KEY": "<YOUR_PERPLEXITY_API_KEY>"
}
}
}
}Install CrazySEO MCP in Codex
$ codex mcp add crazyseo --env 'GOOGLE_API_KEY=<YOUR_GOOGLE_API_KEY>' --env 'OPENAI_API_KEY=<YOUR_OPENAI_API_KEY>' --env 'PERPLEXITY_API_KEY=<YOUR_PERPLEXITY_API_KEY>' -- npx -y crazyseoInstall CrazySEO MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.crazyseo] command = "npx" args = ["-y", "crazyseo"] [mcp_servers.crazyseo.env] GOOGLE_API_KEY = "<YOUR_GOOGLE_API_KEY>" OPENAI_API_KEY = "<YOUR_OPENAI_API_KEY>" PERPLEXITY_API_KEY = "<YOUR_PERPLEXITY_API_KEY>"
Install CrazySEO MCP in Gemini CLI
$ gemini mcp add -s user -e 'GOOGLE_API_KEY=<YOUR_GOOGLE_API_KEY>' -e 'OPENAI_API_KEY=<YOUR_OPENAI_API_KEY>' -e 'PERPLEXITY_API_KEY=<YOUR_PERPLEXITY_API_KEY>' crazyseo npx -- -y crazyseoInstall CrazySEO MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"crazyseo": {
"command": "npx",
"args": [
"-y",
"crazyseo"
],
"env": {
"GOOGLE_API_KEY": "<YOUR_GOOGLE_API_KEY>",
"OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
"PERPLEXITY_API_KEY": "<YOUR_PERPLEXITY_API_KEY>"
}
}
}
}Configuration
GOOGLE_API_KEYSecretOptional. Enables the Gemini engine for audit_visibility. Never required for readiness_check.
OPENAI_API_KEYSecretOptional. Enables the ChatGPT engine for audit_visibility. Never required for readiness_check.
PERPLEXITY_API_KEYSecretOptional. Enables the Perplexity engine for audit_visibility. Never required for readiness_check.
Automated checks
Ran Nov 15, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablebolidee/crazyseo is public and reachablegithub.com/bolidee/crazyseo ↗Pass
- Package names this repository as its sourcecrazyseo names bolidee/crazyseo as sourcenpmjs.com/package/crazyseo ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)AGPL-3.0spdx.org/licenses/AGPL-3.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-08-05github.com/bolidee/crazyseo ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from crazyseoPass
- No critical advisory in the package or its dependencies99 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubCrazySEO
Find out whether ChatGPT, Gemini and Perplexity recommend your site — and why they don't.
An open-source GEO / AEO auditor and MCP server. No account. No card. Your keys.
Your customers have stopped googling. They ask an assistant "best CRM for small law firms?" and buy whatever it names. If it doesn't name you, you don't exist — and no analytics tool will tell you, because there is no click to measure.
This audits it directly: it asks the questions your buyers ask, records the answers word for word, and shows you which sources the models cite instead of you.
Why another one
Most tools in this space ask the model "what do you think of Acme?" — which tells you nothing, because naming the brand in the prompt guarantees it shows up in the answer.
This asks blind. Your brand never appears in the question, so the answer you get back is the answer a real buyer gets. That is the whole difference between a number you can act on and a number that flatters you.
Three more things a prompt wrapper can't do:
- Verbatim receipts. Every result carries the exact prompt and the model's raw answer, so you can paste it into ChatGPT yourself and reproduce it.
- Honest coverage. If an engine fails or rate-limits, the report says so. It never quietly drops an engine and calls the remaining average your score. If a site can't be reached, it refuses to score it rather than inventing a number.
- A real readiness audit. 11 checks against your actual site — not a prompt.
Quick start — no API keys needed
The readiness audit runs against any site with zero configuration and zero cost:
npx crazyseo readiness yourbrand.com
Nothing to install, no signup, no key. Or run it from source:
git clone https://github.com/d08m/crazyseo && cd crazyseo
npm install && npm run build
node dist/cli.js readiness yourbrand.com
AI-READINESS stripe.com 82/100
✓ Served over HTTPS
✓ AI crawlers allowed
✓ Structured data (schema.org)
✓ llms.txt published (bonus)
✓ Title + meta description
✓ Readable without JavaScript
✓ Canonical URL set
✓ Social preview tags (Open Graph)
✗ Single, clear H1
2 H1 tags — ambiguous which is the main topic
✗ Images have alt text
27 of 31 images missing alt text
✓ Sitemap referenced
✓ No broken internal links
→ 2 issues to fix
(That's real output — stripe.com, unmodified.)
11 scored checks, all first-party fetches: HTTPS · AI crawlers (GPTBot, ClaudeBot, PerplexityBot, Google-Extended…) unblocked in robots.txt · schema.org markup · title + meta · readable without JavaScript · canonical · Open Graph · single-H1 structure · image alt-text coverage · sitemap referenced · broken internal links (sampled).
Plus llms.txt, shown but deliberately unscored: Google's own AI-optimization guidance says it has no effect in Google Search, so it can't fairly cost anyone points — but some agents do read it, so it's still worth seeing.
Exits non-zero when checks fail, so you can gate a deploy on it:
- run: npx crazyseo readiness ${{ env.SITE }}
Machine-readable output for pipelines:
npx crazyseo readiness yourbrand.com --json > report.json
The visibility audit — bring your own keys
To measure what the engines actually say, add whichever keys you have. Any one is enough; more engines means more coverage.
export OPENAI_API_KEY=... # optional
export GOOGLE_API_KEY=... # optional
export PERPLEXITY_API_KEY=... # optional
npx crazyseo audit yourbrand.com
It reads your site, infers what you sell, generates the questions your buyers would actually ask, and asks all of them — blind — across every engine you configured.
VISIBILITY lymexa.com 0 of 8 answers · 0%
Lymexa — premium pickleball paddles and recovery gear brand, USA
"What are the best premium pickleball paddles for advanced players?"
Gemini ✗ not named JOOLA, CRBN, Selkirk, Six Zero
Perplexity ✗ not named JOOLA, Selkirk, CRBN, Gearbox
"Which high-performance pickleball paddle brands are manufactured in the USA?"
Gemini ✗ not named Engage, Paddletek, Selkirk, Thompson Pickleball
Perplexity ✗ not named Engage, Paddletek, Selkirk, GAMMA
RECOMMENDED INSTEAD
Selkirk 4× named
Therabody 4× named
Hyperice 4× named
CITATION GAP — cited on the questions you lost
reddit.com 7× Community discussion AI trusts for real opinions
youtube.com 6× Video content AI pulls into answers
pickleheads.com 4× Third-party source AI cites instead of you
! ChatGPT did not respond — this score covers the rest only.
(Real output, trimmed for length. Note the last line: when an engine fails, the report says so instead of quietly averaging the rest and calling it your score.)
Runs on your own keys — a full audit is typically a few cents.
Use it from your agent
It ships as an MCP server, so Claude, ChatGPT or any MCP-capable agent can run it directly:
claude mcp add --transport stdio crazyseo -- npx -y crazyseo mcp
It's also packaged as a Claude Code plugin, which wires up the MCP server and the skill below in one step:
/plugin marketplace add d08m/crazyseo
/plugin install crazyseo@crazyseo
Then just ask:
"Is my site visible in AI search? What's cited instead of me?"
| tool | what it does | keys |
|---|---|---|
readiness_check |
11-point AI-readiness audit | none |
audit_plan |
site facts + buyer questions to ask, for a keyless audit | none |
audit_score |
scores what the agent found: visibility, leaderboard, citation gap | none |
audit_visibility |
blind multi-engine visibility + verbatim answers | BYO |
citation_gap |
sources cited on the questions you lose | BYO |
engine_status |
which engines this install can query | none |
You don't need an API key to get the interesting part. audit_plan and
audit_score let the assistant you're already talking to be the engine: it
fetches your site, writes the buyer questions, answers them with its own web
search, and hands the results back for scoring. Ask "is my site visible in AI
search?" and you get a real citation gap with no signup, no key, no billing.
The tool still does the arithmetic, and still refuses a question that names your
brand — that guard is what makes the number worth having. It measures visibility
in that assistant, which the report says plainly. For the cross-engine
picture, use audit with your own keys.
There's also a SKILL.md so agents know how to interpret the
numbers — that readiness isn't visibility, that 0% is a normal starting point,
and that partial engine coverage must be reported as partial.
Use it as a library
import { checkReadiness } from 'crazyseo';
const report = await checkReadiness('example.com');
console.log(report.score, report.checks);
How this stays free
Everything here is free forever, self-hosted, AGPL — full capability, no feature locks, no telemetry, no account, no upsell in the output.
There is no paid tier today, and this README won't pretend otherwise. If one ever appears it will be for the single thing self-hosting genuinely can't give you — scheduled re-runs, stored history and alerts, the infrastructure to watch a number move over months without running anything yourself. The auditing itself stays here, complete, under AGPL.
Which is also the answer to "what stops this going closed later": the licence. Anyone offering it as a hosted service has to open their version too, including whoever wrote it.
Contributing
Issues and PRs welcome. The checks are deliberately conservative: every one has to be something an assistant or its crawler actually depends on, and verifiable by hand. If a check can't be justified that way, it doesn't belong here.
CONTRIBUTING.md covers the setup, the bar a new check has to clear, and what an engine adapter needs to get right.
License
AGPL-3.0. Use it, fork it, run it commercially, embed it in your own tooling. If you offer it to others as a hosted service, that service must be open too.
CrazySEO MCP questions
How do I add CrazySEO MCP to Claude Code?
Run claude mcp add --env 'GOOGLE_API_KEY=<YOUR_GOOGLE_API_KEY>' --env 'OPENAI_API_KEY=<YOUR_OPENAI_API_KEY>' --env 'PERPLEXITY_API_KEY=<YOUR_PERPLEXITY_API_KEY>' crazyseo -- npx -y crazyseo in your terminal. Add --scope user to make it available in every project.
How do I add CrazySEO MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Do I need an API key to run a readiness audit?
No, the readiness audit runs against any site with zero configuration, zero cost, and no API keys required.
How does the visibility audit work?
It performs a blind audit by generating buyer questions that do not mention your brand, then checks if AI engines recommend your site or cite competitors instead.
Can I use this with Claude?
Yes, it ships as an MCP server that can be added directly to Claude or used as a Claude Code plugin.