Communitygithub.com

個人サイト:名前検索で見つかるための SEO

静的ポートフォリオと個人サイト向けの軽量な Claude Code SEO スキル。meta タグ、Open Graph、Twitter カード、JSON-LD、robots.txt、sitemap、画像、見出し、リンクを 9 項目で監査し、修正をすべて HTML に書き込みます。

個人サイト:名前検索で見つかるための SEO とは?

「個人サイト」レシピのステップ 3(見つけてもらう)、出典は aevans-eng/seo-skill。/seo と打つか、「自分の名前で検索してもサイトが出ないのはなぜ?」と聞くだけ。エージェントは GitHub Pages、Netlify、Vercel 上の HTML を読み、9 項目の監査を行います:title・description・canonical、Open Graph と Twitter Card、トップの Person / WebSite JSON-LD とプロジェクトページの CreativeWork、robots.txt と sitemap.xml、画像の alt・遅延読み込み・サイズ、ページごとの H1・見出し階層・内部リンク、HTTPS とリンク切れ、公開後の Search Console 手順。合否表を出し、すべての追加を提案し、共有カードにはサイト内の既存画像を再利用します。ビルドツールも API 呼び出しも不要です。

対応✓Claude Code~Codex CLI~Cursor
npx skills add aevans-eng/seo-skill

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

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

ドキュメント

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. デプロイ後の確認

デプロイ後:

  1. /robots.txtと/sitemap.xmlに直接アクセスして参照可能か確認する
  2. Discord/Slack/Twitterでリンクを共有し、プレビューカードをチェックしてOGタグをテストする
  3. Google Search Consoleにサイトマップを送信する
  4. 数日後にsite:yourdomain.comを検索してインデックスを確認する
  5. 目的のクエリを検索し、順位の推移を追跡する

9. Google Search Consoleの設定

  1. Google Search Consoleにアクセスし、ドメイン用のプロパティを追加
  2. DNSのTXTレコードまたはHTMLファイル方式で確認
  3. サイトマップURLを送信
  4. [カバレッジ]レポートでインデックス状況を監視

簡単な監査結果出力

監査を実行する際、すべてのHTMLファイルを読み取り、以下の表を出力します。

チェック項目ステータス備考
Meta descriptions......
OGタグ......
JSON-LDスキーマ......
robots.txt......
sitemap.xml......
画像altテキスト......
H1タグ......
内部リンク......
canonical URL......

その後、不足しているものを修正する提案をします。

関連スキル