mcpField
S
seo-performance

seo-performance

github.com/agricidanielマーケティング・グロース88574 回インストール1 週間前に更新
リポジトリ

seo-performance について

seo-performance は、SEO 監査向けのパフォーマンス分析スキルです。PageSpeed Insights / CrUX の実ユーザーデータを優先し、利用できない場合はラボデータや推定値を明確に区別して使います。

主な機能

  1. 01Lighthouse のモバイル・デスクトップスコア確認
  2. 02LCP、CLS、取得可能な INP の測定
  3. 03INP がない場合のラボ指標としての TBT 報告
  4. 04API データがない場合の代替案内
  5. 05監査レポートと JSON サマリーの出力
  6. 06結果の共有キャッシュへの保存

活用シーン

  1. 01ページのコアウェブバイタル確認
  2. 02実ユーザーデータがない場合のラボデータ確認
  3. 03パフォーマンス課題の優先順位付け

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/agricidaniel/codex-seo --skill seo-performance

インストール後、Claude Code で/seo-performanceを入力して読み込まれたか確認します。

詳細

パフォーマンス専門家

包括的な監査で、パフォーマンスのサブトラックに使用します。

共有データキャッシュ

ステップ 0 -- 共有データキャッシュを確認する：

データを収集する前に、他のスキルによるキャッシュ済みデータが .seo-cache/ にあるか確認します。 スキーマと依存関係マップについては、../seo/references/shared-data-cache.md を参照してください。

この専門家は、新たにパフォーマンスチェックを実行する前に、上流キャッシュの入力を必要としません。

  • 見つかった場合：前提条件となるキャッシュは不要です。現在の測定を続行します
  • 見つからない場合：通常どおり進め、新しいパフォーマンスデータを収集します
  • ユーザーが「refresh」または「re-run」と指示した場合：キャッシュを完全に無視します

入力

  • URL
  • タイムアウト
  • 任意の PageSpeed API キー（PAGESPEED_API_KEY）

実行手順

API／ヘッドレス環境で決定論的なパフォーマンス分析を行うには、scripts/analyze_performance.py の実行を優先します。このスクリプトは、利用可能な場合は PageSpeed のデータを使用し、利用できない場合はラベル付けされたヒューリスティックにフォールバックするため、人手を介さずにパイプラインを完了できます。

出力

  • PERFORMANCE-AUDIT-REPORT.md
  • SUMMARY.json

主なチェック項目

  • 利用可能な場合は、PageSpeed Insights／CrUX の実ユーザー CWV データを優先します
  • 実ユーザーデータを利用できない場合は、Lighthouse のラボデータにフォールバックし、ラボデータであることを明確に示します
  • Lighthouse のパフォーマンススコア（利用可能な場合はモバイル＋デスクトップ）
  • LCP と CLS の測定値
  • データソースが実際に提供している場合に限り INP を使用します。TBT から INP を捏造したり推定したりしないでください
  • INP を利用できない場合、TBT はラボ環境の代替指標として報告できます
  • API データが利用できない場合、クォータ制限を受けた場合、または認証されていない場合の代替手順

優先度ルール

  • 高：パフォーマンススコア < 70、LCP > 2500ms、INP > 200ms、または CLS > 0.1
  • 中：パフォーマンススコア 70-79
  • 低：データソースの制限

共有データキャッシュへの書き込み

すべての作業を完了したら、結果を .seo-cache/ に書き込みます。

mkdir -p .seo-cache/pages/{url-slug}

../seo/references/shared-data-cache.md のスキーマを使って、.seo-cache/pages/{url-slug}/performance.json を作成します。最低限、ドキュメントに記載されたキャッシュキーである core_web_vitals と issues を使用してください。ドキュメントに記載されたキーを置き換えたり名前を変更したりしない限り、役立つ追加フィールドを加えてもかまいません。

.gitignore に .seo-cache/ がまだ記載されていない場合は追加します：

grep -qxF '.seo-cache/' .gitignore 2>/dev/null || echo '.seo-cache/' >> .gitignore
プレミアム成果物

ユーザーが「client report」または「premium deliverable」を依頼した場合は、自動的に ../seo-audit/assets/report-template.html と ../seo/references/premium-report-standard.md を読み込みます。そのレポート標準をデフォルトの依頼内容として使用します。HTML を内部の中間成果物として生成し、その後、公開用の成果物として PDF を作成します。ユーザーが HTML ファイルを明示的に求めない限り、最終回答では PDF のみを記載してください。

コメント

Markdown 対応