検索エンジンで検索し、タイトル/URL/スニペットのリストを返す。

engine: "google"(既定)/ "bing" / "duckduckgo" / "yahoo" / "brave"。 duckduckgo・braveはheadless=Falseでの利用を推奨(headlessだと botチャレンジが出やすいことを実地検証済み)。yahooはGoogleの ライセンス提供のため実質Googleと同じ結果になる (Googleがブロックされた際の避難先として使う想定)。 profile: 使用するプロファイル名。list_profiles で確認できる。 headless: デフォルトはTrue(検証済み)。False時は専用の非公開仮想ディスプレイ (weston-headless.service)を自動的に使うため、呼び出し元が$DISPLAYを 用意する必要はない(SPEC.md 3節)。

保持しているプロファイルの一覧(名前・サイズ)を返す。

既存の(すでにログイン状態を持つ)ブラウザプロファイルフォルダをコピーして取り込む。

searchの結果など、指定URLの本文をブラウザ経由(永続プロファイル使用)で取得する。

素のHTTP取得と異なり、ログイン状態やJSレンダリングが必要なページにも対応できる。 スニペットだけでは判断できない結果を、必要な数件だけ選んで深掘りする用途を想定。

プロファイルに新しい状態(ログイン等)を焼き付ける。headfulでブラウザを起動し、

ユーザーがウィンドウを閉じるまで待機する(SPEC.md 4節)。

method: "auto"(既定、$DISPLAYの有無で自動判定)/ "display"(ディスプレイに直接表示。 SSHのssh -X経由でも可) / "cdp"(ディスプレイが無い環境向け。Remote Debugging ポートを開き、手元のブラウザからリモート操作する) start_url: 最初に開くURL(例: ログインページ)。省略時は白紙タブ cdp_host/cdp_port: method="cdp"時のbind先。閉域網内のアドレスを明示的に指定すること timeout_seconds: この時間ブラウザが閉じられなければタイムアウトして強制終了する