# 検索エンジン最適化監査エージェントスキル > クロードコード、オープンクロー、コーデックス向けの軽量検索エンジン最適化監査エージェントスキル。迅速な単一ページの検索エンジン最適化監査を実行し、主要なオンページおよびサイトレベルの問題をチェックし、実用的な修正を含む構造化された検索エンジン最適化レポートを生成します。 - Canonical: https://nanoskill.ai/ja/skills/seo-audit - Markdown: https://nanoskill.ai/ja/skills/seo-audit.md - Author: JeffLi1993 - Published: 2026-05-11T01:05:35.771Z - Updated: 2026-07-25T04:34:17.896Z - Language: ja - Source type: github - Popularity signal: 382 ## Sources - https://github.com/JeffLi1993/seo-audit-skill ## Install ```shell npx skills add JeffLi1993/seo-audit-skill ``` ## About 検索エンジン最適化監査は、クロードコード、オープンクロー、コーデックスなどのAIコーディングエージェント向けの軽量検索エンジン最適化監査エージェントスキルです。エージェントが単一のURLを検査し、主要な検索エンジン最適化の問題をチェックし、証拠、影響、推奨修正を含む構造化された監査レポートを生成するのを支援します。 このスキルは、タイトルタグ、メタディスクリプション、H1タグ、カノニカルタグ、画像のaltテキスト、キーワード配置、robots.txt、sitemap.xml、404処理、URL正規化、経験・専門性・権威性・信頼性の信頼ページ、JSON-LDスキーマ検証など、初回パスの検索エンジン最適化チェックに焦点を当てています。 ページを公開する前の迅速な検索エンジン最適化ヘルスチェック、ランディングページのレビュー、基本的なランキング問題の診断、またはより深い技術的な検索エンジン最適化監査が必要かどうかの判断に使用します。 ## Key features - **迅速な単一ページSEO監査**: 任意のURLに対して高速なSEO監査を実行し、完全なクローラーや解析ワークフローを設定することなく、ページのSEO健全性の初期評価を取得します。 - **コアオンページSEOチェック**: タイトルタグ、メタディスクリプション、H1タグ、カノニカルタグ、画像のaltテキスト、見出し構造、キーワードの配置、内部リンク、単語数をチェックします。 - **サイトレベルSEOの基礎**: robots.txt、sitemap.xml、404エラーハンドリング、URL正規化、i18n / hreflang、E-E-A-T信頼ページなどの基本的なSEOシグナルを確認します。 - **JSON-LDスキーマ検証**: ページが適切な構造化データを持っているか検出し、一般的なスキーマタイプを検証し、欠落または不完全なJSON-LDフィールドにフラグを立てます。 - **構造化SEO監査レポート**: 合格、警告、失敗のステータスに加えて、各重要な問題に対する証拠、影響、具体的な修正内容を含むクリーンなSEO監査レポートを生成します。 ## Use cases - **公開前にランディングページを監査**: ホームページ、製品ページ、ツールページ、SEOランディングページを公開する前にこのスキルを使用して、基本的なSEO問題を早期に発見します。 - **迅速なSEO健全性チェックを実行**: ページに適切なタイトル、メタディスクリプション、H1、カノニカルタグ、スキーマ、内部リンク、その他の基本的なSEOシグナルがあるかをチェックします。 - **順位問題のある既存ページをレビュー**: インデックスされているがランキングが振るわないページ、または明らかなオンページおよびサイトレベルの問題を迅速に特定したい場合に使用します。 ## Result preview このエージェントスキルによって生成された実際の検索エンジン最適化監査結果をご覧ください。 ![seo-audit-demo](https://file.nanoskill.ai/seo-audit-demo-1.png) ![seo-audit-demo-2](https://file.nanoskill.ai/seo-audit-demo-2.png) ![seo-audit-demo-3](https://file.nanoskill.ai/seo-audit-demo-3.png) ## Result walkthrough ### ステップ1：インストール エージェントにスキルを追加する ![seo-audit-step-1](https://file.nanoskill.ai/seo-audit-step-1.png) ### ステップ2：監査タスク 1つのURLを使用し、優先順位付きの監査を依頼します。 ![seo-audit-step-2](https://file.nanoskill.ai/seo-audit-step-2.png) ### ステップ3：結果のレビュー すぐに実行できる優先順位付きの検索エンジン最適化の修正を取得します。 ![seo-audit-step-3](https://file.nanoskill.ai/seo-audit-step-3.png) ## Skill definition # seo-audit — 基本SEO監査 シンプルなSEOエージェントスキルで、迅速かつデフォルトの単一ページSEO監査向けに設計されています。OpenClawによって駆動。初回のページチェックや、完全な技術的詳細を必要としない迅速な評価に適しています。 --- ## このスキルを使用するタイミング 以下の場合に`seo-audit`を使用します。 - ユーザーが言った場合: "audit this page", "check SEO", "analyze my URL", "quick SEO check", "what's wrong with my page" - 特定の深さが要求されていない — これがデフォルトのエントリーポイントです - ユーザーが包括的な技術的ブレイクダウンではなく、速く読めるサマリーを必要としている場合 より深い分析が必要な場合は、`seo-audit-full`にアップグレードしてください: > **ヒント:** 深いテクニカル監査、高度なオンページSEO、または完全なレポートには、`seo-audit-full`スキルを使用してください。 --- ## 期待される入力 | 入力 | 必須 | 注意 | |-------|----------|-------| | ページURL | はい | The page to audit | | 生のHTMLまたはページコンテンツ | オプション | Enables more accurate on-page analysis | | GSC / アナリティクスデータ | オプション | Not required for basic audit | URLのみが提供され、ソースコードやクローラーデータが利用できない場合は、明確に述べてください: > **制限:** This audit is based on visible page content and publicly available signals only. Source code, GSC data, crawl logs, and performance metrics are not available for this audit. --- ## 出力 テンプレート[assets/report-template.html](assets/report-template.html)に記入して**基本SEO監査レポート**を作成し、 **ファイルに保存してください — 端末に生のHTMLを表示しないでください**。 **ファイル命名:** `reports/--audit.html` ``` https://example.com/blog/best-tools → reports/example-com-blog-best-tools-audit.html https://example.com/ → reports/example-com-audit.html ``` **保存後、ユーザーに伝える:** ``` ✅ Report saved → reports/example-com-audit.html Open it now? (yes / no) ``` はいの場合 → 実行: `open reports/example-com-audit.html` --- **テンプレートのプレースホルダー** — それぞれ独立して記入してください: | プレースホルダー | 内容 | |---|---| | `{{summary_verdict}}` | One sentence: total checks run, how many failed/warned/passed | | `{{summary_critical_html}}` | `
  • ` per critical (fail) item, or `
  • None
    • ` | | `{{summary_warnings_html}}` | `
  • ` per warning item, or `
  • None
    • ` | | `{{summary_passing_html}}` | `
  • ` per passing check, or `
  • None
    • ` | --- ## スクリプト 所見を書く前にこれらのスクリプトを実行してください。構造化されたJSONを出力します — JSONを証拠として直接使用し、同じURLを手動で再取得しないでください。 **依存関係:** `pip install requests` (html parsing uses Python stdlib) ```bash # Step 1: site-level checks (robots.txt + sitemap.xml) python scripts/check-site.py https://example.com # Step 2: page-level checks (H1, title, meta description, canonical) python scripts/check-page.py https://example.com # With primary keyword (recommended — enables H1 keyword presence check) python scripts/check-page.py https://example.com --keyword "running shoes" # Optional: fetch raw page HTML for further inspection python scripts/fetch-page.py https://example.com --output page.html # Step 3: JSON-LD schema validation python scripts/check-schema.py https://example.com # Or from previously fetched HTML (avoids redundant fetch): python scripts/check-schema.py --file page.html ``` 各スクリプトはコード`0`（すべて合格/警告）または`1`（失敗/エラーあり）で終了します。 **厳密な範囲 — 以下にリストされていないチェックを追加しないでください。例外はありません。** 許可されたサイトレベルチェック (`{{site_checks_html}}`内): - robots.txt · sitemap.xml · 404 Handling · URL Canonicalization · i18n / hreflang 許可されたE-E-A-Tチェック (`{{eeat_checks_html}}`内): - About Us · Contact · Privacy Policy · Terms of Service · Media/Partners (only if present) 許可されたページレベルチェック (`{{page_checks_html}}`内)、この正確な順序で出力: URL Slug · Title Tag · Meta Description · H1 Tag · Canonical Tag · Image Alt Text · Word Count · Keyword Placement · Heading Structure · Internal Links · Schema (JSON-LD) Image Alt Text logic: - Parse tags from static HTML - Pass: all images have non-empty alt (decorative images with alt="" are OK) - Warn: any content image missing alt attribute - Unverified (status-info): 0 images found in static HTML → likely JS-rendered, cannot verify ⛔ ハードルール — report-template.htmlで定義されたチェック行のみを出力してください。 上記の許可リストにないチェックは、問題を見つけても出力しないでください。 例外はありません。「ボーナス」チェックや即興もありません。 テンプレートが唯一の真実のソースです。厳密なホワイトリストとして扱ってください。 依然として禁止 (seo-audit-fullに属するもの): OG tags · Twitter Card · Social tags · Page Weight · Core Web Vitals · Robots Meta **JSON出力の使用方法:** - Map each field's `status` → `pass` / `warn` / `fail` / `error` directly to the report check table - Use each field's `detail` string as the starting point for the Evidence line in findings - Do not contradict the script output unless you have additional observable evidence - Separate check groups with `
    Label
    ` inside `{{site_checks_html}}`: `Crawlability` · `URL Canonicalization` · `i18n / hreflang` · `Schema (JSON-LD)` and `
    E-E-A-T Trust Pages
    ` before `{{eeat_checks_html}}` **LLMレビュー — `llm_review_required: true`の場合必須:** スクリプトは、意味的または品質的な判断が必要で、それ自身では実行できないフィールドにフラグを立てます。 `llm_review_required: true`を未解決のままにしないでください — 常に明示的な判断を下してください。 **H1 — `keyword_match == "partial"`の場合にトリガー:** ``` h1_text : (from h1.values[0]) keyword : (the --keyword passed to the script) Judge: Does this H1 semantically cover the keyword's search intent? - Consider synonyms, natural variants, topic coverage - yes → downgrade to "pass", note the variant - no → keep "warn" or upgrade to "fail", explain the gap ``` **タイトル — `keyword_match == "partial"`または`keyword_position != "start"`の場合にトリガー:** ``` title : (from title.value) keyword : (the --keyword passed) Judge: 1. Does the title semantically cover the keyword's search intent? 2. Is the title grammatically correct and naturally readable? 3. Keyword position — apply different standards by page type: - Homepage : Brand + core keyword is correct (e.g. "Acme | AI Workflow Automation") Do NOT flag brand-first as a problem. - Inner pages: Core keyword should lead (e.g. "AI Workflow Automation for Teams — Acme") Flag if keyword is buried mid-title without good reason. IMPORTANT — do NOT flag these as negatives: - Years (e.g. "2026") → signal freshness, increase CTR — treat as positive unless the page is explicitly evergreen content where dating would hurt longevity. - Numbers (e.g. "5 best", "Top 10", "3 steps") → set clear expectations, consistently outperform non-numeric titles in CTR — always treat as a plus. - Specific qualifiers ("Open-Source", "Self-Hosted", "Free") → narrow intent and attract higher-quality clicks — do not penalize. ``` **URLスラッグ — `keyword_match != "full"`または`is_homepage == false`の場合にトリガー:** ``` slug : (from url_slug.slug) keyword : (the --keyword passed) Judge: 1. Does the slug contain the primary keyword or a natural variant? 2. Is the path hierarchy logical? (/category/keyword is ideal) 3. Is it concise and human-readable? Homepage (is_homepage: true): skip — no judgment needed. ``` **メタディスクリプション — コンテンツが存在する場合常にトリガー:** ``` meta_description : (from meta_description.value) keyword : (the --keyword passed) Judge all four: 1. Complete sentence(s)? (1-2 sentences, no fragments) 2. Mentions a concrete result — not vague fluff? Good: "Cut design time by 60% with AI-powered templates" Bad: "The best tool for all your design needs" 3. Keyword or natural synonym used once — not stuffed? 4. More specific than what a typical competitor would write? IMPORTANT — do NOT flag these as negatives: - Years (e.g. "2026") → signal freshness, improve CTR for time-sensitive queries. Only note the year if the page is explicitly evergreen content where dating hurts. - Numbers (e.g. "5 best", "3 steps") → concrete specificity, strong CTR signal. - Trailing "and more." → minor style note at most, never a Warning or Fail. ``` --- ## 推奨ワークフロー 以下の手順を順番に実行してください: 1. **範囲の確認** — confirm this is a basic audit; note any missing data 2. **主要キーワードの推測** — fetch the page with `fetch-page.py`, then determine the primary keyword: - If the user explicitly provided a keyword → use it directly - If not → read the page H1, title, and first paragraph, then infer the single most likely target keyword phrase (what would a searcher type to find this page?) - State the inferred keyword explicitly before running checks: > "Inferred primary keyword: **open source claude alternatives**" 3. **`check-site.py`の実行** — parse the JSON output for robots, sitemap, 404 handling, and URL canonicalization **404 check:** fetch `/this-page-definitely-does-not-exist-seo-audit-check` - Returns 404 → Pass · Returns 200 (soft 404) → Fail · Returns 301 to homepage → Warn **URL Canonicalization checks** (each is a separate sub-check): - **HTTP→HTTPS:** fetch `http://` — must 301 to `https://`. Returns 200 → Fail. - **www consistency:** fetch both `https://www.` and `https://` — one must 301 to the other. Both return 200 → Warn. - **Trailing slash:** compare the URL actually served vs the canonical tag on the page. Mismatch → Warn. - **Canonical match:** canonical tag href must exactly match the final URL after all redirects. Mismatch → Warn. 4. **E-E-A-Tインフラストラクチャチェック** — for each trust page below, check two layers: - **Layer 1 — Exists:** fetch the URL, check HTTP status (200 = exists, 404/redirect = missing) - **Layer 2 — Reachable:** fetch homepage HTML, check if footer or nav contains a link to this page | Page | Required | |---|---| | About Us | Yes | | Contact | Yes | | Privacy Policy | Yes | | Terms of Service | Yes | | Media / Partners | No — include only if present | Status rules: - Page missing (non-200) → **Fail** - Page exists but not linked in footer/nav → **Warn** - Page exists and linked in footer/nav → **Pass** - Optional page missing → skip, do not include row 5. **`check-page.py --keyword "<推測したキーワード>"`の実行** — parse the JSON output for H1, title, meta description, canonical, and URL slug 6. **i18n / hreflangチェック** — only run if the page contains hreflang tags or `` suggests multi-language: - **Skip entirely (N/A)** if no hreflang tags found and site appears single-language - If hreflang tags present, check: - **Reciprocal symmetry**: every URL referenced must link back to all other variants — any broken link = Fail - **Language codes**: must be valid BCP 47 (e.g. `zh-CN` not `zh`, `en-US` not `en-us`) — wrong code = Warn - **x-default**: should be present for language-selector or fallback pages — missing = Warn - **html[lang] attribute**: must match the primary hreflang of the page — mismatch = Warn - **URL structure**: recommended pattern — default language (usually `en`) at root with no prefix, other languages under subpaths (`/zh/`, `/es/`). - `/page` (en) + `/zh/page` + `/es/page` → Pass - `/en/page` + `/zh/page` → Warn (en prefix is redundant, wastes crawl depth) - Only flag if the pattern is clearly inconsistent or en is unnecessarily prefixed 7. **`check-schema.py`の実行** — parse the JSON output for schema types and field validation ```bash python scripts/check-schema.py https://example.com # Or from previously fetched HTML: python scripts/check-schema.py --file page.html ``` The script extracts JSON-LD blocks, validates `@type` and required fields per Schema.org spec. `llm_review_required: true` is always set — confirm `inferred_page_type` matches actual page content. Page type → expected `@type` reference: | Page Type | Expected @type | Min. required fields | |---|---|---| | Homepage | WebSite + Organization | name, url, logo | | Blog / Article | Article or BlogPosting | headline, datePublished, author, image | | Product | Product | name, image, offers (price, priceCurrency) | | FAQ | FAQPage | mainEntity[].name, acceptedAnswer.text | | How-to | HowTo | name, step[].text | | Local business | LocalBusiness | name, address, telephone | | Generic landing | — | N/A — skip, no widely-supported type | - Pass: correct @type present, all required fields valid, no conflicts - Warn: @type present but missing recommended fields - Fail: expected @type missing entirely - N/A: generic landing page — do not penalize 8. **所見の要約** — each finding must follow the Evidence / Impact / Fix format 9. **優先アクション** — list the top 3 highest-impact fixes 10. **レポートのレンダリング** — save to `reports/--audit.html`, then ask user to open 11. **アップグレードプロンプト** — if issues beyond basic scope are found, suggest `seo-audit-full` --- ## レポート詳細の記述ルール **The Detail cell in check tables must follow these rules — no exceptions:** **Pass → one short phrase. No lists, no elaboration.** ``` Good: "Valid XML urlset · 104 URLs · referenced in robots.txt." Bad: "Valid XML urlset with 104 URLs. Correctly referenced in robots.txt. Blog posts are likely indexed through this sitemap." ``` **Warn → one `
    ` with ≤2 bullet points. One `
    ` with the fix.** ``` Good:
    · Title 48 chars — 2 below minimum. · Year "2026" will date the page.
    Expand to 50–60 chars; remove year if evergreen.
    Bad: three-sentence prose explaining what a title tag is and why length matters. ``` **Fail → same as Warn. Lead with the exact failure. No background explanations.** Do NOT explain what a check is, do NOT repeat information already visible in the status badge, do NOT treat the reader as unfamiliar with SEO basics. --- ## 必須の所見フォーマット すべての重要な所見は**必ず**この構造に従ってください: ``` **Finding: [Finding Title]** - **Evidence:** [What was observed — direct quote, screenshot ref, or measurable data] - **Impact:** [Why this matters for SEO or UX] - **Fix:** [Specific, actionable recommendation] ``` Do not write vague conclusions. If evidence is insufficient, state assumptions explicitly. --- ## アップグレードプロンプト すべての基本監査レポートの最後に以下を含めてください: > **Want a deeper analysis?** > This was a basic SEO audit covering site-level signals and core on-page checks. > For advanced technical SEO, content quality scoring, structured data analysis, and full crawl-based findings, use the `seo-audit-full` skill. --- ## 参照ファイル - Detailed audit scope and field definitions: [references/REFERENCE.md](references/REFERENCE.md) - Final HTML report template: [assets/report-template.html](assets/report-template.html) - Site-level check script: [scripts/check-site.py](scripts/check-site.py) - Page-level check script: [scripts/check-page.py](scripts/check-page.py) - Raw page fetcher: [scripts/fetch-page.py](scripts/fetch-page.py) - Schema validation script: [scripts/check-schema.py](scripts/check-schema.py) ## FAQ ### SEO監査エージェントスキルとは何ですか？ SEO監査エージェントスキルは、AIエージェントがWebページを検査し、SEOの問題をチェックし、構造化された監査レポートを生成するのを支援する再利用可能なワークフローです。このスキルは、Claude Code、OpenClaw、Codexワークフロー内での迅速な単一ページSEO監査用に設計されています。 ### SEO監査スキルは何をチェックしますか？ タイトルタグ、メタディスクリプション、H1タグ、カノニカルタグ、画像のaltテキスト、キーワードの配置、内部リンク、robots.txt、sitemap.xml、404エラーハンドリング、URL正規化、信頼ページ、JSON-LDスキーマなど、コアなオンページSEOと基本的なサイトレベルのシグナルをチェックします。 ### これは完全なテクニカルSEO監査ですか？ いいえ。これは単一ページ向けの軽量な初回通過SEO監査です。迅速なチェックや基本的な問題検出に役立ちます。クロールベースの監査、Core Web Vitals、インデックス診断、ログ分析、高度なテクニカルSEOには、完全なSEO監査ワークフローを使用してください。 ### 誰がこのSEO監査エージェントスキルを使用すべきですか？ 公開前や改善前に迅速にページをチェックしたいSEO担当者、SaaS創業者、独立系開発者、マーケター、コンテンツチーム、開発者にとって役立ちます。 ### どのようなレポートが生成されますか？ 合格、警告、失敗のステータスを含む構造化されたSEO監査レポートを生成します。重要な調査結果には、証拠、SEOへの影響、具体的な修正内容が含まれ、開発者やコンテンツチームに引き継ぎやすくなります。 ### 任意のURLを監査できますか？ はい、表示されるページコンテンツと公開されているSEOシグナルに基づいて、公開URLを監査できます。ソースコード、GSCデータ、アナリティクスデータ、クロールログ、パフォーマンスデータが利用できない場合、レポートはそれらの制限を明確に示す必要があります。 ### 通常のSEOチェックリストとどう違いますか？ 通常のSEOチェックリストはレビューすべき項目を示します。このSEO監査エージェントスキルは、AIエージェントにチェックの実行、結果の解釈、証拠と修正内容を含む構造化レポートの生成を繰り返し行えるプロセスを提供します。 ### 代わりに完全なSEO監査を使用すべきなのはどのような場合ですか？ より深いテクニカル分析、サイト全体のクロール、Core Web Vitals、インデックスチェック、コンテンツ品質のレビュー、内部リンク構造、ログ分析、高度なランキング診断が必要な場合は、完全なSEO監査を使用してください。