CrazySEO

---

你的客户已经不再用 Google 搜索了。他们会问助手 “适合小型律师事务所的最佳 CRM 是什么？”，然后购买助手提到的产品。如果它没有提到你，你就等于不存在——而且没有任何分析工具能告诉你这一点，因为根本没有可衡量的点击。

本工具会直接审核：提出买家会问的问题，逐字记录答案，并展示模型引用了哪些来源，而不是你的网站。

为什么还需要另一个工具

这个领域的大多数工具都会问模型 “你怎么看 Acme？”——这毫无用处，因为在提示词中提到品牌，就能确保它出现在答案里。

**本工具会盲问。**问题中绝不会出现你的品牌，因此你得到的答案，就是真实买家会得到的答案。这正是可用于采取行动的数字与只会奉承你的数字之间的区别。

提示词封装器做不到的另外三件事：

• **逐字记录。**每个结果都包含确切的提示词和模型原始回答，因此你可以将它粘贴到 ChatGPT 中，亲自复现结果。
• **如实呈现覆盖情况。**如果某个引擎故障或触发速率限制，报告会如实说明。它绝不会悄悄剔除某个引擎，再把剩余结果的平均值称作你的得分。如果无法访问某个网站，它会拒绝评分，而不是编造一个数字。
• **真正的就绪度审核。**针对你实际网站进行 11 项检查，而不是提示词。

快速开始——无需 API 密钥

就绪度审核无需任何配置，也不产生任何费用，可用于任意网站：

npx crazyseo readiness yourbrand.com

无需安装，无需注册，无需密钥。或者从源代码运行：

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

（这是实际输出，来自未经修改的 stripe.com。）

11 项评分检查，全部通过第一方请求完成：HTTPS · robots.txt 中未屏蔽 AI 爬虫（GPTBot、 ClaudeBot、PerplexityBot、Google-Extended……）· schema.org 标记 · 标题 + meta · 无需 JavaScript 即可阅读 · canonical · Open Graph · 单一 H1 结构 · 图片 alt 文本覆盖率 · 引用了 sitemap · 损坏的 站内链接（抽样检查）。

此外还会显示 llms.txt，但刻意不纳入评分：Google 自己的 AI 优化指南指出，它对 Google 搜索没有影响，因此不能公平地据此扣分——但有些 Agent 会读取它，所以仍值得查看。

检查失败时以非零状态码退出，因此你可以据此阻止部署：

- run: npx crazyseo readiness ${{ env.SITE }}

适用于流水线的机器可读输出：

npx crazyseo readiness yourbrand.com --json > report.json

可见度审核——使用你自己的密钥

要衡量各引擎的实际回答，请添加你拥有的任意密钥。只需一个密钥即可；引擎越多，覆盖范围越广。

export OPENAI_API_KEY=...      # optional
export GOOGLE_API_KEY=...      # optional
export PERPLEXITY_API_KEY=...  # optional

npx crazyseo audit yourbrand.com

它会读取你的网站，推断你销售的产品，生成买家实际会提出的问题，并在你配置的所有引擎中盲问这些问题。

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.

（实际输出，已删减以缩短篇幅。请注意最后一行：引擎故障时，报告会如实说明，而不会悄悄对其余结果取平均值并称之为你的得分。）

使用你自己的密钥运行——完整审核通常只需几美分。

在 Agent 中使用

它以 MCP 服务的形式提供，因此 Claude、ChatGPT 或任何兼容 MCP 的 Agent 都可以直接运行：

claude mcp add --transport stdio crazyseo -- npx -y crazyseo mcp

它也打包成了 Claude Code 插件，一步即可配置 MCP 服务和下方的技能：

/plugin marketplace add d08m/crazyseo
/plugin install crazyseo@crazyseo

然后只需询问：

“我的网站在 AI 搜索中可见吗？引用了哪些内容，而不是我的网站？”

工具	功能	密钥
readiness_check	11 项 AI 就绪度审计	无
audit_plan	网站事实信息 + 要提出的买家问题，用于无密钥审计	无
audit_score	为 Agent 找到的内容评分：可见度、排行榜、引用差距	无
audit_visibility	盲测多引擎可见度 + 原文回答	自备
citation_gap	在你落败的问题上被引用的来源	自备
engine_status	此安装可以查询哪些引擎	无

想获得最有价值的部分，不需要 API 密钥。 audit_plan 和 audit_score 让你正在交谈的助手充当引擎：它会抓取你的网站、编写买家问题、用自己的网络搜索回答这些问题，然后把结果交回来评分。询问*“我的网站在 AI 搜索中可见吗？”*，无需注册、密钥或付费，就能获得真实的引用差距。

工具仍负责计算，也仍会拒绝涉及你品牌名称的问题——正是这道限制让结果值得参考。它衡量的是该助手中的可见度，报告会明确说明这一点。若要了解跨引擎情况，请使用 audit 并提供自己的密钥。

此外还有一份 SKILL.md，帮助 Agent 解读这些数字——就绪度不等于可见度，0% 是正常的起点，而且必须将部分引擎覆盖情况报告为部分覆盖。

将其用作库

import { checkReadiness } from 'crazyseo';

const report = await checkReadiness('example.com');
console.log(report.score, report.checks);

如何保持免费

这里的所有内容都永久免费、可自托管，采用 AGPL——功能完整，没有功能锁定、遥测、账户或输出中的推销内容。

目前没有付费层级，这份 README 也不会假装有。如果将来出现付费服务，它只会提供一项自托管确实无法实现的功能——定时重新运行、历史记录存储和提醒，也就是让你无需亲自运行任何东西，就能持续数月监测指标变化的基础设施。审计本身仍会完整保留在这里，并采用 AGPL。

这也回答了“是什么阻止它以后变成闭源”这个问题：许可证。任何人若将其作为托管服务提供，也必须开放自己的版本，包括原作者。

参与贡献

欢迎提交问题和 PR。各项检查都刻意保持保守：每一项都必须是助手或其爬虫实际依赖的内容，并且可以手动验证。如果某项检查无法按此标准说明合理性，就不该纳入其中。

CONTRIBUTING.md 介绍了设置方法、新检查必须达到的标准，以及引擎适配器需要正确处理的事项。

许可证

AGPL-3.0。 可使用、派生、用于商业场景运行，也可嵌入自己的工具中。如果将其作为托管服务提供给他人，该服务也必须开源。

---