aeo

ChatGPT、Perplexity、Gemini、Grok、Claude、DeepSeek などの AI 検索エンジンでのブランドの表示状況を示す、Answer Engine Optimization（AEO）の確認と改善をユーザーが行えるよう支援します。

すべての作業には npx goose-aeo@latest CLI を使用します。機械可読な出力を得るため、必ず --json を使用し、対話形式のプロンプトには頼らないでください。

自動検出：ユーザーに必要なことは？

何かを始める前に、現在の状態を確認します。

cat .goose-aeo.yml 2>/dev/null || echo "NOT_FOUND"

次に、状態とユーザーの依頼に応じて処理を振り分けます。

状態	ユーザーの発言	アクション
.goose-aeo.yml がない	AEO に関することなら何でも	セットアップから開始
設定ファイルがあり、実行履歴がない	「実行」「確認」「分析」	分析の実行へ進む
設定ファイルがあり、実行履歴がある	「実行」「確認」	分析の実行へ進む
設定ファイルがあり、実行履歴がある	「監査」「サイトをスコアリングして」	ウェブサイト監査へ進む
設定ファイルがあり、実行履歴がある	「おすすめを教えて」「何をすればいい？」	おすすめへ進む
設定ファイルがあり、実行履歴がある	一般的な AEO の依頼	ステータスの概要を示し、すべての選択肢を提示

判断に迷った場合は、npx goose-aeo@latest status --json を実行して全体像（会社名、クエリ数、過去の実行履歴）を確認し、何をしたいかユーザーに尋ねてください。

---

セットアップ

ドメインの AEO トラッキングを設定します。必要な情報を集めるため、ユーザーと自然な会話を行ってください。

情報の収集

ユーザーに次の情報を尋ねます。

• 会社のドメイン（例：athina.ai）— 必須
• 会社名（例："Athina AI"）— 提供されていない場合は、ドメインから推定
• 競合他社を数社 — 「主な競合他社はどこですか？」と尋ねます。わからない場合は、自動で検出すると伝えてください。
• モニタリングする AI エンジン — デフォルトは Perplexity、OpenAI、Gemini です。Grok、Claude、DeepSeek を追加するか尋ねてください。プロバイダーを増やすほど、実行あたりのコストが高くなります。

会社のドメインがわかるまでは、先に進まないでください。

前提条件の確認

利用可能な API キーを確認します。

node -e "
const keys = {
  GOOSE_AEO_PERPLEXITY_API_KEY: !!process.env.GOOSE_AEO_PERPLEXITY_API_KEY,
  GOOSE_AEO_OPENAI_API_KEY: !!process.env.GOOSE_AEO_OPENAI_API_KEY,
  GOOSE_AEO_GEMINI_API_KEY: !!process.env.GOOSE_AEO_GEMINI_API_KEY,
  GOOSE_AEO_GROK_API_KEY: !!process.env.GOOSE_AEO_GROK_API_KEY,
  GOOSE_AEO_CLAUDE_API_KEY: !!process.env.GOOSE_AEO_CLAUDE_API_KEY,
  GOOSE_AEO_DEEPSEEK_API_KEY: !!process.env.GOOSE_AEO_DEEPSEEK_API_KEY,
  GOOSE_AEO_FIRECRAWL_API_KEY: !!process.env.GOOSE_AEO_FIRECRAWL_API_KEY,
};
console.log(JSON.stringify(keys, null, 2));
"

設定済みのキーと、選択したプロバイダーに必要なキーのうち不足しているものをユーザーに伝えてください。キーが不足している場合は、値を提供するよう依頼します。値を受け取ったら、.env に書き込みます。

echo 'GOOSE_AEO_PERPLEXITY_API_KEY=pplx-...' >> .env

GOOSE_AEO_OPENAI_API_KEY は、モニタリング対象のプロバイダーとして使うためだけでなく、クエリの生成と分析にも必要です。この点を必ずユーザーに伝えてください。

Init の実行

ユーザーから聞いた情報に基づいてフラグを組み立てます。

npx goose-aeo@latest init \
  --domain <domain> \
  --name "<company name>" \
  --providers <comma-separated-providers> \
  --competitors "<comma-separated-competitor-domains>" \
  --json

ユーザーから競合他社の情報が提供されなかった場合、このツールは（API キーが設定されていれば）Perplexity を使って自動的に検出します。

設定された競合他社とプロバイダーをユーザーに示してください。「これらの競合他社でよさそうですか？追加または削除したいものはありますか？」と尋ねます。

変更を希望する場合は、.goose-aeo.yml を直接編集し、init を再実行しないでください。

クエリの生成

確認用に少量のクエリを生成します。

npx goose-aeo@latest queries generate --limit 10 --dry-run --json

クエリを読みやすい番号付きリストで表示します。「見込み顧客が検索しそうな内容として、これらは適切ですか？」と尋ねます。

クエリの内容が的外れな場合は、.goose-aeo.yml の会社概要を更新して再生成します。特定のクエリを追加するには、npx goose-aeo@latest queries add "<query text>" --json を実行します。削除するには、npx goose-aeo@latest queries remove <id> --json を実行します。

承認されたら、全件を生成します。

npx goose-aeo@latest queries generate --limit 50 --json

次のステップへの引き継ぎ

セットアップが完了したことをユーザーに伝え、すぐに最初の分析を実行するか尋ねます。概算コストは、50 件のクエリ x 3 プロバイダーで 1 回あたり約 $2-5 です。

---

分析の実行

AI 検索エンジンでクエリを実行し、表示状況レポートを生成します。

実行前の確認

npx goose-aeo@latest status --json

会社名、クエリ数、過去の実行回数を表示します。

コストの見積もり

npx goose-aeo@latest run --dry-run --json

クエリ数、使用するプロバイダー、API 呼び出しの合計数、推定コストをユーザーに伝えます。実行前に確認を求めてください。

実行

npx goose-aeo@latest run --confirm --json

数分かかることがあります。実行中であることをユーザーに伝えてください。

分析

npx goose-aeo@latest analyze --json

分析した回答数、分析コスト、指標の低下によるアラートがあれば、その内容を伝えてください。

レポート

npx goose-aeo@latest report --json

生の数値をそのまま並べず、会話形式の要約を提示します。

• 全体的な可視性： 言及率、目立ち度スコア、シェア・オブ・ボイス
• プロバイダー別： エンジンごとの言及率
• 主なインサイト： 最も優れた／最も低いプロバイダー、競合との比較、アラート
• おすすめ： 結果に基づく、実行可能な提案を2〜3件

次のステップ

次の項目を提示します。

1. 「ダッシュボードを見る」 — npx goose-aeo@latest dashboard
2. 「ウェブサイトを監査する」 — ウェブサイトの読みやすさ監査を実行
3. 「おすすめを取得する」 — 詳細な改善案
4. 「前回の実行と比較する」 — 実行結果が2件以上ある場合、差分を実行

---

ウェブサイト監査

ウェブサイトのページを取得し、それぞれを6つの観点で評価して、AI検索での読みやすさを測定します。

実行前の確認

npx goose-aeo@latest status --json

セットアップが完了していない場合は、まずセットアップするよう案内します。

監査の実行

npx goose-aeo@latest audit --json

ページを取得してそれぞれを評価するため、1〜2分ほどかかる場合があります。

結果の提示

全体スコア：「サイトのAI検索における読みやすさのスコアはX.X / 10です」

• 7以上：最適化されています
• 4〜7：改善の余地があります
• 4未満：大幅な改善が必要です

ページごとのハイライト： スコアが最も高いページと最も低いページ。

項目別の内訳 — 最も優れている項目と最も弱い項目を説明します。

• ポジショニングの明確さ： サイトの冒頭で、何をしているのかを明確に説明していますか？
• 構造化されたコンテンツ： AIが解析できる見出し、リスト、FAQをページで使用していますか？
• クエリとの整合性： コンテンツはユーザーがAIエンジンに尋ねる内容と一致していますか？
• 技術的なシグナル： スキーママークアップ、メタディスクリプション、クリーンなHTMLを使用していますか？
• コンテンツの詳しさ： AIが意味のある引用を作成するのに十分な詳細がありますか？
• 比較コンテンツ： 代替サービスとの比較を掲載していますか？

おすすめ： 実行可能な項目を番号付きで提示します。

修正の提案

スコアが最も低い項目に基づき、具体的な対応を提案します。

• structuredContentのスコアが低い場合：「主要なページにFAQセクションを追加しましょうか？」
• comparisonContentのスコアが低い場合：「比較ページを作成しましょうか？」
• queryAlignmentのスコアが低い場合：「追跡中のクエリに答えるコンテンツページを作成しましょうか？」
• technicalSignalsのスコアが低い場合：「メタディスクリプションを改善して、スキーママークアップを追加しましょうか？」
• positioningClarityのスコアが低い場合：「ホームページの導入部分を書き直しましょうか？」
• contentDepthのスコアが低い場合：「内容が最も薄いページのコンテンツを拡充しましょうか？」

---

おすすめ

最新の実行データを分析し、可視性を改善するための実行可能な提案を作成します。

実行前の確認

npx goose-aeo@latest status --json

実行結果がない場合は、まず分析を実行するようユーザーに伝えます。

生成

npx goose-aeo@latest recommend --json

結果の提示

全体の要約： ブランドのAI可視性に関する全体像。

可視性のギャップ： ギャップごとに、トピック、該当するクエリ、代わりに言及されている競合、および具体的な提案を示します。

情報源の機会： AIエンジンが頻繁に引用するドメイン、その引用頻度、および掲載してもらう方法。

競合に関するインサイト： どの競合が、どのクエリで優れているか、また競合がどのような違う取り組みをしている可能性があるか。

次のステップの提案

1. 「ギャップを埋めるコンテンツを作成する」 — 可視性のギャップを埋めるブログ記事、ランディングページ、FAQコンテンツを作成
2. 「比較ページを作成する」 — 代わりに競合が言及されている場合に、比較ページを下書き
3. 「ゲスト投稿の依頼文を書く」 — 情報源として有望なドメインへの働きかけを下書き
4. 「クエリを更新する」 — おすすめで提案された新しいクエリの切り口を追加
5. 「ダッシュボードを見る」 — npx goose-aeo@latest dashboard で視覚的に確認

---

エラーハンドリング

• 「会社が見つかりません」／.goose-aeo.yml がありません：まずセットアップを実行してください。
• 「GOOSE_AEO_OPENAI_API_KEY is required」：環境変数を設定するようユーザーに伝えてください。クエリの生成、分析、推奨事項の作成に必要です。
• プロバイダーの API キーがありません：必要なキーと設定方法をユーザーに伝えてください。
• 監査中にページが一つもスクレイピングされませんでした：.goose-aeo.yml のドメインと、サイトが一般公開されているかを確認してください。
• 可視性がすべてゼロです：これは、AI エンジンがまだブランドに言及していないことを意味すると説明してください。ここが改善の出発点です。
• 実行に部分的な失敗がありました：成功したプロバイダーもある可能性があります。エラー数を確認し、失敗したプロバイダーを報告してください。
• エラーを黙って握りつぶさないでください。必ず表示し、解決策を提案してください。