Playwright PythonでWeb自動化！初心者でも簡単ステップ解説

※この記事にはアフィリエイトリンクを含みます（PR）

Webサイトの操作を自動化したい、データ収集を効率化したい、そんな風に思ったことはありませんか？

私自身、以前は手作業で繰り返しの多いタスクに時間を取られていました。そんな時、出会ったのが「Playwright」です。特にPythonとの組み合わせが強力で、Web自動化のハードルをぐっと下げてくれました。

この記事では、私が実際にPlaywright Pythonを使ってWeb自動化を始めた時の体験談を元に、初心者の方でも理解できるように、環境構築から基本的な使い方、そして少し応用的なテクニックまでを、具体的な手順を交えながら解説していきます。

Webスクレイピングやブラウザテストの自動化に興味がある方は、ぜひ最後まで読んでみてください。

Playwright Pythonとは？その魅力に迫る

Playwrightは、Microsoftが開発したNode.jsライブラリですが、Pythonをはじめとした様々な言語で利用できるのが特徴です。私自身、最初はNode.jsで使おうかと思いましたが、普段からPythonを使っていたため、Playwright Pythonの存在を知ってすぐに飛びつきました。Pythonで直感的にWebブラウザの操作を記述できるのは、本当にありがたいです。

Playwright Pythonの主な魅力は以下の通りです。

• 高速かつ信頼性の高い自動化: ブラウザとの通信が効率的で、安定した動作が期待できます。画像認識などの高度な機能も備わっています。
• クロスブラウザ対応: Chromium（Chrome, Edge）、Firefox、WebKit（Safari）といった主要なブラウザを横断してテストや自動化が可能です。これは、Webサイトがどのブラウザでも正しく表示・動作するかを確認する際に非常に役立ちます。
• 豊富な機能: 要素の待機（WAIT）処理が自動で行われたり、ネットワークリクエストのインターセプト（傍受）やモック（偽装）ができたりと、痒い所に手が届く機能が満載です。
• デバッグのしやすさ: ブラウザの操作を記録したり、スクリーンショットを撮ったりする機能が充実しているので、問題が発生した際の原因究明がしやすいです。

これらの特徴から、Playwright Pythonは、Webスクレイピング、Webアプリケーションのテスト自動化、定型的なWeb操作の自動化など、幅広い用途で活用されています。

Playwright Pythonの環境構築：これであなたも自動化マスター！

Playwright Pythonを始めるには、まず環境構築が必要です。これが意外と簡単なので、安心してください。私自身、環境構築でつまずいた経験はほとんどありません。

1. Pythonのインストール

もし、お使いのPCにPythonがインストールされていない場合は、公式サイトから最新版をダウンロードしてインストールしてください。バージョンは3.7以上が推奨されています。

2. Playwrightのインストール

Pythonのパッケージ管理ツールであるpipを使って、Playwrightをインストールします。ターミナル（コマンドプロンプトやPowerShellなど）を開き、以下のコマンドを実行してください。

pip install playwright

3. ブラウザドライバのインストール

Playwrightは、実際にブラウザを操作するために、各ブラウザ用のドライバ（実行ファイル）を必要とします。これもPlaywrightのコマンドで簡単にインストールできます。

playwright install

このコマンドを実行すると、Chromium, Firefox, WebKitの最新バージョンがダウンロードされ、Playwrightから利用できるようになります。もし特定のブラウザのみをインストールしたい場合は、playwright install chromium のように指定することも可能です。

これで、Playwright Pythonを使い始める準備が整いました！

Playwright Pythonの基本操作：Webサイトを操作してみよう！

環境構築が完了したら、いよいよPlaywright Pythonを使ってWebサイトを操作してみましょう。ここでは、実際に私がよく使う基本的な操作をいくつか紹介します。

1. ブラウザの起動とページへのアクセス

まずは、ブラウザを起動して特定のWebページにアクセスするコードから見ていきましょう。

from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    # Chromiumブラウザを起動
    browser = p.chromium.launch()
    # 新しいページ（タブ）を開く
    page = browser.new_page()
    # 指定したURLにアクセス
    page.goto("https://www.google.com/")
    # ページタイトルを表示
    print(page.title())
    # ブラウザを閉じる
    browser.close()

sync_playwright() というコンテキストマネージャーを使うことで、Playwrightのインスタンスを安全に管理できます。p.chromium.launch() でChromiumブラウザを起動し、browser.new_page() で新しいタブを開いています。page.goto() でURLにアクセスし、page.title() でページのタイトルを取得できます。

2. 要素の特定と操作

Web自動化の肝となるのが、Webページ上の特定の要素（ボタン、入力フィールド、テキストなど）を特定して操作することです。Playwrightでは、様々なセレクター（要素を指定するための記述方法）が用意されています。

• CSSセレクター: #id, .class, tag など、CSSで使われるセレクター。
• XPath: より複雑な要素の階層構造を指定できるセレクター。
• テキストセレクター: 要素に含まれるテキストで指定。

例えば、Googleの検索ボックスに入力して検索ボタンをクリックする例を見てみましょう。

from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch(headless=False) # headless=Falseでブラウザ表示
    page = browser.new_page()
    page.goto("https://www.google.com/")

    # 検索ボックス（name属性がq）にテキストを入力
    page.locator("input[name='q']").fill("Playwright Python")

    # 検索ボタン（Google検索）をクリック
    page.locator("text=Google検索").click()

    # 検索結果のタイトルを表示（例として最初の結果のタイトル）
    page.wait_for_selector("h3") # h3タグが表示されるまで待機
    print(page.locator("h3").first.text_content())

    browser.close()

page.locator(selector) で要素を指定し、fill() でテキストを入力、click() でクリック操作を行っています。page.wait_for_selector("h3") のように、要素が表示されるまで待機する処理は、Web自動化において非常に重要です。Playwrightは、多くの場面で自動的に待機処理を行ってくれますが、明示的に指定することも可能です。

headless=False を launch() メソッドに渡すと、実際のブラウザウィンドウが表示されるので、操作の様子を確認しながらデバッグするのに便利です。

3. データの取得（Webスクレイピング）

Webスクレイピングでは、Webページから必要な情報を抽出します。先ほどの例の続きで、検索結果からタイトルを取得してみましょう。

# 上記のコードの続き

    # 検索結果のタイトルをすべて取得
    titles = page.locator("h3").all_text_contents()
    for i, title in enumerate(titles):
        print(f"{i+1}: {title}")

    browser.close()

all_text_contents() を使うと、指定したセレクターにマッチするすべての要素のテキストコンテンツをリストとして取得できます。これにより、検索結果のタイトル一覧などを簡単に集めることが可能です。

Playwright Pythonの応用テクニック：さらに便利に！

基本操作に慣れてきたら、さらにPlaywright Pythonの便利な機能を活用してみましょう。

1. 非同期処理（Asyncio）の活用

Playwrightには、同期API (playwright.sync_api) と非同期API (playwright.async_api) の2種類があります。大量のWebサイトを巡回したり、複雑な処理を並列で行いたい場合には、非同期処理を使うことでパフォーマンスが向上します。個人的には、まずは同期APIで慣れるのがおすすめです。

import asyncio
from playwright.async_api import async_playwright

async def main():
    async with async_playwright() as p:
        browser = await p.chromium.launch()
        page = await browser.new_page()
        await page.goto("https://www.example.com")
        print(await page.title())
        await browser.close()

if __name__ == "__main__":
    asyncio.run(main())

async def や await といったキーワードが使われているのがわかりますね。非同期処理は、Pythonの学習コストが少し上がりますが、より高度な自動化を目指すなら習得しておくと良いでしょう。

2. ネットワークリクエストのインターセプト

Webサイトは、JavaScriptなどで外部のAPIにリクエストを送信してデータを取得していることがよくあります。Playwrightを使えば、これらのネットワークリクエストを傍受（インターセプト）し、レスポンスを書き換えたり、特定のデータだけを抽出したりすることが可能です。

これは、Webスクレイピングの際に、JavaScriptで動的に生成されるコンテンツを取得したい場合や、APIからのレスポンスを直接解析したい場合に非常に強力な手段となります。

from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch()
    page = browser.new_page()

    # リクエストを傍受するための設定
    page.route("**/*", lambda route: route.continue_())
    # 特定のAPIリクエストへのレスポンスをモックする例（ここでは省略）

    page.goto("https://httpbin.org/json") # JSONを返すテストAPI

    # JSONレスポンスを取得する例
    response = page.request.get("https://httpbin.org/json")
    json_data = response.json()
    print(json_data["slideshow"]["title"])

    browser.close()

page.route() を使うことで、特定のURLパターンにマッチするリクエストやレスポンスを処理できます。この機能を使えば、より高度なデータ取得やテストが実現できます。

3. エラーハンドリングとリトライ処理

Web自動化では、ネットワークエラーや要素が見つからないなどの予期せぬエラーが発生することがつきものです。こうしたエラーに適切に対処するために、try-exceptブロックを使ったエラーハンドリングや、リトライ処理を実装することが重要になります。

from playwright.sync_api import sync_playwright, TimeoutError

---

※この記事にはアフィリエイトリンクを含みます（PR）

## この記事で紹介したツール・書籍

**[Pythonで副業を始める入門書](https://www.amazon.co.jp/s?k=Python+%E5%89%AF%E6%A5%AD+%E8%87%AA%E5%8B%95%E5%8C%96+%E5%85%A5%E9%96%80&tag=aifukugyolab2-22)** — Python入門 — 副業・自動化に使えるプログラミング

**[ブラウザ自動化の本を見る](https://www.amazon.co.jp/s?k=Playwright+Python+%E8%87%AA%E5%8B%95%E5%8C%96&tag=aifukugyolab2-22)** — ブラウザ自動化ツール — Webスクレイピング・テスト自動化の実践書

**[アフィリエイト入門書を見る](https://www.amazon.co.jp/s?k=%E3%82%A2%E3%83%95%E3%82%A3%E3%83%AA%E3%82%A8%E3%82%A4%E3%83%88+%E5%88%9D%E5%BF%83%E8%80%85+%E5%A7%8B%E3%82%81%E6%96%B9&tag=aifukugyolab2-22)** — アフィリエイトの始め方 — 初心者向け実践ガイド