メインコンテンツへスキップ

Playwrightとは?Windowsで最初の1枚のスクリーンショットを撮るまで|初心者が最初につまずく3つのエラーと直し方

    毎朝、同じサイトを開いて、同じ画面を確かめている。月末には、管理画面のスクリーンショットを何十枚も撮って、報告書に貼っている。

    その「ブラウザでの決まった作業」を、プログラムに代わりにやってもらえるのが Playwright(プレイライト) です。Microsoftが作っている無料のツールで、Chrome(Chromium)・Firefox・Safari系(WebKit)のブラウザを動かせます。

    ネットの入門記事は、ほとんどが 「テストの自動化」 をする開発者向けです。でも、ふつうの事務作業にも十分使えます。

    この記事は、プログラミングをしたことがない人向けに、次の4つをまとめます。

    • Playwrightで何ができるか(何ができないか)

    • Windowsでのインストール(コマンドは3つ)

    • 9行で、Webページのスクリーンショットを1枚撮る

    • 実際にやってみて出た3つのエラー と直し方

    手順は、2026年11月時点の公式ドキュメント(playwright.dev)を見ながら、Windows 11 と Python 3.13、Playwright 1.63 で実際に動かして確かめました。

    Playwrightとは:ブラウザの「リモコン」

    Pythonのコード → Playwright → ブラウザを開く・押す・入力する・保存する。画面を出さずに動くのが標準

    Playwrightは、ブラウザを動かすリモコン のようなものです。コードに書いたとおりに、ブラウザが次のことをします。

    • ページを開く

    • ボタンを押す、文字を入力する

    • 画面を読み取る

    • スクリーンショットやPDFを保存する

    人がマウスでやっていることは、だいたいできます。

    逆に、「サイトの利用規約で禁止されていること」は、Playwrightを使ってもやってはいけません。 自動でできることと、やっていいことは別です。この線引きは別の記事でまとめる予定です。まずは、自分の作業を自分のパソコンで自動にするところから始めましょう。

    「画面が出ない」のがふつう

    公式ドキュメントによると、Playwrightは 標準では画面を出さずに(ヘッドレスで)ブラウザを動かします。 実行しても何も起きていないように見えますが、裏でちゃんとブラウザが動いています。画面を見たいときの方法は、あとで説明します。

    手順1:Pythonを入れる

    まだPythonが入っていなければ、Microsoft Store で「Python」と検索して、いちばん新しい版(例:Python 3.13)を入れるのが簡単です。

    入ったかどうかは、PowerShellで確かめます。スタートメニューから「PowerShell」を開いて、次の1行を貼り付けます。

    python --version

    Python 3.13.x のように表示されればOKです。

    手順2:Playwrightを入れる(コマンドは2つ)

    PowerShellで、次の2行を1行ずつ実行します。

    python -m pip install playwright
    python -m playwright install chromium

    1行目で Playwright本体、2行目で Playwright専用のブラウザ(Chromium) を入れます。2行目は100MB以上ダウンロードするので、少し時間がかかります(私の環境では約115MBでした)。

    公式ドキュメントでは pip install playwright と playwright install と書かれています。この記事で頭に python -m を付けているのは、Windowsでよくあるエラーを避けるため です(下のエラー2で説明します)。

    また、公式の playwright install は、Chromium・Firefox・WebKitの3つを全部入れます。最初は Chromiumだけで十分 なので、chromium を付けています。

    手順3:9行で、スクリーンショットを1枚撮る

    デスクトップなど分かりやすい場所に、shot.py という名前のファイルを作ります。メモ帳で次の9行を貼り付けて、保存してください(保存するときに、ファイルの種類を「すべてのファイル」にします)。

    from playwright.sync_api import sync_playwright
    
    with sync_playwright() as p:
        browser = p.chromium.launch()
        page = browser.new_page()
        page.goto("https://example.com")
        page.screenshot(path="example.png", full_page=True)
        print(page.title())
        browser.close()

    PowerShellで、shot.py を保存した場所に移動して実行します。

    cd $HOME\Desktop
    python shot.py

    画面に Example Domain(ページのタイトル)と出て、同じ場所に example.png ができていれば成功です。

    コードは、上から順にこう読みます。

    • launch():ブラウザを起動する

    • new_page():新しいタブを開く

    • goto(...):ページを開く

    • screenshot(...):スクリーンショットを保存する(full_page=True で、下までスクロールした全体)

    • close():ブラウザを閉じる

    https://example.com を、自分がいつも見ているページのURLに変えれば、そのページのスクリーンショットになります。

    画面を見ながら動かしたいとき

    4行目を、次のように変えます。

        browser = p.chromium.launch(headless=False, slow_mo=1000)

    headless=False でブラウザの画面が出て、slow_mo=1000 で1つの操作ごとに1秒(1000ミリ秒)待つようになります。公式ドキュメントでも、動きを確かめたいときの方法として紹介されています。

    ここからが本題:実際に出た3つのエラー

    エラー1:「Executable doesn't exist」

    実際に私の環境で、手順3を最初に実行したときに出たエラーです。

    BrowserType.launch: Executable doesn't exist at C:\Users\...\ms-playwright\...
    Looks like Playwright was just installed or updated.
    Please run the following command to download new browsers:
        playwright install

    意味は「ブラウザ本体が見つからない」です。手順2の 2行目(playwright install)を飛ばした か、Playwrightを新しい版に更新した ときに出ます。Playwrightは版ごとに決まったブラウザを使うので、本体を更新したら、ブラウザも入れ直す必要があります。

    直し方は、手順2の2行目をもう一度実行するだけです。

    python -m playwright install chromium

    エラー2:「playwright という用語は認識されません」

    公式ドキュメントどおり playwright install と打つと、Windowsでは次のように言われることがあります。

    用語 'playwright' は、コマンドレット、関数、スクリプト ファイル、または操作可能なプログラムの名前として認識されません。

    英語表示のPowerShellでは The term 'playwright' is not recognized as the name of a cmdlet... と出ます(私の環境ではこちらでした)。

    Microsoft StoreのPythonなどでは、pip で入れたコマンドの置き場所が、Windowsの「コマンドを探す場所(PATH)」に入っていないことがあるためです。私の環境でも、playwright コマンドはそのままでは見つかりませんでした。

    頭に python -m を付ける と、Pythonを通して呼ぶので、置き場所を気にせずに動きます。この記事のコマンドに全部 python -m を付けているのは、このためです。

    エラー3:ファイル名を「playwright.py」にした

    練習用のファイルに playwright.py という名前を付けると、from playwright.sync_api import ... の行で、本物のPlaywrightではなく、自分のファイルを読みにいってしまいます。 実際に試すと、次のエラーになりました。

    ModuleNotFoundError: No module named 'playwright.sync_api'; 'playwright' is not a package

    「playwrightはパッケージではない」と言われたら、まずファイル名を疑ってください。

    ファイル名は、shot.py のように playwright 以外の名前 にしてください。

    次にやること

    スクリーンショットが撮れたら、Playwrightの基本はもうできています。次の一歩としては、

    • 自分のよく見るページのURLに変えて、毎朝のスクリーンショットを撮る

    • ボタンを押す・文字を入力する操作を足す(Playwrightには、操作を録画してコードにしてくれる codegen という機能があります)

    などがあります。

    ただし、ログインが必要なサイト や 他社のサイト を自動で操作する前には、そのサイトの利用規約を必ず読んでください。自動でのアクセスを禁止しているサイトもあります。

    まとめ

    • Playwrightは、ブラウザを動かすリモコン。無料で、Chrome系・Firefox・Safari系を動かせる

    • インストールは python -m pip install playwright と python -m playwright install chromium

    • 9行で スクリーンショットが撮れる。標準では 画面を出さずに 動く

    • 「Executable doesn't exist」は ブラウザの入れ忘れ。更新したときも入れ直す

    • Windowsでは python -m を付ける。ファイル名を playwright.py にしない

    今日やることは1つだけです。shot.py のURLを、毎日見ているページに変えて、1枚撮ってみてください。


    参考

    • Playwright 公式「Getting started - Library(Python)」 https://playwright.dev/python/docs/library

    • Playwright 公式「Installation(Python)」 https://playwright.dev/python/docs/intro

     
     
    AI×業務効率化の実践メモ(GAS・API・ClaudeCode)を書いています。YouTubeサムネ生成AI「サムネイルズAI」を個人開発中。新規2枚無料→ https://thumbnailais.com

    あなたへのおすすめ