Pythonを使って指定のURLのフルスクリーンショットを保存する方法

Web環境のPythonを使ってURLリストのフルスクリーンショットを保存する方法です。
この手順では、Seleniumを使用して各URLにアクセスし、
フルスクリーンのスクリーンショットを作成します。

windows は Pythonはインストールが必要なのでこのサイトを参考に設定

必要なライブラリのインストール

まず、必要なライブラリをインストールします。
以下のコマンドプロンプトを使用してSeleniumとWebドライバマネージャをインストールしてください。（ｗindowsのコマンドプロンプト）

pip install selenium webdriver-manager

Microsoft Windows [Version 10.0.22621.4890]
(c) Microsoft Corporation. All rights reserved.

C:\Users\xxxxx>pip install selenium webdriver-manager
Requirement already satisfied: selenium in c:\data\python\lib\site-packages (4.29.0)
Collecting webdriver-manager
  Downloading webdriver_manager-4.0.2-py2.py3-none-any.whl.metadata (12 kB)
Requirement already satisfied: urllib3<3,>=1.26 in c:\data\python\lib\site-packages (from urllib3[socks]<3,>=1.26->selenium) (2.3.0)
Requirement already satisfied: trio~=0.17 in c:\data\python\lib\site-packages (from selenium) (0.29.0)
Requirement already satisfied: trio-websocket~=0.9 in c:\data\python\lib\site-packages (from selenium) (0.12.2)
Requirement already satisfied: certifi>=2021.10.8 in c:\data\python\lib\site-packages (from selenium) (2025.1.31)
Requirement already satisfied: typing_extensions~=4.9 in c:\data\python\lib\site-packages (from selenium) (4.12.2)
Requirement already satisfied: websocket-client~=1.8 in c:\data\python\lib\site-packages (from selenium) (1.8.0)
Requirement already satisfied: requests in c:\data\python\lib\site-packages (from webdriver-manager) (2.32.3)
Collecting python-dotenv (from webdriver-manager)
  Downloading python_dotenv-1.0.1-py3-none-any.whl.metadata (23 kB)
Collecting packaging (from webdriver-manager)
  Downloading packaging-24.2-py3-none-any.whl.metadata (3.2 kB)
Requirement already satisfied: attrs>=23.2.0 in c:\data\python\lib\site-packages (from trio~=0.17->selenium) (25.1.0)
Requirement already satisfied: sortedcontainers in c:\data\python\lib\site-packages (from trio~=0.17->selenium) (2.4.0)
Requirement already satisfied: idna in c:\data\python\lib\site-packages (from trio~=0.17->selenium) (3.10)
Requirement already satisfied: outcome in c:\data\python\lib\site-packages (from trio~=0.17->selenium) (1.3.0.post0)
Requirement already satisfied: sniffio>=1.3.0 in c:\data\python\lib\site-packages (from trio~=0.17->selenium) (1.3.1)
Requirement already satisfied: cffi>=1.14 in c:\data\python\lib\site-packages (from trio~=0.17->selenium) (1.17.1)
Requirement already satisfied: wsproto>=0.14 in c:\data\python\lib\site-packages (from trio-websocket~=0.9->selenium) (1.2.0)
Requirement already satisfied: pysocks!=1.5.7,<2.0,>=1.5.6 in c:\data\python\lib\site-packages (from urllib3[socks]<3,>=1.26->selenium) (1.7.1)
Requirement already satisfied: charset-normalizer<4,>=2 in c:\data\python\lib\site-packages (from requests->webdriver-manager) (3.4.1)
Requirement already satisfied: pycparser in c:\data\python\lib\site-packages (from cffi>=1.14->trio~=0.17->selenium) (2.22)
Requirement already satisfied: h11<1,>=0.9.0 in c:\data\python\lib\site-packages (from wsproto>=0.14->trio-websocket~=0.9->selenium) (0.14.0)
Downloading webdriver_manager-4.0.2-py2.py3-none-any.whl (27 kB)
Downloading packaging-24.2-py3-none-any.whl (65 kB)
Downloading python_dotenv-1.0.1-py3-none-any.whl (19 kB)
Installing collected packages: python-dotenv, packaging, webdriver-manager
Successfully installed packaging-24.2 python-dotenv-1.0.1 webdriver-manager-4.0.2

[notice] A new release of pip is available: 24.3.1 -> 25.0.1
[notice] To update, run: python.exe -m pip install --upgrade pip

C:\Users\xxxxx>

pip install requests

C:\Users\xxxxx>pip install requests
Requirement already satisfied: requests in c:\data\python\lib\site-packages (2.32.3)
Requirement already satisfied: charset-normalizer<4,>=2 in c:\data\python\lib\site-packages (from requests) (3.4.1)
Requirement already satisfied: idna<4,>=2.5 in c:\data\python\lib\site-packages (from requests) (3.10)
Requirement already satisfied: urllib3<3,>=1.21.1 in c:\data\python\lib\site-packages (from requests) (2.3.0)
Requirement already satisfied: certifi>=2017.4.17 in c:\data\python\lib\site-packages (from requests) (2025.1.31)

[notice] A new release of pip is available: 24.3.1 -> 25.0.1
[notice] To update, run: python.exe -m pip install --upgrade pip

スクリプト

URLリストを読み込み、各URLのフルスクリーンショットを保存するPythonスクリプトです。
capture_screenshot.py

import sys
import time
from selenium import webdriver
from selenium.webdriver.chrome.service import Service
from selenium.webdriver.common.by import By
from selenium.webdriver.chrome.options import Options
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
from selenium.webdriver.common.alert import Alert
from selenium.common.exceptions import WebDriverException, TimeoutException

# コマンドライン引数をデバッグ出力する関数
def debug_print_arguments(args):
    print("Arguments received:", args)

# アクセスするURLをデバッグ出力する関数
def debug_print_url(url):
    print("URL being accessed:", url)

# WebDriverを初期化する関数
def initialize_webdriver(webdriver_path, browser_width, headless=True):
    chrome_options = Options()
    if headless:
        chrome_options.add_argument("--headless")  # ヘッドレスモード（GUIなし）で実行
        chrome_options.add_argument(f"--window-size={browser_width}x2160")  # 幅を指定し、高さを2160に設定
    else:
        chrome_options.add_argument("--start-maximized")  # 通常モードで最大化するオプションを追加

    chrome_options.add_argument("--ignore-certificate-errors")  # 証明書エラーを無視
    chrome_options.add_argument("--allow-running-insecure-content")  # 安全でないコンテンツの実行を許可
    service = Service(webdriver_path)
    return webdriver.Chrome(service=service, options=chrome_options)

# Basic認証の処理を行う関数
def handle_basic_auth(driver, basic_auth_id, basic_auth_pass):
    try:
        # 認証ダイアログが表示されるまで最大5秒待機
        WebDriverWait(driver, 5).until(EC.alert_is_present())
        alert = Alert(driver)
        alert.send_keys(f"{basic_auth_id}\n{basic_auth_pass}")  # IDとパスワードを入力
        alert.accept()  # 認証を実行
    except TimeoutException:
        print("The authentication dialog was not displayed.")  # 認証ダイアログが表示されない場合

# ページ全体をスクロールして完全に読み込み、スクリーンショットを取得する関数
def capture_screenshot(driver, file_path, browser_width):
    # 初期ウィンドウサイズを設定（高さは仮で2160）
    driver.set_window_size(browser_width, 2160)

    # ページ全体の読み込み完了を待機
    WebDriverWait(driver, 10).until(
        lambda d: d.execute_script("return document.readyState") == "complete"
    )

    # 現在のページの高さを取得（bodyとhtml要素の最大値を使用）
    last_height = driver.execute_script("return Math.max(document.body.scrollHeight, document.documentElement.scrollHeight)")

    while True:
        # ページの最下部までスクロール
        driver.execute_script("window.scrollTo(0, document.body.scrollHeight);")
        time.sleep(2)  # ページ描画を待機

        # 新しいページの高さを取得
        new_height = driver.execute_script("return Math.max(document.body.scrollHeight, document.documentElement.scrollHeight)")

        if new_height == last_height:  # 高さが変わらなければ終了
            break
        last_height = new_height

    # 最終的なページの高さを取得し、300px 余裕を持たせてリサイズ
    final_height = driver.execute_script("return Math.max(document.body.scrollHeight, document.documentElement.scrollHeight)") + 300
    driver.set_window_size(browser_width, final_height)  # ページ全体の高さにウィンドウを設定

    # 念のため再度最下部へスクロール（確実に表示させる）
    driver.execute_script("window.scrollTo(0, document.body.scrollHeight);")
    time.sleep(1)

    # スクリーンショットを保存
    driver.save_screenshot(file_path)  # スクリーンショットを保存

try:
    debug_print_arguments(sys.argv)  # コマンドライン引数をデバッグ出力
    
    # コマンドライン引数を取得
    url = sys.argv[1]
    file_path = sys.argv[2]
    webdriver_path = sys.argv[3]
    browser_width = int(sys.argv[4])
    
    # Basic認証情報の取得（オプション）
    basic_auth_id = sys.argv[5].encode('shift-jis').decode('utf-8') if len(sys.argv) > 5 else None
    basic_auth_pass = sys.argv[6].encode('shift-jis').decode('utf-8') if len(sys.argv) > 6 else None
    
    # URLが「http://」または「https://」で始まっていなければ「https://」を追加
    if not url.startswith("http://") and not url.startswith("https://"):
        url = "https://" + url
    debug_print_url(url)

    # Basic認証情報がある場合、URLに組み込む
    if basic_auth_id and basic_auth_pass:
        protocol, host = url.split("://")
        url = f"{protocol}://{basic_auth_id}:{basic_auth_pass}@{host}"
    debug_print_url(url)
    
    # WebDriverを初期化
    driver = initialize_webdriver(webdriver_path, browser_width)
    
    try:
        driver.get(url)  # 指定URLにアクセス
        
        # Basic認証を処理
        if basic_auth_id and basic_auth_pass:
            handle_basic_auth(driver, basic_auth_id, basic_auth_pass)
        
        # ページの読み込み完了を待機
        WebDriverWait(driver, 5).until(EC.presence_of_element_located((By.TAG_NAME, 'body')))
        
        # スクリーンショットをキャプチャ
        capture_screenshot(driver, file_path, browser_width)
        print(file_path)  # 保存先を出力
        
    except (WebDriverException, TimeoutException) as e:
        print(f"Err:An error has occurred: {str(e)}")  # エラーメッセージを出力
    finally:
        driver.quit()  # WebDriverを閉じる

# コマンドライン引数の不足エラー処理
except IndexError:
    print("Err:how to use: python script.py <url> <file_path> <webdriver_path> <browser_width> [<basic_auth_id> <basic_auth_pass>]")

# ブラウザ幅の数値変換エラー処理
except ValueError:
    print("Err:browser_width must be an integer.")

# その他の予期しないエラー処理
except Exception as e:
    print(f"Err:An Unexpected Error has occurred: {str(e)}")

このスクリプトは、Seleniumを使用してWebページを開き、ページ全体をスクロールして完全にロードした後に、フルスクリーンショットを取得するものです。JavaScriptによる非同期描画や遅延読み込みにも対応しています。

主な機能:

1. WebDriverの初期化
   • ヘッドレスモード（GUIなし）で実行（ただし、要素の描画に影響する場合は無効化可能）。
   • 初期ウィンドウサイズを browser_width x 2160 に設定。
   • 証明書エラーや安全でないコンテンツの実行許可。
2. URLの整形とBasic認証対応
   • コマンドライン引数で渡されたURLが http:// や https:// を含まない場合、自動で https:// を付与。
   • Basic認証情報がある場合、URLに埋め込むか、認証ダイアログを処理。
3. ページの読み込み待機
   • document.readyState == "complete" になるまで待機。
   • JavaScriptによる要素の描画が完了するまで、特定の要素の出現を待機。
4. ページ全体のスクロール
   • JavaScriptを使ってページの一番下までスクロールし、すべての要素をロード。
   • フッターなどの遅延読み込み要素が完全に表示されるまで待機。
5. スクロール完了後の処理
   • 画面を先頭に戻す。
   • 取得したページ全体の高さにウィンドウサイズを変更。
6. スクリーンショットの取得
   • save_screenshot(file_path) でページ全体のスクリーンショットを取得し、指定のパスに保存。
7. エラーハンドリング
   • WebDriver関連のエラー (WebDriverException や TimeoutException) をキャッチしてエラーメッセージを出力。
   • コマンドライン引数の不足や不正な値によるエラーを適切に処理。
   • その他の予期しないエラーもキャッチし、エラーメッセージを出力。

使用方法:

python script.py <url> <file_path> <webdriver_path> <browser_width> [<basic_auth_id> <basic_auth_pass>]

• <url>: スクリーンショットを取得するページのURL
• <file_path>: 画像ファイルの保存先
• <webdriver_path>: Chrome WebDriverのパス
• <browser_width>: ブラウザの横幅（例: 1920）
• [<basic_auth_id> <basic_auth_pass>]: Basic認証が必要な場合に指定（オプション）

このスクリプトを使用することで、動的に描画されるページでも適切にスクリーンショットを取得できるようになります。

EXCELマクロと組み合わせて一気に取得するなら