Communitygithub.com

AndresOrozcoDev/website

SEOmator CLIを使用して、SEO、技術面、コンテンツ、セキュリティ、JavaScriptレンダリング、AI対応状況を監査します。251ルール・20カテゴリにわたるヘルススコアを含むLLM最適化レポートを出力します。Webサイト分析、SEO問題のデバッグ、サイトヘルスの確認に使用します。

website とは?

このスキルは、AIエージェントがSEOmator CLIを使用してWebサイトの包括的なSEO監査を実行できるようにします。評価対象は、コアSEO、パフォーマンス、リンク、画像、セキュリティ、技術SEO、クローラビリティ、構造化データ、JavaScriptレンダリング、アクセシビリティ、コンテンツ、ソーシャル、E-E-A-T、URL構造、リダイレクト、モバイル、国際化、HTML検証、AI/GEO対応、法的コンプライアンスの20カテゴリ、251ルールです。監査結果は、0~100の総合ヘルススコア(A~Fのグレード付き)、カテゴリ別の合格/警告/不合格の内訳、具体的な問題と影響を受けるURL、そしてアクション可能な修正提案を含むレポートとして提供されます。特に、`--format llm`フラグを使用すると、AIエージェント向けにトークン最適化されたXML出力(JSON比で50~70%削減)が得られ、効率的な解析が可能です。このスキルは、SEO健康状態の分析、技術的SEO問題のデバッグ、壊れたリンクの確認、メタタグや構造化データの検証、セキュリティヘッダーの監査、アクセシビリティ準拠の確認、JavaScriptレンダリングとSSR互換性の分析、AI/GEO対応状況の評価など、幅広いユースケースに適しています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AndresOrozcoDev/website/tree/HEAD/.agents/skills/seo-audit

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

SEO監査スキル

SEOmator CLIを使用して、WebサイトのSEO、技術面、コンテンツ、パフォーマンス、セキュリティ、JavaScriptレンダリング、AI対応状況を監査します。

SEOmatorは、251ルール・20カテゴリにわたってWebサイトの構造とコンテンツを分析し、包括的なWebサイト監査を提供します。

問題の重大度、影響を受けるURL、および実行可能な修正提案のリストを出力します。

リンク

このスキルが行うこと

このスキルにより、AIエージェントは20カテゴリ、251ルールにわたってWebサイトを監査できます。主なカテゴリは以下の通りです:

  • コアSEO (19ルール): 正規URL、インデックス指示、タイトルの一意性、正規URLの競合/ループ
  • パフォーマンス (22ルール): LCP、CLS、FCP、TTFB、INP、圧縮、キャッシュ、ミニフィケーション、HTTP/2
  • リンク (19ルール): 壊れたリンク、リダイレクトチェーン、アンカーテキスト、孤立ページ、localhost/フラグメントリンク
  • 画像 (14ルール): Altテキスト、寸法、遅延読み込み、モダンフォーマット、altテキスト長、背景画像
  • セキュリティ (16ルール): HTTPS、HSTS、CSP、外部リンクの安全性、漏洩したシークレット、SSL有効期限/プロトコル
  • 技術SEO (13ルール): robots.txt、sitemap.xml、URL構造、404ページ、ソフト404、エラーコード
  • クローラビリティ (18ルール): Sitemapの競合、インデックス可能性シグナル、正規URLチェーン、ページネーション問題
  • 構造化データ (13ルール): Schema.orgマークアップ、Article、Organization、FAQ、Product、Breadcrumb
  • JavaScriptレンダリング (13ルール): レンダリングされたDOMチェック、生DOMとレンダリング後の不一致、SSR検出
  • アクセシビリティ (12ルール): ARIAラベル、色のコントラスト、フォームラベル、ランドマーク、タッチターゲット
  • コンテンツ (17ルール): 単語数、可読性、キーワード密度、重複検出、ピクセル幅
  • ソーシャル (9ルール): Open Graphタグ、Twitterカード、共有ボタン、プロフィールリンク
  • E-E-A-T (14ルール): 著者情報、引用、信頼シグナル、概要/お問い合わせページ、YMYL検出
  • URL構造 (14ルール): キーワードスラッグ、ストップワード、大文字、アンダースコア、セッションID、トラッキングパラメータ
  • リダイレクト (8ルール): リダイレクトループ、タイプ(301/302)、メタリフレッシュ、JavaScriptリダイレクト、壊れたリダイレクト
  • モバイル (5ルール): フォントサイズ、横スクロール、侵入型インタースティシャル、ビューポート問題
  • 国際化 (10ルール): lang属性、hreflang検証(戻りリンク、競合、不一致)
  • HTML検証 (9ルール): ドキュメントタイプ、charset、head構造、Lorem ipsum、複数のタイトル/説明
  • AI/GEO対応 (5ルール): セマンティックHTML、AIボットアクセス、llms.txt、スキーマのドリフト
  • 法的コンプライアンス (1ルール): Cookie同意

監査はWebサイトをクロールし、各ページを監査ルールに対して分析し、以下を含む包括的なレポートを返します:

  • 総合ヘルススコア(0-100)と文字グレード(A-F)
  • カテゴリ別の合格/警告/不合格の内訳
  • 特定された問題と、問題ごとにグループ化された影響を受けるURL
  • 実行可能な修正の推奨事項

使用すべきタイミング

以下の場合にこのスキルを使用します:

  • WebサイトのSEO健全性を分析する
  • 技術的なSEO問題をデバッグする
  • 壊れたリンクやリダイレクトチェーンを確認する
  • メタタグ、正規URL、構造化データを検証する
  • セキュリティヘッダー、SSL、HTTPSを監査する
  • アクセシビリティコンプライアンスを確認する
  • JavaScriptレンダリングとSSR互換性を分析する
  • AI/GEO対応状況(セマンティックHTML、llms.txt、ボットアクセス)を評価する
  • ページ間の重複コンテンツを検出する
  • hreflangと国際化設定を検証する
  • HTML文書構造と検証を確認する
  • 複数の形式でサイト監査レポートを生成する
  • 変更前後のサイト健全性を比較する

前提条件

このスキルを使用するには、SEOmator CLIがインストールされている必要があります。

インストール

npm install -g @seomator/seo-audit

インストールの確認

seomatorがインストールされ、システムが準備できていることを確認します:

seomator self doctor

これにより以下をチェックします:

  • Node.jsバージョン(18以上推奨)
  • npmの利用可能性
  • Core Web VitalsとJSレンダリング用のChrome/Chromium
  • ~/.seomatorへの書き込み権限
  • ローカル設定ファイルの存在

セットアップ

seomator initを実行すると、カレントディレクトリにseomator.toml設定ファイルが作成されます。

seomator init                    # 対話型セットアップ
seomator init -y                 # デフォルト設定を使用
seomator init --preset blog      # ブログ最適化設定
seomator init --preset ecommerce # ECサイト設定
seomator init --preset ci        # 最小限のCI設定

ディレクトリにseomator.tomlが存在しない場合は、監査を実行する前に seomator init で作成してください。

使用方法

AIエージェントのベストプラクティス

--format llmを常に優先してください - これはAIエージェント向けに特別に設計されたトークン最適化されたXML出力を提供します(JSONよりも50~70%縮小)。

監査時の注意点:

  1. 精度の高いパフォーマンスとレンダリングデータを得るには、ローカル開発サーバーよりも本番Webサイトを優先してください
  2. Core Web VitalsとJSレンダリングチェックが不要な場合は、--no-cwvを使用して監査を高速化します
  3. 複数の修正を実装する場合は、並行タスクとして範囲を分割します
  4. 修正実装後は型チェック/フォーマット(tsc、eslint、prettierなど)を実行します

Webサイトの特定

ユーザーが監査するWebサイトを指定しない場合:

  1. ローカル開発サーバーの設定(package.jsonのscripts、.envファイル)を確認します
  2. Vercel/Netlifyのプロジェクトリンクを探します
  3. 環境変数でデプロイメントURLを確認します
  4. 監査するURLをユーザーに尋ねます

ローカルサイトと本番サイトの両方が利用可能な場合は、正確な結果を得るために本番サイトの監査を提案します。

基本的なワークフロー

# LLM出力を使用した迅速な単一ページ監査
seomator audit https://example.com --format llm --no-cwv

# マルチページクロール(最大50ページ)
seomator audit https://example.com --crawl -m 50 --format llm --no-cwv

# Core Web Vitals + JSレンダリング分析を含む完全監査
seomator audit https://example.com --crawl -m 20 --format llm

高度なオプション

キャッシュを無視して強制的に新規クロール:

seomator audit https://example.com --refresh --format llm

中断されたクロールを再開:

seomator audit https://example.com --resume --format llm

特定のカテゴリのみを監査:

seomator audit https://example.com -c core,security,js --format llm --no-cwv

共有用のHTMLレポートを保存:

seomator audit https://example.com --format html -o report.html

デバッグ用の詳細出力:

seomator audit https://example.com --format llm -v

コマンドリファレンス

監査コマンドオプション

オプションエイリアス説明デフォルト
--format <fmt>-f出力形式: console, json, html, markdown, llmconsole
--max-pages <n>-mクロールする最大ページ数10
--crawlマルチページクロールを有効化false
--categories <list>-c監査するカテゴリのカンマ区切りリストすべて
--refresh-rキャッシュを無視して新規取得false
--resume中断されたクロールを再開false
--no-cwvCore Web Vitals + JSレンダリングをスキップfalse
--verbose-v進捗を表示false
--output <path>-o出力ファイルパス
--config <path>設定ファイルパス
--save~/.seomatorに保存false

その他のコマンド

seomator init              # 設定ファイルを作成
seomator self doctor       # システムセットアップを確認
seomator config --list     # すべての設定値を表示
seomator report --list     # 過去のレポートを一覧表示
seomator db stats          # データベース統計を表示

出力形式

形式フラグ最適な用途
console--format console人間向けターミナル出力(デフォルト)
json--format jsonCI/CD、プログラム処理
html--format htmlスタンドアロンレポート、共有
markdown--format markdownドキュメント、GitHub
llm--format llmAIエージェント(推奨)

--format llm出力は、トークン効率のために最適化されたコンパクトなXML形式です:

  • JSON出力と比較して50~70%縮小
  • 問題は重大度順にソート(クリティカルが最初)
  • 各問題に修正提案が含まれます
  • AIツールへのパイプラインに適したクリーンなstdout

使用例

例1: LLM出力を使用した迅速な監査

# ユーザー: 「example.comのSEO問題を確認して」
seomator audit https://example.com --format llm --no-cwv

例2: 大規模サイトの詳細クロール

# ユーザー: 「最大100ページまで詳細に監査して」
seomator audit https://example.com --crawl -m 100 --format llm --no-cwv

例3: 変更後の新規監査

# ユーザー: 「キャッシュされた結果は無視して、サイトを再監査して」
seomator audit https://example.com --refresh --format llm --no-cwv

例4: 共有可能なレポートの生成

# ユーザー: 「共有できるHTMLレポートを作成して」
seomator audit https://example.com --crawl -m 20 --format html -o seo-report.html

例5: 特定領域にフォーカス

# ユーザー: 「JavaScriptレンダリングとリダイレクトだけ確認して」
seomator audit https://example.com -c js,redirect --format llm

結果の評価

スコア範囲

スコアグレード意味
90-100A優秀 - 軽微な最適化のみ
80-89B良好 - 警告に対処すべき
70-79C改善が必要 - 優先的な修正が必要
50-69D不良 - 複数のクリティカルな問題
0-49F重大 - 解決すべき主要な問題

優先順位(カテゴリの重み順)

最大の効果を得るために、以下の順序で問題を修正してください:

  1. コア (12%) - メタタグ、正規URL、H1、インデックス
  2. パフォーマンス (12%) - Core Web Vitals + 最適化
  3. リンク (8%) - 内部リンク構造
  4. 画像 (8%) - パフォーマンス + アクセシビリティ
  5. セキュリティ (8%) - 信頼シグナル、SSL
  6. 技術SEO (7%) - クローリングの基盤
  7. クローラビリティ (5%) - インデックス可能性、ページネーション
  8. 構造化データ (5%) - リッチスニペット
  9. JavaScriptレンダリング (5%) - レンダリングされたDOM、SSR
  10. コンテンツ (5%) - テキスト品質 + 重複
  11. アクセシビリティ (4%) - WCAG準拠
  12. ソーシャル (3%) - ソーシャルシェア
  13. E-E-A-T (3%) - 信頼性、専門性
  14. URL構造 (3%) - URLの衛生
  15. リダイレクト (3%) - リダイレクトチェーン
  16. モバイル (2%) - ビューポート、フォント
  17. 国際化 (2%) - hreflang
  18. HTML検証 (2%) - 文書構造
  19. AI/GEO対応 (2%) - セマンティックHTML、AIボット
  20. 法的コンプライアンス (1%) - Cookie同意

重大度別の修正

  1. 不合格 (status: "fail") - 直ちに修正が必要
  2. 警告 (status: "warn") - 近いうちに修正すべき
  3. 合格 (status: "pass") - アクション不要

出力サマリー

修正を実装した後、ユーザーに行ったすべての変更のサマリーを提供します。

範囲を計画する際は、実装を高速化するためにサブエージェントとして並行実行できるようにタスクを整理します。

トラブルシューティング

seomatorコマンドが見つからない

このエラーが表示された場合、seomatorがインストールされていないか、PATHに含まれていません。

解決策:

npm install -g @seomator/seo-audit

Core Web Vitalsが測定されない

CWVメトリクスが欠落している場合、Chrome/Chromiumが利用できない可能性があります。

解決策:

  1. Chrome、Chromium、またはEdgeをインストールします
  2. seomator self doctorを実行してブラウザ検出を確認します
  3. CWVが不要な場合は--no-cwvを使用してスキップします

クロールのタイムアウトまたはパフォーマンス低下

大規模なサイトの場合、監査に数分かかる場合があります。

解決策:

  • --verboseを使用して進捗を確認します
  • -m 20でページ数を制限して結果を高速化します
  • --no-cwvを使用してブラウザベースの測定をスキップします

無効なURL

URLにプロトコルが含まれていることを確認してください:

# 間違い
seomator audit example.com

# 正しい
seomator audit https://example.com

仕組み

  1. 取得: ページのHTMLをダウンロードし、応答時間を計測します
  2. 解析: DOM、メタタグ、リンク、画像、構造化データを抽出します
  3. 拡充: 監査ごとにrobots.txtとsitemap.xmlを1回取得します
  4. レンダリング(CWV有効時): Playwrightを介してレンダリングされたDOMをキャプチャし、JSレンダリング分析を行います
  5. クロール(有効時): リンク先のページを発見して取得します
  6. 分析: 各ページに対して251の監査ルールを実行します
  7. スコアリング: カテゴリ別および総合的な重み付けスコアを計算します
  8. レポート: 要求された形式で出力を生成します

結果は~/.seomator/に保存され、後でseomator reportで取得できます。

リソース

  • 全ルールリファレンス: すべての251ルールについてはdocs/SEO-AUDIT-RULES.mdを参照
  • ストレージアーキテクチャ: データベースの詳細についてはdocs/STORAGE-ARCHITECTURE.mdを参照
  • CLIヘルプ: seomator --helpおよびseomator <command> --help

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

AndresOrozcoDev/website

Frontend design skill that generates, restyles, and guides UI development in mager's signature aesthetic — hot, sleek, sexy, usable, fun, and addictive interfaces with dark-first themes, terminal-inspired typography, neon accents, and visual discovery patterns. Use this skill when building or reviewing any frontend UI.

AndresOrozcoDev/website

Generate beautiful, production-ready, animated single-file HTML landing pages. Use this skill whenever the user asks to create a landing page, marketing page, product page, startup homepage, SaaS landing, app launch page, waitlist page, or any promotional single-page site. Also trigger when user says "make a landing for...", "generate landing page", "build me a homepage", "create a product page", "landing page for my startup", or asks to improve/redesign an existing landing page. Covers both "from scratch" generation and "improve/convert" workflows. Outputs one self-contained HTML file with Tailwind CSS, vanilla JS animations, responsive design, dark/light mode, and curated visual style presets. Always use this skill even for simple landing requests — it ensures premium, non-generic output.

AndresOrozcoDev/website

This skill should be used when the user asks to "write SEO content", "create a blog post", "write an article", "content writing for SEO", "draft optimized content", "write a how-to guide", "create a product description", "write a landing page", "SEO copywriting", "draft content targeting [keyword]", or "write 2000-word article about [topic]". Creates keyword-optimized content using a 12-step workflow: CORE-EEAT pre-write checklist, keyword integration, title optimization (5 formula options), meta description, H1/H2/H3 hierarchy, featured snippet targeting, internal/external linking, and readability enhancement. Produces full drafts with embedded SEO elements, title variants, meta description, FAQ section with schema, and a self-scored CORE-EEAT checklist. For AI-citation optimization, see geo-content-optimizer. For updating existing content, see content-refresher.

関連スキル