【ITニュース解説】A One-File On-Page SEO Check You Can Run Before You Hit Publish

Webページをインターネットに公開する際、多くの人々に見てもらい、情報が正確に伝わるようにすることは、開発者にとって非常に重要な目標である。この目標を達成するために、「検索エンジン最適化」、略してSEOという考え方がある。SEOとは、Googleなどの検索エンジンの仕組みを理解し、自分のWebページが検索結果の上位に表示されやすくするための工夫のことだ。しかし、Webページの制作や編集作業は複雑で、特に作業の終盤や疲れている時には、基本的なSEOの項目をうっかり見落としてしまうことがよくある。

例えば、Webページの内容を簡潔にまとめた「メタディスクリプション」という説明文が抜けていたり、ページのタイトルを示す最も重要な見出しであるはずの「H1タグ」が複数存在していたり、画像が表示されない場合に代わりに表示されるテキストである「altテキスト」が設定されていない画像があったり、検索結果に表示されるタイトルが途中で途切れてしまったり、といったミスは非常に頻繁に起こりうる。これらのミスは、技術的には簡単に修正できるものばかりだが、一度見落としてしまうと、Webページのアクセス数に悪影響を及ぼす可能性がある。

このような基本的なSEOの問題を、Webページを公開する前に自動でチェックしてくれる便利なツールが紹介された。それが「seo-page-audit」というPython製のツールだ。このツールは、Web開発者向けの小さな便利機能（「Hermesスキル」と呼ばれる）の一つとして開発されたもので、特にシステムエンジニアを目指す初心者が、品質の高いWebページを作る手助けとなることを目的としている。

「seo-page-audit」の最大の特徴は、その手軽さにある。このツールはたった一つのPythonファイルで構成されており、Pythonの標準ライブラリ（Pythonをインストールしたときに最初から使える機能群）のみを使用している。そのため、特別なソフトウェアを新たにインストールしたり、外部のサービスと連携するための「APIキー」（認証用のパスワードのようなもの）を取得したりする必要がない。これは、開発環境の準備にかかる手間を大幅に削減し、すぐにチェック作業に取り掛かれるという大きなメリットがある。

このツールは、指定された単一のWebページのURL、または手元のコンピューターにあるHTMLファイルを読み込み、その内容を分析する。そして、WebページがSEOの基本的なルールに則っているかを確認し、問題点があればリストアップしてくれる。検出される問題には、重要度に応じて「高」「中」「低」の優先度がつけられるため、開発者はどの問題から優先的に対処すべきかを一目で判断できる。

具体的にどのような項目がチェックされるのか。まず、Webページの「タイトル」や「メタディスクリプション」が適切に設定されているか。これらは検索結果に表示されるため、非常に重要だ。次に、ページの主題を表す「H1タグ」が適切に一つだけ使われているか、そして見出しの階層構造（H1、H2、H3など）が論理的に正しいかを確認する。これは、検索エンジンがWebページの内容を理解しやすくするために欠かせない。

また、Webページが他のWebページと内容が重複している場合に、どのページがオリジナルであるかを検索エンジンに伝える「canonicalタグ」や、Webページの言語を指定する「lang属性」、スマートフォンのような様々な画面サイズに対応させるための「viewport設定」の有無もチェックされる。さらには、検索エンジンにインデックス登録（検索対象に含めること）されたくない場合に使う「noindex」タグの確認、SNSでWebページが共有されたときに表示される情報を設定する「Open Graphタグ」の有無、画像に設定された「altテキスト」の有無と画像のサイズ、テキストが設定されていないリンクの検出、そしておおよそのWebページの文字数まで、多岐にわたる項目を網羅的に監査してくれる。

特に重要なのは、もし「高」優先度の問題が検出された場合、ツールの実行が「1」という終了コードを返すように設計されている点だ。これは、開発の現場でよく使われる「CI/CDパイプライン」（継続的インテグレーション/継続的デリバリーと呼ばれる、コードの変更を自動でテストし、本番環境へデプロイする一連の自動化されたプロセス）に組み込む上で非常に便利だ。自動テストの一環としてこのツールを実行し、高優先度の問題があればビルドを停止させ、開発者が問題修正を忘れないように促すことができる。

ツールの使い方は非常にシンプルで、コマンドラインからPythonの実行ファイルとチェックしたいWebページのURLを引数として渡すだけだ。例えば、python3 scripts/seo_page_audit.py https://example.com/ と入力すれば、指定されたURLのWebページがすぐに監査される。実際に、とあるページに対してこのツールを実行したところ、メタディスクリプションとH1タグの欠落が「高」優先度の問題として、またcanonicalタグの欠落とコンテンツの少なさが「中」優先度の問題として報告された。これは、そのWebページが実際に抱えていた問題と完全に一致しているため、ツールの高い実用性を示している。

ただし、「seo-page-audit」にはいくつかの限界も存在する。このツールは、Webサーバーから提供されるHTMLファイルをそのまま読み込むため、JavaScriptによって動的に生成されるコンテンツ（Webページが読み込まれた後にJavaScriptが内容を書き換えるような部分）は監査の対象外となる。また、文字数やテキストの長さに関するしきい値はあくまで一般的な目安であり、厳密な基準ではない。そして、このツールは一度に一つのWebページのみを監査する設計であり、Webサイト全体をまとめてチェックするような機能は持っていない。

これらの限界があるため、このツールは「迅速な最初のチェック」、つまり「ファーストパス」として利用することが推奨されている。SEOに関する最終的な「判決」を下すものではなく、あくまでWebページ公開前の基本的な見落としを防ぐための、素早く実行できる補助ツールとして捉えるべきだ。

開発者は、このツールに搭載されている自己テスト機能「--selftest」を利用して、ツールの動作を確認することも可能だ。これはローカル環境でテスト用のWebサーバーを起動し、問題のあるページと問題のないページの両方をチェックすることで、ツールの信頼性を自分で確認できる便利な機能だ。

「seo-page-audit」はMITライセンスで提供されており、これは誰でも自由に利用、改変、再配布できるオープンソースソフトウェアであることを意味する。システムエンジニアを目指す皆さんにとって、このようなツールを使いこなすことは、Web開発の品質を高め、より良いユーザー体験を提供する上で非常に役立つだろう。Webページを公開する前にこのツールで基本的なチェックを行い、細かなミスを防ぐことで、より多くの人に情報が届く質の高いコンテンツを制作する手助けとなる。