name: seo-search-console description: SEO最適化とSearch Console運用を一貫管理する。プロパティ登録、サイトマップ提出、メトリクス収集、検索可視性の定量評価、SEOファイル（sitemap/robots/OG）の配備を含む。「SEO」「Search Console」「検索順位」「インデックス」「サイトマップ」「robots」「検索流入」「CTR改善」「掲載順位」などの作業に使う。

SEO & Search Console Skill

概要

craftgarden.studio 傘下の全プロダクトについて、SEO技術基盤の構築と Search Console による検索パフォーマンスの定量計測を一貫管理する。

責務の分界:

本スキル: SEO技術基盤（sitemap/robots/OG）+ Search Console（登録・サイトマップ提出・メトリクス収集・分析）
analytics スキル: GA4（タグ配信・PV/セッション/ユーザー計測）
ai-search-readiness スキル: AI検索（GEO/AEO/LLMO最適化・ChatGPT/Perplexity向け）

アーキテクチャ

環境情報

項目	値
ドメインプロパティ	sc-domain:craftgarden.studio
サービスアカウント	analytics-agent@craftgarden-488320.iam.gserviceaccount.com
認証JSON	~/.config/gcloud/service-accounts/craftgarden-analytics.json
レジストリ	~/Dev/product-hub/scripts/config/gsc-registry.json
メトリクス出力	~/Dev/product-hub/packages/dashboard/public/data/gsc-metrics.json
GCP プロジェクト	craftgarden-488320
有効API	Search Console API, Site Verification API
DNS管理	AWS Route 53 (Hosted Zone: Z02122701AQ4170J8PPI9)
ドメイン検証TXT	google-site-verification=jFj3prr4LgUjPdP0oWlCTCDGYltdeSCKgfFFFW3Vmko

登録済みプロパティ

→ 詳細: references/registered-properties.md

管理コマンド（Product Hub）

→ スクリプト: scripts/gsc-commands.sh

cd ~/Dev/product-hub
pnpm collect:gsc          # メトリクス収集
pnpm gsc:setup            # プロパティ登録
pnpm gsc:sitemaps         # サイトマップ提出
pnpm collect:monitoring   # モニタリングスキャン

検索可視性の定量指標

→ 詳細: references/metrics-guide.md

SEO 技術基盤（3点セット）

全 Web プロダクトに sitemap.ts, robots.ts, OG画像の3点セットを配備する。

→ テンプレート: references/template-seo-nextjs.md

新規プロジェクトへの GSC 追加手順

SEO 3点セットを配備 — sitemap.ts, robots.ts, OG画像を追加。commit & push
レジストリに追加 — gsc-registry.json の properties にエントリ追加（→ references/example-registry-entry.json）
プロパティ登録 — pnpm gsc:setup（ドメインプロパティ verified 済みのためサブドメインは自動アクセス可能）
サイトマップ提出 — pnpm gsc:sitemaps（HEAD リクエストで sitemap.xml の存在を確認後に提出）
モニタリング反映 — pnpm collect:monitoring → pnpm collect:gsc（初回データは2-3日後から蓄積）

Site Verification API の制約

サービスアカウントによる DNS 自動検証は既知のバグ（503 backendError）で失敗する。対処法:

ドメイン検証: Search Console UI で手動実施（1回だけ）
サービスアカウント権限付与: Search Console UI → 設定 → ユーザーと権限 → 所有者として追加
サブドメイン: ドメインプロパティが verified であれば、sites.add で URL プレフィックスを API 登録可能（追加の検証不要）

ダッシュボード連携

/monitoring ページで以下を可視化:

Overview タブ: Search Console 登録状況（gsc-registry.json ベース）
Search Console タブ: Clicks / Impressions / CTR / Avg Position / Indexed Pages / Queries / 7d Sparkline / Top Query
サマリーカード: 全プロパティ横断の Total Clicks, Impressions, CTR, Avg Position, Indexed Pages, Query Diversity

判定ロジック: scan-monitoring.js は gsc-registry.json の登録状態で Search Console の enabled を判定（SEOファイル存在チェックではない）。SEOファイルの有無はダッシュボードの SEO フィルタで別途管理。

分析パターン

→ 詳細: references/analysis-patterns.md

API 認証

→ 詳細: references/api-auth.md

よくある落とし穴

データが0のまま焦る: Search Console のデータ反映には2-3日の遅延がある。プロパティ登録直後にデータが0なのは正常。サイトマップ提出済みか、robots.txt が Googlebot をブロックしていないかを確認した上で、数日待つ
Site Verification API の DNS 自動検証が 503 で失敗する: サービスアカウントによる DNS 検証は既知のバグ。ドメイン検証は Search Console UI で手動実施（1回だけ）し、サービスアカウントを siteOwner として追加するハイブリッドアプローチが必要
プロパティ登録で 403: サービスアカウントがドメインプロパティの siteOwner か確認する。Search Console UI → 設定 → ユーザーと権限
サイトマップ提出がスキップされる: sitemap.xml がデプロイ済みでないと提出できない（HEAD リクエストで200返却が必要）。Next.js の場合 src/app/sitemap.ts を配置してデプロイしてから再実行
output: "export" の Next.js で sitemap.ts / robots.ts が動かない: 静的エクスポートプロジェクトでは export const dynamic = "force-static" が必要
@next/third-parties のバージョン不整合: Next.js のメジャーバージョンと @next/third-parties のメジャーバージョンを揃える必要がある。Next.js 15 に対して v16 を入れるとビルドエラーになる
Vercel Hobby プランのデプロイ上限: 日次100デプロイ上限がある。一括配備時は注意