gsc-assistant について
gsc-assistantは、Google Search Consoleのインデックス状況をMarkdownファイルで管理するスキルです。サイトマップとインデックス済みページを照合し、エクスポートの遅延も別途記録します。
主な機能
- 01サイトマップとインデックス済みページの照合
- 02インデックス済みページと未登録リストの管理
- 03エクスポート確認済みと遅延確認の区別
- 04未登録の誤判定ページの処理
- 05送信日と進捗統計の記録
活用シーン
- 01GSCエクスポートとサイトマップから管理ファイルを作成
- 02URL Inspection後に登録状況を更新
- 03ページの送信日を記録
- 04新しいエクスポートで記録を更新
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ nicepkg/ ai-workflow --skill gsc-assistantインストール後、Claude Code で/gsc-assistantを入力して読み込まれたか確認します。
詳細
GSC アシスタントスキル
目的
このスキルは、2 つの Markdown 追跡ファイルを管理して、Google Search Console のインデックス登録状況を管理します。
-
indexed.md - インデックス登録済みのすべてのページを、次の 2 つの表にまとめます。
- 「Indexed Public」 - GSC エクスポートデータで確認済みの URL
- 「Indexed With Lag」 - URL 検査で確認済みの URL(エクスポートにはまだ反映されていないもの)
-
to-index.md - インデックス登録待ちのページを管理します。
- サイトマップとインデックス登録済み URL の合計数との差分
- カテゴリー別に優先順位を設定(変更可能)
- 送信日を記録
このスキルを使用する場面
- ユーザーが「インデックス登録状況」または「GSC のインデックス登録」について尋ねるとき
- ユーザーが「サイトマップとインデックス登録済みページを比較」したいとき
- ユーザーが「URL 検査」または「誤検知」について言及するとき
- ユーザーが「送信状況」または「インデックス登録の進捗」を追跡する必要があるとき
- ユーザーが「インデックス登録済みページを移動」または「インデックス登録状況を更新」したいとき
- ユーザーが「インデックス登録レポートを生成」したいとき
主な概念
GSC データの遅延
Google Search Console のエクスポートデータには、約 2 週間の遅延があります。URL 検査ではインデックス登録済みと表示されるページでも、まだエクスポートに反映されていない場合があります。これらは「Indexed With Lag」として別途記録します。
誤検知
URL 検査でインデックス登録待ちページを確認する場合:
- インデックス登録済みの場合は、「Submitted」列に「false positive - indexed」と記録します
- 前処理で、これらを indexed.md の「Indexed With Lag」表に移動します
- 「Detected」日は、該当項目が to-index に追加された日から推定します
優先順位カテゴリー
to-index.md では、ページを優先順位別に整理します。
- 優先度 1:価値の高いコンテンツシリーズ
- 優先度 2:最近のコンテンツ(今年/前年)
- 優先度 3:特定のコンテンツコレクション
- それより低い優先度:アーカイブページ、ページネーションなど
ファイルのスキーマ
indexed.md
# Indexed Pages
## Indexed Public (GSC Export)
*Last updated: YYYY-MM-DD*
*Source: gsc-export.csv*
| # | URL | Last Crawled |
|---|-----|--------------|
| 1 | https://example.com/page-1/ | 2025-12-01 |
| 2 | https://example.com/page-2/ | 2025-12-02 |
## Indexed With Lag (URL Inspection Confirmed)
*Pages confirmed indexed via URL Inspection but not yet in GSC export*
| # | URL | Detected | Confirmed |
|---|-----|----------|-----------|
| 1 | https://example.com/new-page/ | 12 Dec 2025 | 12 Dec 2025 |
to-index.md
# Pages To Index
*Generated: YYYY-MM-DD*
*Total: X pages*
## Priority 1: [Category Name]
| # | URL | Submitted |
|---|-----|-----------|
| 1 | https://example.com/important-page/ | 12 Dec |
| 2 | https://example.com/another-page/ | - |
## Priority 2: [Category Name]
| # | URL | Submitted |
|---|-----|-----------|
| 1 | https://example.com/recent-post/ | - |
ワークフロー
初期設定
- GSC エクスポート CSV をインポートして indexed.md(Indexed Public 表)を作成します
- サイトマップの URL を抽出します
- 差分を計算します(サイトマップ - インデックス登録済み = to-index)
- to-index ページを優先順位別に分類します
- to-index.md を生成します
定期更新
- 前処理:「false positive - indexed」と記録された項目が to-index.md にないか確認します
- 誤検知を indexed.md(Indexed With Lag 表)に移動します
- 項目が to-index に含まれていた時点から「Detected」日を設定します
- 現在の日付を「Confirmed」日に設定します
- to-index.md から項目を削除します
- 件数と統計情報を更新します
手動操作
- 送信を記録する:「Submitted」列を日付で更新します
- 状況を確認する:URL 検査を使用し、結果を記録します
- データを更新する:新しい GSC エクスポートをインポートして再計算します
設定
プロジェクトディレクトリに作業ファイルを作成します。
project/
├── gsc-export.csv # GSC indexed pages export
├── sitemap.xml # Site sitemap (or use dist/sitemap.xml)
├── indexed.md # Tracking file (generated)
└── to-index.md # Tracking file (generated)
コマンド
初期ファイルを生成
"Generate indexing tracking files from GSC export and sitemap"
誤検知を前処理
"Process false positives and update indexed list"
送信状況を更新
"Mark [URL] as submitted on [date]"
新しいエクスポートから更新
"Update indexed list from new GSC export"
統計情報を生成
"Show indexing progress statistics"
統計情報の出力
INDEXING STATUS SUMMARY
=======================
Indexed Public (GSC): 789 pages
Indexed With Lag: 12 pages
Total Indexed: 801 pages
Sitemap Total: 2,054 pages
To Index: 1,253 pages
Progress: 39.0%
By Priority:
- Priority 1: 55 remaining (4 false positives moved)
- Priority 2: 7 remaining
- Priority 3: 290 remaining
使用例
ユーザー:「GSC の URL 検査でいくつかの URL を確認して、『false positive - indexed』と記録しました。それらを処理して、追跡ファイルを更新してください。」
Claude の処理:
- 「false positive - indexed」と記録された項目を to-index.md から検索します
- 該当する URL と元の検出日を抽出します
- それらを indexed.md の Indexed With Lag 表に追加します
- to-index.md から削除します
- 行番号と件数を更新します
- 実施した変更を報告します
コメント
Markdown 対応