BeautifulSoupのfindで複数条件を辞書形式で指定する方法：attrs引数の活用と実践解説

2026年5月15日

要素取得

Pythonでウェブスクレイピングを行う際、HTMLの中から特定の要素を正確に抽出する技術は非常に重要です。

多くの開発者が利用しているBeautifulSoupライブラリでは、タグの検索を行うためにfindメソッドやfind_allメソッドが用意されています。

しかし、単純なタグ名やIDの指定だけでは、複雑なウェブサイトの構造から目的のデータを取り出すのが難しい場面も少なくありません。

そこで活用したいのが、複数の検索条件を辞書形式でまとめて指定する手法です。

この記事では、BeautifulSoupのfindメソッドでattrs引数を利用し、柔軟に複数条件を指定する方法を詳しく解説します。

目次 [ close ]

BeautifulSoupのfindメソッドにおける検索の基本

BeautifulSoupのfindメソッドは、指定した条件に一致する最初の要素を1つだけ返します。

基本的には、第一引数に「div」や「p」といったタグ名を指定することで、そのタグを検索対象とします。

しかし、現代のウェブサイトでは同じタグが数多く存在するため、タグ名だけでは不十分です。

そこで、idやclassなどの属性を組み合わせて条件を絞り込む必要が出てきます。

通常、キーワード引数を使って検索することも可能ですが、特定の状況下では辞書形式（attrs引数）での指定が最も汎用的で推奨される手法となります。

辞書形式（attrs引数）を使った複数条件の指定方法

BeautifulSoupのfindメソッドには、attrsという引数が存在します。

この引数にPythonの辞書オブジェクトを渡すことで、複数の属性条件を一括で定義できます。

基本的な文法と実装例

attrs引数に「属性名」をキーとし、「属性値」を値とした辞書を渡します。

以下のサンプルコードでは、IDとクラス名を同時に指定して要素を抽出しています。

Python

from bs4 import BeautifulSoup

# サンプルHTML
html_doc = """
<div>
    <p id="main-text" class="content highlight">ターゲットのテキストです。</p>
    <p id="sub-text" class="content">こちらは対象外です。</p>
</div>
"""

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

# 辞書形式で複数条件を指定
conditions = {
    'id': 'main-text',
    'class': 'content highlight'
}
target_element = soup.find('p', attrs=conditions)

print(target_element.text)

実行結果

ターゲットのテキストです。

このように、辞書を使うことで複数の条件を直感的に記述できることがわかります。

クラス名とIDを同時に指定するメリット

HTMLの構造が複雑な場合、クラス名だけでは他の要素と重複してしまうことがあります。

IDとクラス名を併用することで、要素の一意性を高め、誤ったデータを取得するリスクを大幅に軽減できます。

辞書形式であれば、条件を増やす際も辞書に新しい要素を追加するだけで済みます。

カスタム属性（data-属性）の指定

最近のウェブサイトでは、独自の「data-id」や「data-role」といったカスタムデータ属性が多用されています。

キーワード引数としてこれらの属性を指定しようとすると、Pythonの変数名ルールに抵触してエラーになる場合があります。

しかし、辞書形式であれば文字列としてキーを指定できるため、問題なく検索可能です。

Python

# カスタム属性を含むHTMLの検索
html_custom = '<div data-category="tech" data-status="active">技術記事</div>'
soup_custom = BeautifulSoup(html_custom, 'html.parser')

# ハイフンを含む属性も辞書なら簡単
custom_conditions = {
    'data-category': 'tech',
    'data-status': 'active'
}
element = soup_custom.find('div', attrs=custom_conditions)
print(element.text)

実行結果

技術記事

キーワード引数ではなく辞書を使うべき理由

BeautifulSoupでは find(id="xxx") のようなキーワード引数も使えますが、なぜ辞書形式が重要なのでしょうか。

そこには、Pythonの言語仕様に関連するいくつかの理由があります。

Pythonの予約語「class」の回避

Pythonにおいて「class」はクラスを定義するための予約語です。

そのため、find(class="my-class") と記述すると構文エラー（SyntaxError）が発生してしまいます。

BeautifulSoupでは回避策として class_ という引数名が用意されていますが、他の属性と書き方が異なり、混乱を招く原因になります。

辞書形式であれば {‘class’: ‘my-class’} とそのまま記述できるため、コードの一貫性が保たれます。

動的な条件生成の容易さ

スクレイピングのロジックを組む際、検索条件をプログラムで動的に生成したい場合があります。

辞書を使えば、プログラムの実行時に条件を追加したり削除したりすることが容易になります。

これは大規模なスクレイピングプロジェクトにおいて、コードの保守性を高めるために不可欠な要素です。

実践的なスクレイピングでの活用シーン

実際の開発現場で、この辞書による複数条件指定がどのように役立つかを見ていきましょう。

特定の条件を満たす商品情報の抽出

ECサイトなどで、特定のカテゴリに属し、かつ特定のステータスを持つ要素だけを抜き出す例を考えます。

Python

html_shop = """
<ul>
    <li class="item" data-type="book" data-instock="yes">Python入門書</li>
    <li class="item" data-type="book" data-instock="no">完売の技術書</li>
    <li class="item" data-type="gadget" data-instock="yes">スマートウォッチ</li>
</ul>
"""
soup_shop = BeautifulSoup(html_shop, 'html.parser')

# 在庫のある本だけを特定する
item_conditions = {
    'class': 'item',
    'data-type': 'book',
    'data-instock': 'yes'
}
book_item = soup_shop.find('li', attrs=item_conditions)
print(f"取得要素: {book_item.text}")

実行結果

取得要素: Python入門書

複雑な入れ子構造を持つテーブルの解析

テーブルタグ（table）の中で、特定の役割を持つ行（tr）やセル（td）を特定する際にも、複数属性の指定は威力を発揮します。

特に、見た目を整えるためのクラス名と、データを識別するためのIDが混在している場合に有効です。

正規表現と辞書を組み合わせた高度な検索

attrs引数の値には、固定の文字列だけでなく、正規表現オブジェクトを渡すことも可能です。

これにより、「特定の文字列から始まるID」かつ「特定のキーワードを含むクラス」といった、より高度な複数条件指定が可能になります。

Python

import re

html_re = """
<div id="post_123" class="entry-content free-article">自由記事の内容</div>
<div id="post_456" class="entry-content premium-article">有料記事の内容</div>
"""
soup_re = BeautifulSoup(html_re, 'html.parser')

# IDがpost_で始まり、クラスにfreeを含む要素を検索
re_conditions = {
    'id': re.compile(r'^post_'),
    'class': re.compile(r'free')
}
free_post = soup_re.find('div', attrs=re_conditions)
print(free_post.text)

実行結果

自由記事の内容

正規表現を辞書の各値に適用できる柔軟性は、BeautifulSoupが選ばれる大きな理由の一つです。

複数条件指定時の注意点とベストプラクティス

非常に便利な辞書形式での検索ですが、いくつか注意すべきポイントがあります。

属性の存在確認と値の一致

辞書で指定した条件は、基本的に「完全一致」が求められます（正規表現を使用しない場合）。

クラス名が複数設定されている要素（例：class=”btn btn-primary”）に対して、{'class': 'btn'} と指定しても、その要素はヒットしません。

この場合、クラスのリストとして指定するか、前述の正規表現を利用する必要があります。

パフォーマンスへの配慮

あまりにも多くの検索条件を辞書に詰め込みすぎると、解析速度に影響が出る場合があります。

数千行を超えるような大規模なHTMLを処理する際は、まずはタグ名やIDで大きく絞り込み、その後に詳細な属性チェックを行うといった二段階の処理も検討してください。

しかし、通常のウェブスクレイピングであれば、attrs引数による指定がボトルネックになることは稀です。

コードの可読性を保つ

辞書を定義する際は、変数名にその条件が何を意味するのかを明示的に付けると良いでしょう。

例えば search_criteria や target_attrs といった名前を付けることで、後からコードを読み返した際の内容理解がスムーズになります。

指定方法	メリット	デメリット
タグ名のみ	記述が最もシンプル	特定性が低く誤認しやすい
キーワード引数	直感的に記述可能	予約語やハイフンに弱い
辞書形式(attrs)	多機能で汎用性が高い	記述量がわずかに増える