閉じる

PythonのBeautifulSoupでCSSセレクタを使い属性を指定して要素を検索・抽出する方法を解説

Pythonを活用したデータ収集、いわゆるWebスクレイピングにおいて、目的の情報をいかに正確かつ効率的に抽出するかは非常に重要なテーマです。

数あるライブラリの中でもBeautifulSoupは直感的な操作が可能であり、多くのエンジニアに愛用されています。

特にCSSセレクタを利用した検索手法は、フロントエンド開発の知識をそのまま活かせるため、習得するメリットが極めて大きいです。

本記事では、BeautifulSoupのselectメソッドやselect_oneメソッドを使い、HTML要素の属性を条件に指定して要素を絞り込む具体的なテクニックを詳しく解説します。

BeautifulSoupにおけるCSSセレクタの基本

BeautifulSoupで要素を検索する際、従来はfindfind_allといったメソッドが主流でした。

しかし、近年のスクレイピングの実務では、CSSセレクタを用いた検索が推奨される場面が増えています

CSSセレクタを利用することで、複雑な階層構造を持つHTMLから特定の要素を一行で指定できるようになります。

BeautifulSoupでCSSセレクタを利用するには、主にselect()select_one()の2つのメソッドを使用します。

select()メソッドは、指定した条件に合致するすべての要素をリスト形式で返却します。

一方で、select_one()メソッドは、条件に一致する最初の要素だけを取得します。

これらのメソッドを使い分けることで、効率的なコーディングが可能になります。

属性を指定して要素を検索する基本構文

CSSセレクタの真骨頂は、IDやクラスだけでなく、任意の属性を指定して要素をフィルタリングできる点にあります。

属性を指定する際の基本書式は、[属性名="属性値"]という形式になります。

例えば、href属性を持つリンク要素を抽出したい場合は、a[href]のように記述します。

特定のURLを指しているリンクだけを取得したい場合は、a[href="https://example.com"]と指定します。

このように属性を直接指定することで、スクレイピングの精度を大幅に向上させることができます。

以下のコードは、基本的な属性指定の例を示しています。

Python
from bs4 import BeautifulSoup

html_doc = """
<html>
<body>
    <a href="https://example.com/page1" title="first_link">リンク1</a>
    <a href="https://example.com/page2" title="second_link">リンク2</a>
    <button type="submit" disabled>送信</button>
</body>
</html>
"""

soup = BeautifulSoup(html_doc, 'html.parser')

# title属性が "first_link" の要素を取得
element = soup.select_one('[title="first_link"]')
print(element.text)
実行結果
リンク1

さまざまな属性検索のパターン

実務におけるHTML構造は複雑であり、完全一致の属性検索だけでは対応できないケースが多々あります。

CSSセレクタでは、正規表現に近い柔軟な記法を用いて、属性値の部分一致検索を行うことができます。

これらの記法をマスターすることで、動的に生成されるIDやクラス名を持つ要素にも対応可能になります。

ここでは、代表的な5つの部分一致パターンを紹介します。

1. 前方一致検索 (^=)

属性値が特定の文字列で始まっている要素を検索するには、^=演算子を使用します。

例えば、https://news.example.comから始まる内部リンクのみを抽出したい場合に便利です。

a[href^="https://news"]と記述することで、関連するリンクを一括で取得できます。

2. 後方一致検索 ($=)

属性値が特定の文字列で終わっている要素を検索するには、$=演算子を使用します。

画像ファイルのパスから、特定の拡張子(.jpgや.pngなど)を持つ要素だけを絞り込む際に多用されます。

img[src$=".png"]のように指定することで、PNG形式の画像要素のみを対象にできます。

3. 部分一致検索 (*=)

属性値の中に特定の文字列が含まれているかどうかを基準にする場合は、*=演算子を使います。

特定のキーワードを含むクラス名や、URLの一部に特定の識別子が含まれている場合に非常に強力です。

これは、最も汎用性が高い検索手法の一つと言えるでしょう。

4. 単語一致検索 (~=)

スペースで区切られた属性値のリストの中で、特定の単語が含まれている要素を探す場合は~=を使います。

複数のクラスが指定されている要素において、特定のクラスが含まれているかを確認する際に役立ちます。

5. ハイフン区切り一致検索 (|=)

属性値が指定した文字列そのものであるか、あるいはその文字列の直後にハイフンが続く場合に一致します。

主に言語指定のlang属性(例:ja, ja-JP)を検索する際などに利用されます。

演算子意味記述例
=完全一致[target="_blank"]
^=前方一致(~で始まる)[href^="https"]
$=後方一致(~で終わる)[src$=".jpg"]
*=部分一致(~を含む)[class*="item-"]
~=単語一致(スペース区切り)[class~="active"]

複数の属性を組み合わせて精度を高める

一つの属性指定だけでは、目的の要素を絞り込みきれないことがよくあります。

そのような場合、複数の属性セレクタを連結して記述することで、論理積(AND条件)として機能させることができます

例えば、target="_blank"であり、かつrel="noopener"を持つリンクを指定する場合は、a[target="_blank"][rel="noopener"]と記述します。

さらに、タグ名やクラス名と組み合わせることも可能です。

div.product-card[data-id="12345"]のように指定すれば、特定のIDを持つ商品カード要素をピンポイントで取得できます。

このように条件を重ねることで、不要なデータを排除し、スクレイピングの堅牢性を高めることが可能です。

Python
# 複数の属性を組み合わせた検索の例
# classに "link" を含み、かつ href が "https" で始まるaタグをすべて取得
links = soup.select('a.link[href^="https"]')

for link in links:
    print(link.get('href'))

独自属性(data-*属性)の取得と活用

現代のWebサイトでは、HTML5の「data-*属性(カスタムデータ属性)」に重要な情報が格納されているケースが増えています。

例えば、商品価格、在庫状況、ユーザーIDなどが、目に見えない属性値として埋め込まれていることがあります。

BeautifulSoupのCSSセレクタを使えば、これらの独自属性も簡単に検索対象に含めることができます。

[data-product-id]のように指定すれば、その属性を持つすべての要素を抽出できます。

属性の値自体を取得するには、BeautifulSoupの辞書形式のアクセス、あるいはget()メソッドを使用します。

この手法を活用することで、レンダリング後のJavaScriptが扱うデータソースを直接抜き出すような高度なスクレイピングが可能になります。

Python
html_data = """
<div class="item" data-category="books" data-price="2500">Python入門</div>
<div class="item" data-category="electronics" data-price="50000">スマートフォン</div>
"""
soup_data = BeautifulSoup(html_data, 'html.parser')

# data-category が "books" の要素を検索
book_item = soup_data.select_one('[data-category="books"]')

# 属性値の取得
price = book_item['data-price']
print(f"商品名: {book_item.text}, 価格: {price}円")
実行結果
商品名: Python入門, 価格: 2500円

疑似クラスと属性検索の併用

CSSセレクタの強力な機能の一つに「疑似クラス」があります。

属性検索と疑似クラスを組み合わせることで、さらに柔軟な抽出条件を設定できます。

例えば、特定の属性を持つ要素の中で「最初の一つ」や「最後の一つ」を指定したい場合に有効です。

p[data-type="desc"]:first-of-typeといった記述により、特定のデータタイプを持つ最初の段落要素を取得できます。

また、:not()疑似クラスを使用すれば、特定の属性を持たない要素を除外して検索することも可能です。

a[href]:not([href^="#"])というセレクタは、ページ内リンク(アンカー)を除いた外部リンクや内部リンクのみを抽出する際に非常に役立ちます。

このように、否定条件を組み合わせることで、抽出ロジックをよりシンプルに保つことができます。

実践的なスクレイピングでの応用例

ここでは、より実務に近いシナリオを想定したコード例を紹介します。

ニュースサイトの記事一覧から、特定のカテゴリに属し、かつ特定の条件を満たす記事タイトルとURLを抽出するケースを考えます。

CSSセレクタを活用することで、多重ループや複雑なif文を記述することなく、スマートにデータを整理できます。

Python
import requests
from bs4 import BeautifulSoup

# 仮のニュースサイトURL
url = "https://example.com/news"
# 実際には requests.get(url) で取得しますが、ここではサンプルHTMLを使用します
sample_html = """
<div id="news-list">
    <article class="post featured" data-topic="tech">
        <h2><a href="/articles/tech-001">最新のAI技術について</a></h2>
    </article>
    <article class="post" data-topic="science">
        <h2><a href="/articles/sci-002">宇宙探査の新計画</a></h2>
    </article>
    <article class="post" data-topic="tech">
        <h2><a href="/articles/tech-003">Python 2026年の動向</a></h2>
    </article>
</div>
"""

soup = BeautifulSoup(sample_html, 'html.parser')

# data-topicが "tech" である記事のリンクのみを抽出
tech_links = soup.select('article[data-topic="tech"] h2 a')

for link in tech_links:
    title = link.text
    href = link.get('href')
    print(f"Title: {title}, URL: {href}")
実行結果
Title: 最新のAI技術について, URL: /articles/tech-001
Title: Python 2026年の動向, URL: /articles/tech-003

この例では、親要素の属性(data-topic)を確認した上で、その子要素であるリンクを効率的に取得しています。

階層構造と属性条件を一度に指定できるのが、CSSセレクタの最大の魅力です。

属性検索を行う際の注意点とベストプラクティス

非常に便利な属性検索ですが、使用する際にはいくつか注意すべき点があります。

第一に、Webサイトの構造変更に対する脆弱性です。

属性値(特にクラス名やカスタム属性)は、サイトのアップデートによって頻繁に変更される可能性があります。

そのため、可能な限り変更されにくい安定した属性(IDや役割を示すデータ属性など)を選択することが重要です。

第二に、CSSセレクタの複雑化を避けることです。

あまりにも長すぎるセレクタは、後からコードを読み返す際に理解を妨げる原因となります。

適宜、select_oneで親要素を取得した後に、再度その要素に対して検索をかけるといった分割記述も検討してください。

また、スクレイピングを行う際は、相手サーバーに負荷をかけないよう適切なスリープ処理を入れることも忘れてはなりません。

robots.txtを確認し、利用規約を遵守することもプロのエンジニアとして必須のマナーです。

まとめ

PythonのBeautifulSoupにおいて、CSSセレクタを用いた属性検索は、スクレイピングの効率を劇的に高める武器となります。

[属性名="値"]という基本から、前方一致や後方一致といった応用的な記法まで、状況に応じて使い分けることが重要です。

特にdata-*属性の活用や、複数の属性を組み合わせたフィルタリングは、現代的なWebサイトから正確な情報を抜き出すために欠かせない技術です。

CSSセレクタのルールを深く理解することで、メンテナンス性が高く、かつ簡潔なスクレイピングコードを記述できるようになります。

今回紹介したテクニックを駆使して、ぜひ日々のデータ収集業務やプロジェクトの自動化に役立ててください。

正しい知識に基づいたスクレイピングは、あなたのデータ分析の幅を大きく広げてくれるはずです。

URLをコピーしました!