mcpField
S
seo-visual

seo-visual

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

seo-visual について

SEO監査のビジュアルチェックを担当する専門スキルです。ファーストビューやモバイルレイアウト、タッチ領域、フォントサイズを確認し、レポートやスクリーンショットを出力できます。

主な機能

  1. 01ファーストビューのH1とCTA表示確認
  2. 02モバイル表示と横スクロールの確認
  3. 03タッチ領域と最小フォントサイズの確認
  4. 04複数ビューポートのスクリーンショット撮影
  5. 05ビジュアル監査レポートと概要の出力

活用シーン

  1. 01ファーストビューの表示内容の確認
  2. 02モバイルの横方向のはみ出し検出
  3. 03タッチ領域と文字サイズの評価
  4. 04ビジュアル監査用レポートと画像の保存

インストール

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

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

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

詳細

ビジュアルスペシャリスト

フル監査のビジュアルサブトラックで使用します。

共有データキャッシュ

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

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

このスペシャリストは、新たにビジュアルチェックを実行する前に、上流キャッシュの入力を必要としません。

  • 見つかった場合：前提となるキャッシュは不要です。現在のビジュアルキャプチャのワークフローを続行します
  • 見つからない場合：通常どおり進め、新しいビジュアルデータを収集します
  • JSON が破損している、または読み取れない場合：キャッシュがないものとして扱い、通常どおり続行します
  • ユーザーが「refresh」または「re-run」と言った場合：キャッシュを完全に無視します

入力

  • URL
  • タイムアウト
  • ビジュアルモード（on|off|auto）

出力

  • VISUAL-AUDIT-REPORT.md
  • SUMMARY.json
  • screenshots/（Playwright が利用可能な場合）

チェック項目

  • ファーストビュー内での H1 と CTA の表示
  • モバイルのビューポートと横スクロール
  • タッチターゲットのサイズと最小フォントサイズ
  • 複数のビューポートでのスクリーンショット

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

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

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

../seo/references/shared-data-cache.md のスキーマを使用して、.seo-cache/pages/{url-slug}/visual.json を書き込みます。 ドキュメントに記載されたトップレベルのキー（cache_type、analyzed_at、url、url_slug、score、layout_summary、issues）を保持してください。 ビジュアルに関する追加情報は、above_fold、mobile、screenshots、notes などの補足フィールドとしてのみ追加します。

まだ .gitignore に含まれていない場合は、.seo-cache/ を追加します：

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

ユーザーが「クライアントレポート」または「プレミアム成果物」をリクエストした場合は、自動的に ../seo-audit/assets/report-template.html と ../seo/references/premium-report-standard.md を読み込みます。レポートの標準として、そのレポート基準をデフォルトのブリーフに使用します。HTML を内部中間成果物として生成してから、公開する成果物として PDF を作成します。ユーザーから HTML ファイルを明示的に求められない限り、最終回答では PDF のみを記載します。

コメント

Markdown 対応