CrazySEO

---

顧客はもう Google 検索をやめています。アシスタントに 「小規模な法律事務所に最適な CRM は？」 と尋ね、名前が挙がったものを購入します。そこであなたの名前が挙がらなければ、あなたは存在しないも同然です。クリックが測定できないため、どの分析ツールでもそれを知ることはできません。

このツールはそれを直接監査します。購入者が尋ねる質問を投げかけ、回答を一言一句そのまま記録し、モデルがあなたの代わりにどの情報源を引用しているかを表示します。

なぜ別のツールが必要なのか

この分野のほとんどのツールは、モデルに 「Acme についてどう思いますか？」 と尋ねます。プロンプトにブランド名を入れた時点で回答に必ず登場するため、何の役にも立ちません。

このツールはブランド名を伏せて質問します。 質問にあなたのブランドが登場しないため、得られる回答は実際の購入者が受け取る回答そのものです。行動に役立つ数値と、気分をよくさせるだけの数値の違いは、ここにあります。

プロンプトを包むだけのツールにはできないことが、さらに3つあります。

• 回答の原文記録。 すべての結果に正確なプロンプトとモデルの生の回答が記録されるため、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 マークアップ · title と meta · JavaScript なしでも読みやすい · canonical · Open Graph · H1 が1つの構成 · 画像の alt テキストの網羅状況 · sitemap の参照 · 壊れた内部リンク（サンプル調査）。

さらに llms.txt も表示されますが、意図的に採点対象からは外しています。Google 独自の AI 最適化ガイダンスによると、Google 検索には影響しないため、これを理由に減点するのは公平ではありません。ただし、これを読み取るエージェントもいるため、確認する価値はあります。

チェックに失敗した場合はゼロ以外の終了コードを返すため、デプロイのゲートとして使用できます。

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

パイプライン向けの機械可読な出力：

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

可視性監査 — ご自身のキーを使用

エンジンが実際に何を回答するかを測定するには、お持ちのキーを追加してください。どれか1つあれば十分です。エンジンを追加するほど、網羅範囲が広がります。

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.

（実際の出力を、長さの都合で一部省略しています。最終行に注目してください。エンジンが失敗した場合、残りの結果を黙って平均してスコアとして扱うのではなく、レポートにその旨が記載されます。）

ご自身のキーで実行でき、完全な監査でも通常は数セント程度です。

エージェントから使う

MCP サーバーとして提供されるため、Claude、ChatGPT、または MCP 対応エージェントから直接実行できます：

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	AI 対応状況を11項目で監査	不要
audit_plan	キー不要の監査に向けた、サイト情報と尋ねるべき購入者の質問	不要
audit_score	エージェントが見つけた内容を評価：可視性、ランキング、引用ギャップ	不要
audit_visibility	複数エンジンでのブラインド可視性チェックと回答の逐語記録	BYO
citation_gap	負けている質問で引用されたソース	BYO
engine_status	このインストールで照会できるエンジン	不要

知りたい情報を得るのに API キーは必要ありません。 audit_plan と audit_score を使えば、今会話しているアシスタント自体をエンジンとして利用できます。アシスタントがサイトを取得し、購入者の質問を作成し、独自のウェブ検索で回答して、その結果を評価用に渡します。「自分のサイトは AI 検索で表示されますか？」と尋ねれば、登録もキーも請求も不要で、実際の引用ギャップがわかります。

計算は引き続きこのツールが行い、ブランド名を含む質問は引き続き拒否します。このガードがあるからこそ、その数値に価値があります。レポートに明記されるとおり、そのアシスタントでの可視性を測定します。エンジン横断の状況を把握するには、独自のキーを使って audit を実行してください。

エージェントが数値の解釈方法を理解できるよう、SKILL.md も用意されています。準備状況は可視性とは異なること、0% は通常の開始地点であること、エンジンのカバー範囲が部分的な場合は部分的だと報告することを説明しています。

ライブラリとして使う

import { checkReadiness } from 'crazyseo';

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

無料で使える理由

ここにあるものはすべて永久に無料、セルフホスト可能、AGPLです。すべての機能を利用でき、機能制限もテレメトリーもアカウントもなく、出力にアップセルも含まれません。

現在、有料プランはなく、この README でもそのように装うつもりはありません。もし将来登場するとしても、セルフホストでは本当に提供できない、定期的な再実行、履歴の保存、アラートという唯一の機能に限られます。自分で何も実行せずに、数か月にわたる数値の変化を追うためのインフラです。監査機能そのものは、完全な状態で、AGPL のもとにここで提供され続けます。

また、「将来クローズドになるのを防ぐものは何か」という問いへの答えも、ライセンスです。ホスト型サービスとして提供する人は、作成者も含め、自分のバージョンもオープンにしなければなりません。

コントリビュート

Issue や PR を歓迎します。チェック項目は意図的に慎重に選んでいます。どの項目も、アシスタントまたはそのクローラーが実際に依存していて、手作業で検証できるものでなければなりません。そのように正当化できないチェック項目は、ここには含めません。

CONTRIBUTING.md では、セットアップ方法、新しいチェック項目が満たすべき基準、エンジンアダプターに必要な要件を説明しています。

ライセンス

AGPL-3.0。 使用、フォーク、商用利用、自分のツールへの組み込みが可能です。 ホスト型サービスとして他者に提供する場合、そのサービスもオープンにしなければなりません。

---