Communitygithub.com

Blaise1030/astro-marketing

検索エンジンの可視性とランキングを最適化します。「SEOの改善」「検索最適化」「メタタグ修正」「構造化データ追加」「サイトマップ最適化」「検索エンジン最適化」といったリクエストに使用します。

astro-marketing とは?

このスキルは、Lighthouse SEO監査とGoogle検索ガイドラインに基づいた包括的なSEO最適化を提供します。技術的なクローラビリティ、オンページ最適化、構造化データ、国際SEO、モバイルSEO、そしてAIエージェント向けのディスカバラビリティまでカバーします。実際のレンダリングページが利用可能な場合は、Lighthouse監査を実行し、robots.txt、サイトマップ、レスポンスヘッダー、正準URLなどのシグナルを直接検査することで、証拠に基づいた改善ワークフローを実現します。また、`llms.txt`やWebMCPツールなど、AIエージェントと検索エンジンの両方にとってメリットがある概念を明確に区別し、検索ランキングを約束するのではなく、検証可能な技術的改善に焦点を当てます。このスキルは、Claude Code、Cursor、CodexなどのAIエージェントプラットフォームで利用可能であり、開発者がSEOのベストプラクティスをコードベースに直接適用し、監査と修正を繰り返す反復的なワークフローを促進します。

対応✓Claude Code✓Codex CLI~Cursor✓Antigravity✓Gemini CLI
npx skills add https://github.com/Blaise1030/astro-marketing/tree/HEAD/.agents/skills/seo

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

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

プレビュー

スキル README より

astro-marketing preview
astro-marketing preview
astro-marketing preview
astro-marketing preview

ドキュメント

SEO最適化

Lighthouse SEO監査とGoogle検索ガイドラインに基づく検索エンジン最適化。技術SEO、オンページ最適化、構造化データに焦点を当てます。

証拠に基づく監査ワークフロー

レンダリングされたページが利用可能な場合:

  1. その機能が利用可能な場合は、Lighthouse SEO監査とAgentic Browsingチェックを実行します。Chrome DevTools MCPではlighthouse_auditを使用します。結果を使用して、レンダリングページの失敗箇所を特定します。
  2. Lighthouse単独では確認できないシグナルを検査します: レスポンスヘッダー、リダイレクト、robots.txt、サイトマップのカバレッジ、ページテンプレート間の正準URLの一貫性、構造化データの適合性、そしてユーザーがアクセスを提供した場合のSearch Consoleの証拠。
  3. 技術的なクロール/インデックスに関する発見と、コンテンツの品質/権威性を分離します。ランキング要素の重みを独自に決めたり、ランキングの変更を約束したりしてはいけません。
  4. ソースを修正し、同じチェックを再実行します。インデックスやランキングの結果については、検索エンジンによる検証が保留中であることを報告します。

ライブツールが利用できない場合は、カテゴリ別のLighthouse CLI出力と、直接のソースおよびHTTP検査を使用します。Lighthouse SEOスコアは、技術的チェックの有用なサブセットをカバーしますが、ランキングの予測ではありません。

領域このスキルが検証できること
クロールとインデックス制御技術設定と一貫性
レンダリングされたメタデータとセマンティクス存在、有効性、およびページテンプレートの問題
構造化データ構文と適合性のシグナル(リッチ結果は保証されません)
Core Web VitalsCore Web Vitalsスキルからの測定されたフィールド/ラボの証拠へのリンク
コンテンツの有用性と権威性品質のレビュー(合成されたランキングパーセンテージは割り当てない)

技術SEO

クローラビリティ

robots.txt:

# /robots.txt
User-agent: *
Allow: /

# 管理/プライベート領域をブロック
Disallow: /admin/
Disallow: /api/
Disallow: /private/

# レンダリングに必要なリソースはブロックしない
# ❌ Disallow: /static/

Sitemap: https://example.com/sitemap.xml

Meta robots:

<!-- デフォルト: インデックス可能、フォロー可能 -->
<meta name="robots" content="index, follow">

<!-- 特定ページをNoindex -->
<meta name="robots" content="noindex, nofollow">

<!-- インデックス可能だがリンクはフォローしない -->
<meta name="robots" content="index, nofollow">

<!-- スニペットの制御 -->
<meta name="robots" content="max-snippet:150, max-image-preview:large">

正準URL:

<!-- 重複コンテンツの問題を防ぐ -->
<link rel="canonical" href="https://example.com/page">

<!-- 自己参照型の正準URL(推奨) -->
<link rel="canonical" href="https://example.com/current-page">

<!-- ページネーションコンテンツの場合 -->
<link rel="canonical" href="https://example.com/products">
<!-- または、明示的なページネーションのために rel="prev" / rel="next" を使用 -->

XMLサイトマップ

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
  <url>
    <loc>https://example.com/</loc>
    <lastmod>2024-01-15</lastmod>
    <changefreq>daily</changefreq>
    <priority>1.0</priority>
  </url>
  <url>
    <loc>https://example.com/products</loc>
    <lastmod>2024-01-14</lastmod>
    <changefreq>weekly</changefreq>
    <priority>0.8</priority>
  </url>
</urlset>

サイトマップのベストプラクティス:

  • サイトマップあたり最大50,000 URLまたは50MB
  • 大規模サイトにはサイトマップインデックスを使用
  • 正準URLでインデックス可能なURLのみを含める
  • コンテンツが変更されたらlastmodを更新
  • Google Search Consoleに送信

URL構造

✅ 良いURL:
https://example.com/products/blue-widget
https://example.com/blog/how-to-use-widgets

❌ 悪いURL:
https://example.com/p?id=12345
https://example.com/products/item/category/subcategory/blue-widget-2024-sale-discount

URLガイドライン:

  • ハイフンを使用し、アンダースコアは使用しない
  • 小文字のみ
  • 短く保つ(75文字未満)
  • ターゲットキーワードを自然に含める
  • 可能な限りパラメータを避ける
  • 常にHTTPSを使用

HTTPSとセキュリティ

<!-- すべてのリソースがHTTPSを使用していることを確認 -->
<img src="https://example.com/image.jpg">

<!-- 使用しない: -->
<img src="http://example.com/image.jpg">

SEO信頼シグナルのためのセキュリティヘッダー:

Strict-Transport-Security: max-age=31536000; includeSubDomains
X-Content-Type-Options: nosniff
X-Frame-Options: DENY

オンページSEO

タイトルタグ

<!-- ❌ 欠落または一般的 -->
<title>Page</title>
<title>Home</title>

<!-- ✅ プライマリキーワードを含む説明的なもの -->
<title>Blue Widgets for Sale | Premium Quality | Example Store</title>

タイトルタグのガイドライン:

  • 50~60文字は、合格/不合格の制限ではなく、大まかなリントのプロキシとしてのみ使用します。Googleはタイトルリンクをレンダリングされたデバイス幅に合わせて切り詰めるため、ツールがサポートする場合はプレビュー幅を確認します。
  • ページのトピックを自然に、先頭近くに説明する
  • すべてのページで一意にする
  • ブランドが結果の識別に役立つ場合は追加する
  • 適切な場合はアクション指向にする

タイトルリンクの書き換えは、切り詰めとは別に扱います。Googleは<title>が短い場合でも、表示されているページタイトル、見出し、アンカーテキスト、その他のソースから異なるタイトルリンクを構築することがあります。自動的に短縮するのではなく、正確性と一貫性を調査します。Googleのタイトルリンクガイダンスを参照してください。

メタディスクリプション

<!-- ❌ 欠落または重複 -->
<meta name="description" content="">

<!-- ✅ 魅力的で一意 -->
<meta name="description" content="送料無料のプレミアムブルーウィジェットを購入。30日間返品保証。10,000人以上の顧客から評価4.9/5。今すぐ注文して20%割引。">

メタディスクリプションのガイドライン:

  • 約150~160文字は、リントのプロキシとしてのみ使用します。スニペットはクエリとデバイスに依存し、Googleはメタディスクリプションの代わりにページコンテンツを選択することがあります。
  • ページのトピックを自然に使用する
  • 魅力的なコールトゥアクション
  • すべてのページで一意にする
  • ページコンテンツと一致している

見出し構造

<!-- ❌ 構造が悪い -->
<h2>Welcome to Our Store</h2>
<h4>Products</h4>
<h1>Contact Us</h1>

<!-- ✅ 適切な階層 -->
<h1>Blue Widgets - Premium Quality</h1>
  <h2>Product Features</h2>
    <h3>Durability</h3>
    <h3>Design</h3>
  <h2>Customer Reviews</h2>
  <h2>Pricing</h2>

見出しガイドライン:

  • ページの主要見出しを説明的にし、階層を明確にする。有効なHTMLに複数の<h1>が含まれていても、それだけでページを不合格にしない。
  • 論理的な階層(レベルをスキップしない)
  • キーワードを自然に含める
  • 説明的で、一般的ではない

画像SEO

<!-- ❌ 画像SEOが悪い -->
<img src="IMG_12345.jpg">

<!-- ✅ 最適化された画像 -->
<img src="blue-widget-product-photo.webp"
     alt="クローム仕上げのブルーウィジェット、コントロールパネルを示す側面図"
     width="800"
     height="600"
     loading="lazy">

画像ガイドライン:

  • キーワードを含む説明的なファイル名
  • 代替テキストは画像の内容を説明
  • 圧縮され、適切なサイズであること
  • WebP/AVIFとフォールバック
  • スクロールしないと見えない画像は遅延読み込み

内部リンク

<!-- ❌ 非説明的 -->
<a href="/products">Click here</a>
<a href="/widgets">Read more</a>

<!-- ✅ 説明的なアンカーテキスト -->
<a href="/products/blue-widgets">Browse our blue widget collection</a>
<a href="/guides/widget-maintenance">Learn how to maintain your widgets</a>

リンクガイドライン:

  • キーワードを含む説明的なアンカーテキスト
  • 関連する内部ページにリンク
  • ページあたり適切な数のリンク
  • 壊れたリンクは迅速に修正
  • パンくずリストで階層を示す

構造化データ (JSON-LD)

ユーザーがスキーママークアップをリクエストした場合、または監査で構造化データの問題が明らかになった場合は、構造化データリファレンスを参照してください。Organization、Article、Product、FAQ、Breadcrumbの例とバリデーションリンクが含まれています。

  • 表示されている正確なコンテンツを記述すること。 リッチ結果を得るためだけにタイプや主張を追加しないでください。
  • 最も具体的な該当タイプを使用すること。 識別子と絶対URLはレンダリング間で安定させてください。
  • レンダリングされた出力を検証すること。 構文が正しくても、検索エンジンでの適合性や表示は保証されません。

Agentic BrowsingとAIディスカバラビリティ

これらの概念は区別してください:

  • Lighthouse Agentic Browsing は、アシスタントがレンダリングされたページを理解し操作するのに役立つ技術的シグナルを測定します。現在のチェックには、エージェント向けアクセシビリティツリー、オプションのllms.txt、および存在する場合のWebMCP登録、スキーマ、フォームカバレッジが含まれます。
  • 検索インデックスとランキング は検索エンジンのシステムに依存しており、Agentic Browsingスコアから推測することはできません。
  • AIによる取り込みまたは引用 は製品固有です。技術的にブラウズ可能なページや有効なllms.txtファイルがあっても、AI製品がそれを取り込み、ランク付けし、引用するとは限りません。

セマンティックHTML、説明的なラベル、クロール可能なコンテンツ、正確なメタデータ、明確なページ構造を優先してください。これらは人、検索エンジン、エージェントすべてに利益をもたらします。アプリケーションが公開すべき有用なアクションを持ち、ユーザーがその統合を望む場合にのみ、WebMCPツールを追加してください。ツール名、説明、スキーマ、フォームアノテーションをLighthouseで検証してください。

クローラー制御は製品固有

包括的な「AIボット」ルールを適用する代わりに、文書化された各ユーザーエージェントを個別に監査してください:

制御文書化された目的ブロックの影響
OAI-SearchBotChatGPT検索のディスカバリページコンテンツがChatGPTの要約やスニペットに含まれるのを防ぎます。リンクとタイトルはサードパーティのディスカバリを通じて表示される可能性があります
PerplexityBotPerplexity検索インデックスそのクローラーがブロックされたコンテンツを検索結果用にインデックスするのを防ぎます
Claude-SearchBot / Claude-UserClaude検索インデックス / ユーザー指示による取得検索の可視性を低下させる / ユーザー指示によるリクエストの取得を防ぐ可能性があります
Google-ExtendedGoogleがクロールするコンテンツの特定のGeminiトレーニングおよびグラウンディング使用を制御Google検索の包含やランキングには影響しません

GPTBotやClaudeBotなどのトレーニング制御は、検索およびユーザーフェッチ制御とは異なります。GoogleOtherは汎用クローラーであり、AI検索の可視性スイッチではありません。現在の名前と影響については、ベンダーの保守文書で確認してください: OpenAI, Perplexity, Anthropic, Google。

llms.txt はオプション

llms.txtは実験的な提案であり、クロスベンダーのディスカバリ標準ではありません。Lighthouseは/llms.txtの可用性と形式を検証できますが、それはターゲット製品がそれを読み取ることを示すものではありません。ユーザーがリクエストした場合、または文書化されたコンシューマーがそれをサポートしている場合にのみ追加してください。クロール可能性、セマンティックHTML、正確なメタデータ、有用なコンテンツよりも優先して推奨したり、この監査を上げるためだけにサイトマップを複製したり、コンテンツを再編成したりしないでください。決してランキングや引用の要素として扱ったり、サイトマップを複製したり、この監査を上げるためだけにコンテンツを再編成したりしないでください。


モバイルSEO

レスポンシブデザイン

<!-- ❌ モバイルフレンドリーではない -->
<meta name="viewport" content="width=1024">

<!-- ✅ レスポンシブビューポート -->
<meta name="viewport" content="width=device-width, initial-scale=1">

タップターゲット

/* ❌ モバイルには小さすぎる */
.small-link {
  padding: 4px;
  font-size: 12px;
}

/* ✅ 適切なタップターゲット */
.mobile-friendly-link {
  padding: 12px;
  font-size: 16px;
  min-height: 48px;
  min-width: 48px;
}

フォントサイズ

/* ❌ モバイルで小さすぎる */
body {
  font-size: 10px;
}

/* ✅ ズームせずに読める */
body {
  font-size: 16px;
  line-height: 1.5;
}

国際SEO

Hreflangタグ

<!-- 多言語サイトの場合 -->
<link rel="alternate" hreflang="en" href="https://example.com/page">
<link rel="alternate" hreflang="es" href="https://example.com/es/page">
<link rel="alternate" hreflang="fr" href="https://example.com/fr/page">
<link rel="alternate" hreflang="x-default" href="https://example.com/page">

言語宣言

<html lang="en">
<!-- または -->
<html lang="es-MX">

SEO監査チェックリスト

クリティカル

  • HTTPSが有効になっている
  • robots.txtでクロールが許可されている
  • 重要なページにnoindexがない
  • タイトルタグが存在し、一意である
  • ページの主要見出しが説明的で、階層が論理的である

高優先度

  • メタディスクリプションが存在する
  • サイトマップが送信されている
  • 正準URLが設定されている
  • モバイルレスポンシブである
  • Core Web Vitalsが合格している

中優先度

  • 構造化データが実装されている
  • 内部リンク戦略
  • 画像の代替テキスト
  • 説明的なURL
  • パンくずリストナビゲーション
  • エージェントアクセスが重要な場合、Agentic Browsingの失敗をレビューした

継続的

  • Search Consoleのクロールエラーを修正
  • コンテンツが変更されたらサイトマップを更新
  • ランキングの変化を監視
  • 壊れたリンクをチェック
  • Search Consoleのインサイトを確認

ツール

ツール使用目的
Google Search Consoleインデックスを監視し、問題を修正
Google PageSpeed Insightsパフォーマンス + Core Web Vitals
Rich Results Test構造化データを検証
Live Lighthouse監査 (Chrome DevTools MCP: lighthouse_audit)レンダリングされたSEOとエージェント向けAgentic Browsingチェック
Lighthouse CLISEO監査のフォールバック
Screaming Frogクロール分析

リファレンス

Individual skills in this repo

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

関連スキル