GSC ブランド vs ノンブランド — ブランドトラフィック分割分析

@skills/seo/references/mcp-degradation.md @skills/seo/references/gsc-api-reference.md

オーガニックトラフィックのうち、ブランド検索と汎用検索からのシェアを分析します。 重要: このコマンドはAPI呼び出しを行う前に、ユーザーが提供するブランド用語を必須としています。 analyze_brand_queries ツールには brandTerms 配列が必要です — ブランド用語を推測してはいけません。

MCP チェック

GSCツールを呼び出す前に、MCPが接続されていることを確認します:

1. +google-search-console というクエリで ToolSearch を使用します
2. ツールが返された場合 — 実際のツール名プレフィックスをメモして、「入力」に進みます
3. ツールが返されない場合 — references/mcp-degradation.md の GSC MCP エラーテンプレートを表示して停止します:

## Google Search Console MCP が利用できません

`/seo gsc brand-vs-nonbrand` コマンドは、現在接続されていない GSC MCP を必要とします。

**実行可能な操作:**
- `/seo technical <url>` を使用してクローラビリティとインデックス性の分析を実行します (ライブデータなし)
- `/seo audit <url>` を使用して完全な静的 SEO 監査を実行します

**GSC MCP を接続するには:**
- Google Search Console MCP サーバーをインストールして設定します (セットアップは README を参照)
- ~/.claude/mcp.json に ユーザースコープで追加します (プロジェクトスコープではなく)
- コマンド実行前に GSC プロパティアクセスを確認します (ドメイン形式と URL プレフィックス形式)
- プロパティ形式の詳細については references/gsc-api-reference.md を参照します

入力

• site: GSC プロパティ URL。両方の形式に対応:
  • ドメインプロパティ: sc-domain:example.com
  • URL プレフィックス: https://example.com または https://www.example.com
  • ユーザーが非修飾ドメイン (プレフィックスなし) を提供する場合、list_sites を呼び出して GSC に登録されている正しいプロパティ形式を特定します。

ブランド用語の確認 (必須 — API呼び出し前に実施)

analyze_brand_queries を呼び出す前に、ユーザーはブランド用語を確認する必要があります。

1. サイト URL からブランド用語を抽出します:

   • sc-domain:example.com → ["example"] を提案
   • https://www.mybrand.co.uk → ["mybrand"] を提案
   • 提案から TLD、www、サブドメイン、ハイフンを削除します

2. ユーザーに確認プロンプトを提示します:

[site] のブランド vs ノンブランドトラフィックを分析します。

**ブランド用語を確認してください:** `["[suggested-term]"]`

以下の操作ができます:
- これらの用語をそのまま確認する
- 追加の用語を追加する (例: 製品名、一般的なスペルミス): `["brand", "brand product", "brandname"]`
- 実際のブランド化されていない用語を削除する

ブランド用語は、ブランド化されたクエリ (例: "acme widgets") とノンブランドクエリ (例: "best widgets for home") を分離するために使用されます。ユーザーがブランドを検索するすべてのバリエーションを含めます。

3. ユーザーがブランド用語を確認または修正するのを待ちます。
4. 明示的な確認を受けた後にのみ、API呼び出しに進みます。

日付計算

Bash を使用して日付を計算します (GSC には約 3 日の遅延があります):

endDate=$(date -v-3d +%Y-%m-%d)
startDate=$(date -v-31d +%Y-%m-%d)
echo "endDate: $endDate | startDate: $startDate"

実行

ブランド用語が確認された後:

以下で analyze_brand_queries を呼び出します:

• siteUrl: サイトプロパティ
• startDate: 計算された startDate
• endDate: 計算された endDate
• brandTerms: 確認されたブランド用語の配列

後処理:

• ブランドの総クリックに対するパーセンテージを計算します: (brandClicks / totalClicks) * 100
• ノンブランドのパーセンテージを計算します: (nonBrandClicks / totalClicks) * 100
• ブランドパーセンテージに基づいて戦略的なインサイトを追加します:

  • 70% ブランド化: 依存リスクに注意 — オーガニック表示はブランドに大きく依存している

  • 40-70% ブランド化: バランスの取れた混合 — ブランド認知度が健全でノンブランド成長がある
  • 10-40% ブランド化: ノンブランド主導 — ブランド検索を超えた良好なオーガニックリーチ
  • <10% ブランド化: ブランド認知度の機会に注意 — ブランド構築コンテンツの検討を推奨

CTR表示ルール: API は CTR を小数で返します — 表示するには 100 を乗算します。

出力形式

## GSC ブランド vs ノンブランド: [site property]
**期間:** [startDate] から [endDate] (28 日間)
**分析したブランド用語:** [確認されたブランド用語のリスト]

### ブランドトラフィック分割
| カテゴリ | クリック数 | インプレッション数 | CTR | 平均掲載順位 | 総クリック数に占める割合 |
|----------|--------|-------------|-----|--------------|-------------------|
| ブランド化 | [n] | [n] | [X.XX%] | [X.X] | [X.X%] |
| ノンブランド | [n] | [n] | [X.XX%] | [X.X] | [X.F%] |
| **合計** | **[n]** | **[n]** | **[X.XX%]** | **[X.X]** | **100%** |

### トップ ブランド化クエリ
| クエリ | クリック数 | インプレッション数 | CTR | 掲載順位 |
|-------|--------|-------------|-----|----------|
| [query] | [n] | [n] | [X.XX%] | [X.X] |
...

### トップ ノンブランドクエリ
| クエリ | クリック数 | インプレッション数 | CTR | 掲載順位 |
|-------|--------|-------------|-----|----------|
| [query] | [n] | [n] | [X.XX%] | [X.X] |
...

### 戦略的インサイト
[上記のブランドパーセンテージしきい値に基づくインサイト]

クリック数の降順でソートされた、トップ 10 のブランド化クエリとトップ 10 のノンブランドクエリを表示します。