Repolode
mherrmann

mherrmann/helium

Seleniumをベースにしたブラウザー自動化用Pythonライブラリ。セレクターではなく、画面に表示されるラベルで要素を指定できます。

スター
8,322
フォーク
513
未解決の Issue
55
最終コミット
3 日前

これは何?

Heliumは、ChromeとFirefoxを自動操作するためのPythonライブラリです。Seleniumをラップし、各呼び出しをSeleniumに渡すため、基盤となるドライバーもそのまま利用でき、1つのスクリプト内で両者を自由に組み合わせられます。

最大の違いはAPIです。HTML ID、XPath、CSSセレクターではなく、Button('Download')のように、ユーザーに見えるラベルで要素を指定します。同等のSeleniumコードと比べてスクリプトを通常30~50%短くでき、ページのマークアップが変わっても壊れにくくなります。

Heliumは、素のSeleniumでは扱いにくいいくつかの操作にも対応しています。ネストされたiframe内の要素を切り替え操作なしで操作でき、ポップアップの開閉に合わせてフォーカスを移し、タイトルの一部を使ってウィンドウを切り替えられます。また、要素が表示されるまで最大10秒間、暗黙的に待機します。明示的な待機には、よりシンプルなwait_untilヘルパーも利用できます。

主な機能

  • 01セレクターの代わりに、ボタンやリンクなど画面に表示されるラベルで要素を特定できます。
  • 02Seleniumを通じてChromeとFirefoxを操作できます。
  • 03明示的な切り替え操作なしで、ネストされたiframe内の要素を操作できます。
  • 04ポップアップウィンドウを自動的に処理し、タイトルの一部を使ってウィンドウを切り替えられます。
  • 05要素が表示されるまで、デフォルトで最大10秒間待機します。
  • 06同じスクリプト内でHeliumの呼び出しとSelenium APIを組み合わせて使えます。

ユースケース

  • フォーム入力やレポートのダウンロードなど、繰り返し行うWeb作業の自動化。
  • 読みやすく、マークアップの変更にも強いブラウザーテストの作成。
  • 画面に表示されるテキストで要素を特定しやすいページのスクレイピング。

クイックスタート

  1. 1

    仮想環境を作成する

    python3 -m venv venv
  2. 2

    仮想環境を有効化する(Mac/Linux)

    source venv/bin/activate
  3. 3

    pipでHeliumをインストールする

    python -m pip install helium

使う前に知っておきたいこと

  • ChromeまたはFirefoxがインストールされている必要があります。
  • メンテナーは時間に余裕がないため、簡単に対応できる場合を除き、通常はIssueに返信しません。

収録されている特集

トピック

よくある質問

helium とは?
Seleniumをベースにしたブラウザー自動化用Pythonライブラリ。セレクターではなく、画面に表示されるラベルで要素を指定できます。 Heliumは、ChromeとFirefoxを自動操作するためのPythonライブラリです。Seleniumをラップし、各呼び出しをSeleniumに渡すため、基盤となるドライバーもそのまま利用でき、1つのスクリプト内で両者を自由に組み合わせられます。
helium は無料で使えますか?ライセンスは?
helium は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
helium は今もメンテナンスされていますか?
活発にメンテナンス中。helium の最終コミットは 2026年10月22日 です。
helium は何に使えますか?
フォーム入力やレポートのダウンロードなど、繰り返し行うWeb作業の自動化。 読みやすく、マークアップの変更にも強いブラウザーテストの作成。 画面に表示されるテキストで要素を特定しやすいページのスクレイピング。
helium のインストール方法は?
仮想環境を作成する: python3 -m venv venv 仮想環境を有効化する(Mac/Linux): source venv/bin/activate pipでHeliumをインストールする: python -m pip install helium
helium はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/mherrmann/helium

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト