SEOスキル — 静的サイト最適化
静的HTMLサイト(GitHub Pages、Netlify、Vercelなど)向けの軽量SEO監査・修正ツールです。ビルドツールは不要。HTMLを読み取り、不足しているものを報告し、追加します。
セットアップ
初回使用前に、Claudeにサイトの情報を伝えて正しい値を設定できるようにしてください。
- ドメイン(例:
https://yourname.com) - ページ(例:index, about, resume, projects/foo)
- ソーシャルプロフィール(LinkedIn、GitHub、Twitterなど)
- 検索上位に表示させたいキーワード(例:「山田太郎 ソフトウェアエンジニア」「山田太郎 ポートフォリオ」)
Claudeはこのコンテキストをセッション中保持します。一度伝えるだけで大丈夫です。
呼び出されたときの手順
サイトのソースディレクトリにあるすべてのHTMLファイルを読み取ります。以下の各項目をチェックし、パス/フェイルの表を報告した後、不足しているものを修正する提案をします。
1. 各ページの<head>必須要素
すべてのHTMLページの<head>内に以下が必要です。
<title>[ページタイトル] — [あなたの名前]</title>
<meta name="description" content="[一意の内容、150〜160文字、目標キーワードを含む]">
<link rel="canonical" href="https://yourdomain.com/[パス]/">
<!-- Open Graph -->
<meta property="og:title" content="[タイトルと同じか短く]">
<meta property="og:description" content="[meta descriptionと同じ]">
<meta property="og:image" content="https://yourdomain.com/[画像パス]">
<meta property="og:image:width" content="1200">
<meta property="og:image:height" content="630">
<meta property="og:url" content="https://yourdomain.com/[パス]/">
<meta property="og:type" content="website">
<meta property="og:site_name" content="[あなたの名前]">
<!-- Twitter Card -->
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="[og:titleと同じ]">
<meta name="twitter:description" content="[og:descriptionと同じ]">
<meta name="twitter:image" content="https://yourdomain.com/[画像パス]">
ガイドライン:
- タイトル: 50〜60文字。名前 + 差別化要素。
- Meta description: 150〜160文字、ページごとに一意、名前 + 関連キーワードを含める。
- OG画像: 1200x630px推奨。ページごとに専用画像がない場合は共有画像を使用。プレースホルダーではなく、実際のサイト画像を使用する。
- canonical URL: 実際のデプロイURLと完全に一致させる(末尾スラッシュの有無を統一)。
2. 構造化データ(JSON-LD)
ホームページにPerson + WebSiteのスキーマを追加します。
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Person",
"name": "[あなたの名前]",
"url": "https://yourdomain.com",
"jobTitle": "[あなたの役職/肩書き]",
"affiliation": {
"@type": "Organization",
"name": "[学校または会社名]"
},
"sameAs": [
"[GitHub URL]",
"[LinkedIn URL]"
],
"knowsAbout": ["[スキル1]", "[スキル2]", "[スキル3]"]
}
</script>
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "WebSite",
"name": "[あなたの名前] — [ポートフォリオのキャッチコピー]",
"url": "https://yourdomain.com"
}
</script>
プロジェクトページにはCreativeWorkを使用します。
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "CreativeWork",
"name": "[プロジェクト名]",
"author": { "@type": "Person", "name": "[あなたの名前]" },
"description": "[プロジェクトの簡単な説明]",
"url": "https://yourdomain.com/[プロジェクト]/"
}
</script>
ルール: JSON-LDのみ(Microdata/RDFaは不可)。FAQPageは使用不可(政府/医療機関に制限)。HowToは非推奨。スキーマフィールドにプレースホルダーテキストを使用しない。
3. robots.txt
サイトルートに作成します。
User-agent: *
Allow: /
Sitemap: https://yourdomain.com/sitemap.xml
4. sitemap.xml
サイトルートに作成します。
<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
<url>
<loc>https://yourdomain.com/</loc>
<lastmod>[YYYY-MM-DD]</lastmod>
<priority>1.0</priority>
</url>
<!-- 各ページ分繰り返し -->
</urlset>
lastmodは実際の最終編集日を設定します。ページが変更されたらサイトマップを更新します。
5. 画像SEO
- すべての
<img>タグに説明的なaltテキストが必要(「image1」や「screenshot」は不可) - 可能な限りWebPを使用し、画像は200KB未満に保つ
- スクロールしないと見えない画像には
loading="lazy"を追加する - OG画像は実際のファイルであること(プレースホルダーは不可)
6. コンテンツとキーワードシグナル
- H1タグ: ページごとに1つ、名前またはプロジェクト名とキーワードを含める
- 見出し階層: h1 > h2 > h3、レベルを飛ばさない
- 本文中の名前: すべてのページに自然な形で名前を含める
- 内部リンク: ページ同士がリンクし合っていること(トップページ→プロジェクト、About→プロジェクトなど)
- 外部リンク: About/トップページからSNSプロフィールへのリンク
7. 技術チェック
- HTTPS: すべての内部リンクとリソースが
https://を使用しているか確認 - 末尾スラッシュの統一: すべてのリンク、canonical、サイトマップで同じパターンを採用する
- リンク切れなし: すべての
hrefとsrc属性が解決可能かチェック - モバイルレスポンシブ: すべてのページにビューポートメタタグが存在するか
- ページ速度: 重要でないスクリプトは遅延読み込み。JS最小限=静的サイトの良いベースライン
8. デプロイ後の確認
デプロイ後:
/robots.txtと/sitemap.xmlに直接アクセスして参照可能か確認する- Discord/Slack/Twitterでリンクを共有し、プレビューカードをチェックしてOGタグをテストする
- Google Search Consoleにサイトマップを送信する
- 数日後に
site:yourdomain.comを検索してインデックスを確認する - 目的のクエリを検索し、順位の推移を追跡する
9. Google Search Consoleの設定
- Google Search Consoleにアクセスし、ドメイン用のプロパティを追加
- DNSのTXTレコードまたはHTMLファイル方式で確認
- サイトマップURLを送信
- [カバレッジ]レポートでインデックス状況を監視
簡単な監査結果出力
監査を実行する際、すべてのHTMLファイルを読み取り、以下の表を出力します。
| チェック項目 | ステータス | 備考 |
|---|---|---|
| Meta descriptions | ... | ... |
| OGタグ | ... | ... |
| JSON-LDスキーマ | ... | ... |
| robots.txt | ... | ... |
| sitemap.xml | ... | ... |
| 画像altテキスト | ... | ... |
| H1タグ | ... | ... |
| 内部リンク | ... | ... |
| canonical URL | ... | ... |
その後、不足しているものを修正する提案をします。