【Python】Seleniumでブラウザ操作自動化入門【最短で動かす】

# Windows / macOS / Linux 共通
pip install selenium

# Python3向けに明示する場合
pip3 install selenium

python -c "import selenium; print(selenium.__version__)"

# sample_open_browser.py
# SeleniumでChromeブラウザを起動する最小サンプル

from selenium import webdriver
from selenium.webdriver.chrome.options import Options

def main():
    # Chromeのオプションを作成
    options = Options()
    # ここでは特別なオプションは付けない(後でヘッドレスなど追加可能)

    # Chromeブラウザを起動
    # Selenium 4.6以降では、driverの自動取得機能が動く環境があります
    driver = webdriver.Chrome(options=options)

    # ブラウザが起動したことを確認するために、しばらく待つ
    input("ブラウザが起動しました。Enterキーを押すと終了します...")

    # ブラウザを閉じる
    driver.quit()

if __name__ == "__main__":
    main()

python sample_open_browser.py

# sample_open_page.py
# 特定のURLを開き、数秒待機するサンプル

from selenium import webdriver
from selenium.webdriver.chrome.options import Options
import time

def main():
    options = Options()
    driver = webdriver.Chrome(options=options)

    # Googleのトップページを開く
    driver.get("https://www.google.com")

    # ページが目視できるように数秒待機
    time.sleep(5)

    driver.quit()

if __name__ == "__main__":
    main()

# sample_safe_quit.py
# エラーがあってもブラウザを閉じる安全な書き方

from selenium import webdriver
from selenium.webdriver.chrome.options import Options
import time

def main():
    options = Options()
    driver = webdriver.Chrome(options=options)

    try:
        driver.get("https://www.google.com")
        time.sleep(3)

        # ここで何かエラーが起きても
        # finally節でdriver.quit()が呼ばれます
        # raise Exception("テスト用のエラー")

    finally:
        # 最後に必ずブラウザを閉じる
        driver.quit()

if __name__ == "__main__":
    main()

# sample_find_element.py
# Googleの検索ボックスをfind_elementで取得する例

from selenium import webdriver
from selenium.webdriver.chrome.options import Options
from selenium.webdriver.common.by import By
import time

def main():
    options = Options()
    driver = webdriver.Chrome(options=options)

    try:
        driver.get("https://www.google.com")
        time.sleep(2)

        # name属性が "q" の検索ボックスを取得
        search_box = driver.find_element(By.NAME, "q")

        # 要素が取得できたか簡易的に確認(タグ名を表示)
        print("取得した要素のタグ名:", search_box.tag_name)

        time.sleep(2)
    finally:
        driver.quit()

if __name__ == "__main__":
    main()

# sample_click_button.py
# Googleの「検索」ボタンをクリックするシンプルな例

from selenium import webdriver
from selenium.webdriver.chrome.options import Options
from selenium.webdriver.common.by import By
import time

def main():
    options = Options()
    driver = webdriver.Chrome(options=options)

    try:
        driver.get("https://www.google.com")
        time.sleep(2)

        # 検索ボックスに適当なキーワードを入れてみる
        search_box = driver.find_element(By.NAME, "q")
        search_box.send_keys("Selenium Python")

        time.sleep(1)

        # 「Google 検索」ボタンをCSSセレクタで取得してクリック
        search_button = driver.find_element(By.CSS_SELECTOR, "input[name='btnK']")
        search_button.click()

        # 検索結果が表示されるのを待つ
        time.sleep(3)
    finally:
        driver.quit()

if __name__ == "__main__":
    main()

# sample_send_keys.py
# 入力フォームに文字を入力する基本例

from selenium import webdriver
from selenium.webdriver.chrome.options import Options
from selenium.webdriver.common.by import By
import time

def main():
    options = Options()
    driver = webdriver.Chrome(options=options)

    try:
        driver.get("https://www.google.com")
        time.sleep(2)

        # 検索ボックスを取得
        search_box = driver.find_element(By.NAME, "q")

        # 文字列を入力
        search_box.send_keys("自動化テスト 入門")

        # しばらく入力状態を確認
        time.sleep(3)
    finally:
        driver.quit()

if __name__ == "__main__":
    main()

<input id="login_id" name="username" type="text">
<input id="login_pass" name="password" type="password">
<button id="login_button">ログイン</button>

# sample_login.py
# ログインフォームにID/パスワードを入力してログインボタンを押す例
# ※実際のサイトのHTML構造と属性名に合わせて書き換えてください

from selenium import webdriver
from selenium.webdriver.chrome.options import Options
from selenium.webdriver.common.by import By
import time

LOGIN_URL = "https://example.com/login"  # ログインページのURL(例)

# 実際には環境変数や設定ファイルから読み込むことを推奨
USERNAME = "your_username"
PASSWORD = "your_password"

def main():
    options = Options()
    driver = webdriver.Chrome(options=options)

    try:
        # ログインページを開く
        driver.get(LOGIN_URL)
        time.sleep(2)

        # ユーザー名欄をIDで取得して入力
        username_input = driver.find_element(By.ID, "login_id")
        username_input.send_keys(USERNAME)

        # パスワード欄をIDで取得して入力
        password_input = driver.find_element(By.ID, "login_pass")
        password_input.send_keys(PASSWORD)

        # ログインボタンをIDで取得してクリック
        login_button = driver.find_element(By.ID, "login_button")
        login_button.click()

        # ログイン後の画面が表示されるのを数秒待つ
        time.sleep(5)

    finally:
        driver.quit()

if __name__ == "__main__":
    main()

# sample_login_wait.py
# ログイン後、特定の要素が現れるまで待機する例

from selenium import webdriver
from selenium.webdriver.chrome.options import Options
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC

LOGIN_URL = "https://example.com/login"
USERNAME = "your_username"
PASSWORD = "your_password"

def main():
    options = Options()
    driver = webdriver.Chrome(options=options)

    try:
        driver.get(LOGIN_URL)

        # ログイン情報を入力
        driver.find_element(By.ID, "login_id").send_keys(USERNAME)
        driver.find_element(By.ID, "login_pass").send_keys(PASSWORD)
        driver.find_element(By.ID, "login_button").click()

        # ここからWebDriverWaitを使って、
        # ログイン後画面にしか存在しない要素が表示されるまで待つ
        # 例: IDが "dashboard" の要素が出るまで最大10秒待機
        WebDriverWait(driver, 10).until(
            EC.presence_of_element_located((By.ID, "dashboard"))
        )

        print("ログイン後の画面が表示されました")

    finally:
        driver.quit()

if __name__ == "__main__":
    main()

# sample_exception_handling.py
# Selenium実行時のエラーを捕捉して安全に終了する例

from selenium import webdriver
from selenium.webdriver.chrome.options import Options
from selenium.common.exceptions import NoSuchElementException
from selenium.webdriver.common.by import By

def main():
    options = Options()
    driver = webdriver.Chrome(options=options)

    try:
        driver.get("https://www.google.com")

        # わざと存在しない要素を探す
        try:
            driver.find_element(By.ID, "this_id_does_not_exist")
        except NoSuchElementException as e:
            print("要素が見つかりませんでした")
            print("詳細:", e)

    except Exception as e:
        # 想定外の例外もここでログに残せる
        print("予期せぬエラーが発生しました:", e)

    finally:
        # 最後に必ずブラウザを閉じる
        driver.quit()

if __name__ == "__main__":
    main()

# sample_headless.py
# ヘッドレスモードでブラウザを起動する例

from selenium import webdriver
from selenium.webdriver.chrome.options import Options
from selenium.webdriver.common.by import By

def main():
    options = Options()
    # ヘッドレスモードを有効化
    options.add_argument("--headless=new")  # 新しいヘッドレスモード推奨
    options.add_argument("--window-size=1280,720")  # 画面サイズを指定することも多い

    driver = webdriver.Chrome(options=options)

    try:
        driver.get("https://www.google.com")

        # ページタイトルを取得して標準出力に表示
        print("ページタイトル:", driver.title)

    finally:
        driver.quit()

if __name__ == "__main__":
    main()