SEO 管理画面

niki-nakamura.github.io/til/ の SEO / KW / トピッククラスター戦略を一元管理するディレクトリ。 Jekyll ビルドからは _config.yml で除外しているので、公開サイトには出ない。

構造

seo/
├── README.md         このファイル
├── KEYWORDS.md       KW 管理（target / current rank / SV / status）
├── CLUSTERS.md       トピッククラスター戦略（pillar ↔ cluster の関係図）
├── METRICS.md        GSC / GA から取得した時系列メトリクス
├── config.json       site URL / property ID / GA property 等の設定（gitignored）
├── config.example.json   設定テンプレ
├── package.json      Node 依存（googleapis）
├── scripts/
│   ├── fetch-gsc.mjs       GSC API → data/gsc-*.json
│   ├── fetch-ga.mjs        GA4 Data API → data/ga-*.json
│   ├── update-rankings.mjs KEYWORDS.md を data から書き戻す
│   └── weekly-report.mjs   METRICS.md を週次で更新
├── data/             API 取得結果（gitignored）
└── credentials/      service-account.json 等（gitignored）

初期セットアップ

1. 依存インストール

cd seo
npm install

2. Google Cloud 側の準備

GCP プロジェクト作成（既存 HT プロジェクトでも可）
Search Console API と Google Analytics Data API を有効化
サービスアカウント作成 → JSON キーを seo/credentials/service-account.json に保存
GSC: search.google.com/search-console の対象プロパティ設定 → ユーザーと権限 → サービスアカウントのメールを「制限付き」で追加
GA4: 管理 → プロパティアクセス管理 → サービスアカウントのメールを「閲覧者」で追加

3. config 作成

cp config.example.json config.json

config.json を編集して siteUrl / gscProperty / gaPropertyId を埋める。

4. 動作確認

node scripts/fetch-gsc.mjs
node scripts/fetch-ga.mjs

data/ に JSON が落ちれば OK。

運用ワークフロー

日次（最低限）

何もしなくていい。週次でまとめる。

週次（Niki 手動 or schedule skill）

node scripts/fetch-gsc.mjs   # 直近 7 日分の query / impression / click / position
node scripts/fetch-ga.mjs    # 直近 7 日分の sessions / users / engagement
node scripts/update-rankings.mjs  # KEYWORDS.md の current rank 列を更新
node scripts/weekly-report.mjs    # METRICS.md に行を追加

月次（戦略レビュー）

CLUSTERS.md を見直し: pillar 記事の更新、cluster の追加/削除
KEYWORDS.md の status を再評価: 「target」のままだが順位が動かない KW は cluster 戦略を疑う

トピッククラスター戦略の基本

1 つの pillar（広いテーマ、深い記事）を中心に、複数の cluster（具体トピック）が内部リンクで繋がる構造。

pillar: TIL カテゴリ単位（cognition / thinking / git / design / claude）
cluster: 個別 TIL エントリ
内部リンク: pillar ↔ cluster は双方向、cluster ↔ cluster は関連がある時のみ

検索意図が広い KW（例: "メタ認知"）は pillar に、絞った KW（例: "メタ認知学習やり方"）は cluster に当てる。

CLAUDE.md からの自動参照

このディレクトリを Claude Code で扱う時は、seo/CLAUDE.md か repo root の CLAUDE.md で > 新規 TIL を書く前に seo/KEYWORDS.md の未着手 KW と seo/CLUSTERS.md の cluster 計画を確認するを強制すると、書く題材選びが戦略連動になる。