クイックスタート：候鳥環境を制御する

この章では、コピーしてすぐに使える Python スクリプトを紹介します。Mbbrowser 環境を乗っ取って、最初の自動化操作を成功させましょう。

---

サンプルスクリプト（そのまま使えます）

start_selenium.py を作成し、環境 ID などを書き換えて実行してください。

import requests
import time
from selenium import webdriver
from selenium.webdriver.chrome.options import Options
from selenium.webdriver.chrome.service import Service

# ============================
# 設定エリア：ご自身の情報に書き換えてください
# ============================
API_URL    = "http://127.0.0.1:8186"
SESSION_ID = "環境IDをここに貼り付け"
# Mbbrowser インストールディレクトリ内の chromedriver.exe のパス
DRIVER_PATH = r"C:\Program Files (x86)\Mbbrowser_v...\chromedriver.exe"


def start_browser():
    # --- 1. ApiServer 経由で環境を起動 ---
    print("⏳ Mbbrowser 環境を起動しています...")
    try:
        response = requests.post(f"{API_URL}/api/v1/browser/start", json={"Session_ID": SESSION_ID})
        data = response.json()
    except:
        print("❌ ApiServer に接続できません。")
        return

    if data.get("code") != 0:
        print(f"❌ 起動失敗: {data.get('message')}")
        return

    # --- 2. リモートデバッグアドレスを取得 ---
    debugger_address = data["data"]["http"]
    print(f"✅ 起動完了。デバッグアドレス: {debugger_address}")

    # --- 3. Selenium で環境を乗っ取る ---
    chrome_options = Options()
    # 既存のブラウザを制御するための最重要パラメータ！
    chrome_options.add_experimental_option("debuggerAddress", debugger_address)

    service = Service(executable_path=DRIVER_PATH)
    driver = webdriver.Chrome(service=service, options=chrome_options)

    print("🎉 Selenium での制御を開始しました！")

    # --- 4. 業務ロジックの実行 ---
    try:
        driver.get("https://www.mbbrowser.com")
        print(f"📄 ページタイトル: {driver.title}")
        time.sleep(3) # 動作確認用
        print("✅ 完了！")
    finally:
        driver.quit() # Selenium の接続を解除（ブラウザ自体は閉じません）


if __name__ == "__main__":
    start_browser()

---

核心的なポイント：debuggerAddress

通常の Selenium が「新しいブラウザ」を開くのに対し、Mbbrowser では debuggerAddress を使用して、ApiServer が起動した指紋適用済みのブラウザを乗っ取ります。これが最も重要な違いです。

---

TIP

正常に動作しましたか？次の章 核心 API の詳細解説 では、要素の検索やクリック、待機などの実用的な操作を学びます。