fake useragentダウンロード - fake useragentソースコードのダウンロード

fake useragent

パイソン

2.0.2

ダウンロード

fake-useragent のテストとデプロイラフリンターコードQL

偽ユーザーエージェント

実世界のデータベースを備えた最新のシンプルなユーザーエージェントフェイカー。

特徴

データは Intoli LLC から事前にダウンロードされ、後処理されており、データはパッケージ自体の一部です
データは広範囲のブラウザエージェントとさまざまなブラウザで構成されます
ユーザーエージェント文字列 (両方のタイプ: desktop 、 tablet 、 mobile UA) を取得します。
useragent 、 percent 、 type 、 device_brand 、 browser 、 browser_version 、 os 、 os_version 、 platformなどのフィールドを含む、ユーザーエージェントの Python 辞書 (別名オブジェクト) を取得します。
Python 3.xをサポート

インストール

pip install fake-useragent

または、複数の Python / pip バージョンがインストールされている場合は、 pip3を使用します。

pip3 install fake-useragent

使用法

以下に簡単な使用例を示します。より高度な使用法については、この Readme の次の章も参照してください。

 from fake_useragent import UserAgent
ua = UserAgent ()

# Get a random browser user-agent string
print ( ua . random )
# Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:132.0) Gecko/20100101 Firefox/132.0

# Or get user-agent string from a specific browser
print ( ua . chrome )
# Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36
print ( ua . google )
# Mozilla/5.0 (iPhone; CPU iPhone OS 18_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) GSA/343.0.695551749 Mobile/15E148 Safari/604.1
print ( ua [ 'Chrome' ])
# Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36
print ( ua . firefox )
# Mozilla/5.0 (Android 14; Mobile; rv:133.0) Gecko/133.0 Firefox/133.0
print ( ua . ff )
# Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:132.0) Gecko/20100101 Firefox/132.0
print ( ua . safari )
# Mozilla/5.0 (iPhone; CPU iPhone OS 17_6_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.6 Mobile/15E148 Safari/604.1 Ddg/17.6
print ( ua . opera )
# Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/128.0.0.0 Safari/537.36 OPR/114.0.0.0
print ( ua . edge )
# Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/125.0.0.0 Safari/537.36 Edg/125.0.0.0

追加の使用法

fake-useragent が v1.2.0 以降で提供する追加機能。

独自のブラウザリストを指定したい場合は、 browsers引数を使用して指定できます (デフォルトは["Google", "Chrome", "Firefox", "Edge", "Opera"," Safari", "Android", "Yandex Browser", "Samsung Internet", "Opera Mobile", "Mobile Safari", "Firefox Mobile", "Firefox iOS", "Chrome Mobile", "Chrome Mobile iOS", "Mobile Safari UI/WKWebView", "Edge Mobile", "DuckDuckGo Mobile", "MiuiBrowser", "Whale", "Twitter", "Facebook", "Amazon Silk"] ）。
この例では、Edge と Chrome からランダムなユーザーエージェントのみが返されます。

 from fake_useragent import UserAgent
ua = UserAgent ( browsers = [ 'Edge' , 'Chrome' ])
ua . random

注: Fakeuser-agent が認識しているブラウザ: Chrome、Edge、Firefox、Safari、Opera、Android、Opera Mobile、Mobile Safari、Firefox Mobile、Firefox iOS、Chrome Mobile、Chrome Mobile iOS など (上記の完全なリストを再度参照してください)。
注 #2: fakeuser-agent v2.0.0 以降、ブラウザ名では大文字と小文字が区別されます。

独自のオペレーティングシステムを指定したい場合は、 os引数を使用して指定できます (デフォルトは["Windows", "Linux", "Ubuntu", "Chrome OS", "Mac OS X", "Android", "iOS"] )。
この例では、Linux ユーザーエージェントのみを取得します。

 from fake_useragent import UserAgent
ua = UserAgent ( os = 'Linux' )
ua . random

注: fakeuser-agent v2.0.0 以降、OS 名は大文字と小文字が区別されます。

使用するプラットフォームのタイプを指定することもできます。これは、 platforms引数を介して行うことができます (デフォルトは["desktop", "mobile", "tablet"]です。この例では、モバイルからランダムなユーザーエージェントのみが返されます)デバイス：

 from fake_useragent import UserAgent
ua = UserAgent ( platforms = 'desktop' )
ua . random

より最近のユーザーエージェント文字列を返したい場合は、 min_version引数を使用できます (デフォルトは0.0で、すべてのユーザーエージェントが一致することを意味します)。
この例では、最小バージョン 120.0 を持つユーザーエージェントのみを取得します。

 from fake_useragent import UserAgent
ua = UserAgent ( min_version = 120.0 )
ua . random

下位互換性を維持するために、最小使用率は引き続きmin_percentage引数で指定できます。ただし、ユーザーエージェントの現在のリストにはこの統計は含まれていません。したがって、すべてのユーザーエージェントが一致します。

ヒント:もちろん、これらの引数をすべて好きなように組み合わせることができます。

ユーザーエージェントPython辞書

バージョン 1.3.0 以降、ユーザーエージェント文字列のみではなく、UA の Python 辞書全体を返す次の "get" プロパティも提供されるようになりました。

警告生の JSON オブジェクト (Python ディクショナリ内) は「そのまま」返されます。つまり、このデータ構造は将来変更される可能性があります。
以下の「get」プロパティは、将来同じキーと値のペアを返さなくなる可能性があることに注意してください。安定したインターフェイスを使用したい場合は、上記のようにua.randomなどを使用してください。

 from fake_useragent import UserAgent
ua = UserAgent ()

# Random user-agent dictionary (object)
ua . getRandom
# {'percent': 0.8, 'useragent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/116.0.0.0 Safari/537.36 Edg/116.0.1938.76', 'system': 'Edge 116.0 Win10', 'browser': 'edge', 'version': 116.0, 'os': 'win10'}

# More get properties:
ua . getFirefox
# {'percent': 0.3, 'useragent': 'Mozilla/5.0 (Windows NT 10.0; rv:109.0) Gecko/20100101 Firefox/118.0', 'system': 'Firefox 118.0 Win10', 'browser': 'firefox', 'version': 118.0, 'os': 'win10'}
ua . getChrome
ua . getSafari
ua . getEdge

# And a method with an argument.
# This is exactly the same as using: ua.getFirefox
ua . getBrowser ( 'firefox' )

注意事項

fallbackパラメーターを使用してフォールバック文字列をオーバーライドできますが、非常にまれに何かが失敗することがあります。

 from fake_useragent import UserAgent

ua = UserAgent ( fallback = 'your favorite Browser' )
# in case if something went wrong, one more time it is REALLY!!! rare case
ua . random == 'your favorite Browser'

不明なブラウザを取得しようとする場合:

 from fake_useragent import UserAgent
ua = UserAgent ()
print ( ua . unknown )
#Error occurred during getting browser: randm, but was suppressed with fallback.
#Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.0.0 Safari/537.36 Edg/122.0.0.0

UserAgent で__getattr__メソッドによって一部の属性をオーバーライドしないようにする必要がある場合は、 safe_attrsを使用してそこに属性名を渡すことができます。少なくともこれにより、属性が見つからないときに FakeUserAgentError が発生するのを防ぐことができます。

たとえば、 injections <https://github.com/tailhook/injections>で偽の useragentを使用する場合、次のことを行う必要があります。

 from fake_useragent import UserAgent

ua = UserAgent ( safe_attrs = ( '__injections__' ,))

なぜこれが必要なのか理解できない場合は使用しないでください。これは、まれに極端なケースに対処するための魔法です。

問題が発生しましたか?

最新バージョンを使用していることを確認してください。

pip install --upgrade fake-useragent

または、それが機能しない場合は、次のように最新のパッケージバージョンをインストールしてみてください ( 2.0.1が例です。PyPi で最新バージョンを確認してください)。

pip install fake-useragent==2.0.1

Python コンソールでバージョンを確認します。

 import fake_useragent

print ( fake_useragent . __version__ )

いつでも問題を投稿していただけます。

使用しているバージョンを忘れずにお知らせください。

開発者向け

ユーザーエージェントデータ

user-agents.net から取得したユーザーエージェントデータ。データは JSONlines 形式で保存されます。ファイルはsrc/fake_useragent/dataディレクトリにあります。

現在、user-agents.net からユーザーエージェントスクリプトを取得し、ユーザーエージェントを随時更新する新しい自動化スクリプト (問題 #333 を参照) に取り組んでいます。

データ JSON ファイルは Python パッケージの一部です。pyproject.toml を参照してください。データファイルのサポートについて詳しくは、こちらをご覧ください。

Python仮想環境

Pip パッケージをインストールする前に、次のように Python 仮想環境を使用することをお勧めします。

python -m virtualenv env
source env/bin/activate

ローカルインストール

pip install -e .

テスト

pip install -r requirements.txt
tox

糸くず

ruff を使用してインポートを修正するには:

pip install -r requirements.txt
ruff check --select= " I " --fix .

ブラックコードのフォーマットエラーを修正します。

pip install -r requirements.txt
black .

注: ruff v1.0 がリリースされると、おそらくblackではなくruffに完全に移行します。

変更履歴

2.0.1
- toml 構成に require-python を追加する
2.0.0 2024 年 12 月 4 日
- 新しいデータソースに切り替えます (もう一度)
- 可能なブラウザオプション: "Google", "Chrome", "Firefox", "Edge", "Opera"," Safari", "Android", "Yandex Browser", "Samsung Internet", "Opera Mobile", "Mobile Safari", "Firefox Mobile", "Firefox iOS", "Chrome Mobile", "Chrome Mobile iOS", "Mobile Safari UI/WKWebView", "Edge Mobile", "DuckDuckGo Mobile", "MiuiBrowser", "Whale", "Twitter", "Facebook", "Amazon Silk"
- 可能な OS オプション: "Windows", "Linux", "Ubuntu", "Chrome OS", "Mac OS X", "Android", "iOS"
- 可能なタイプのオプション: "desktop", "mobile", "tablet"
- 新しいデータのキー/値オブジェクトを処理するために fake.py を更新します。
- READMEを更新しました
- browsers.json の名前をbrowsers.jsonl に変更しました。その他のリファクタリング。
1.5.1 2024 年 3 月 16 日
- ユーザーエージェント文字列の末尾のスペースを削除する
1.5.0 2024 年 3 月 8 日
- 新しいユーザーエージェントデータソース (@BoudewijnZwart に感謝)、下位互換性のある API に移行しました。
- すべての pip パッケージの依存関係を最新の安定したバージョンに更新します
1.4.0 2023 年 11 月 24 日
- すべての PIP パッケージを更新する
- Python 3.12 をサポート (@vladkens に感謝)
- キャッシュスクレーパーでのパッケージの競合を修正
- ruff CLI 呼び出しを改善する
1.3.0 2023 年 10 月 2 日
- 新しいua.getRandom 、 ua.getFirefox 、 ua.getChrome 、 ua.getSafariの導入。そして汎用メソッド: ua.getBrowser(..) (例: getBrowser('firefox') )
  - 上記の新しいプロパティを使用すると、UA 文字列のみではなく、生の Python 辞書全体を取得できます。
  - これらのプロパティは、将来的に異なるキーと値のペアを返す可能性があります。
- win10とwin7両方の値をチェックするようにos引数 'windows' を修正し (以前はwin10のみをチェックしていました)、より多くの UA を返します。
- 改良されたユーザーエージェントスクレーパー (再び Safari ブラウザーも含まれるようになりました)
- 更新された browsers.json データファイル
1.2.1 2023 年 8 月 2 日
- min_percentageチェックの小さな改善
- すべての Pip パッケージの依存関係を更新する
1.2.0 2023 年 8 月 2 日
- ブラウザのユーザーエージェントデータが更新されました
- ブラウザ、OS、使用率のフィルタを許可する
- キャッシュスクレーパーを更新して、ユーザーエージェント文字列の新しいデータソースをスケープします。
- 新しい JSON データ形式で動作するようにコードを調整しました
- パラメータuse_external_data=Trueおよびverify_sslは削除されます。これらのパラメーターを使用する場合は、コードから削除するだけです。
1.1.3 2023 年 3 月 20 日
- 依存関係を更新する
1.1.2 2023 年 2 月 8 日
- セキュリティ修正
1.1.1 2022 年 12 月 4 日
- ユーザーエージェント文字列から空白を削除します。これはパッチリリースです。
1.1.0 2022 年 11 月 26 日
- ローカル JSON データファイルを取得しようとする際のフォールバックメカニズムとしてpkg_resource追加します
1.0.1 2022 年 11 月 10 日
- importlib-metadataとimportlib-resources依存関係として追加します
- files()が機能するようにするには、importlib リソースに関する特定の Python バージョン (Python v3.10 以降) を確認してください。
- importlib_metadata 3.8 より前の Python バージョンでも動作するようになりました。
- 古いMANIFEST.inファイルを削除します
1.0.0 2022 年 11 月 17 日
- JSON Lines データファイルを Python パッケージの一部にします。データはローカルに取得されます。
  - package-dataサポートを使用してmyproject.tomlファイルを拡張する
- 集中キャッシュサーバーの実装を削除する
- 信頼性が高く、高速で、独立して、インターネット接続なしで実行できる実際の単体テストを作成します。
0.1.14 2022 年 11 月 5 日
- 最新の Python >=3.7 構文を使用してコード品質基準を向上させる
- pyproject.tomlビルドシステム形式 + 構文チェックに移行
- toml ファイルに追加の分類子を追加する
- tox.iniファイルの改善
- pip キャッシュを使用した GitHub Actions ジョブの改善
- そして、さまざまな小さな修正
0.1.13 2022 年 10 月 21 日
- browsers引数を実装すると、使用するブラウザ名をオーバーライドできるようになります。
- Internet ExplorerとEdgeのブラウザリストを修正
- もう w3schools.com に依存しないでください
- クリーンアップデータ（一時）ファイル形式
- フォールバックキャッシュサーバーの URL を更新する / ファイル形式として JSON ラインを使用する
- Travis ではなく GitHub Actions に移動する
- Flake を優先してblack Python フォーマッタを使用する
0.1.12 2022 年 3 月 31 日
- 分岐した
0.1.11 2018 年 10 月 4 日
- フロリダの誰かが先月約 2,500 万のリクエストを行ったため、 s3 + cloudfrontフォールバックをheroku.comに移動しました
0.1.10 2018 年 2 月 11 日
- マイナー修正ドキュメントのcloudfront URL
0.1.9 2018 年 2 月 11 日
- w3schools.com名前がIE/EdgeからEdge/IEに変更された問題を修正
- heroku.comフォールバックをs3 + cloudfrontに移動しました
- Python3.3とpypyのテストをやめる
0.1.8 2017 年 11 月 2 日
- useragentstring.com修正してCan't connect to local MySQL server through socket
0.1.7 2017 年 4 月 2 日
- 壊れたREADME.rstを修正
0.1.6 2017 年 4 月 2 日
- use_cache_serverバグを修正しましたが、何も影響しませんでした
- w3schools.com <https://www.w3schools.com/browsers/browsers_stats.asp> _ httpsに移動しました
- verify_sslオプションが追加されました。デフォルトではTrue (Python 2.7.9 および 3.4.3 のurllib.urlopen ssl コンテキストはサポートされていません)
0.1.5 2017 年 2 月 28 日
- Internet Explorer にua.edgeエイリアスを追加しました
- w3schools.com がEdge統計の表示を開始
- Python 2.6 はもうテストされていません
- use_cache_serverオプションが追加されました
- fake_useragent.settings.HTTP_TIMEOUTを 5 秒に増加しました
0.1.4 2016 年 12 月 14 日
- カスタムデータファイルの場所のサポートを追加しました
- データソースが利用できない場合に備えて、 fallbackブラウザのサポートを追加しました
- fake_useragent.FakeUserAgentのエイリアスfake_useragent.UserAgentを追加しました
- fake_useragent.FakeUserAgentErrorのエイリアスfake_useragent.UserAgentErrorを追加しました
- fake_useragent.settings.HTTP_TIMEOUTを 3 秒に短縮しました
- 新しいデータファイル形式への移行を開始
- 4 年以上古いコードを大幅に簡略化
- スレッド/グリーンレットの安全性の向上
- 詳細ログを追加しました
- __getattr__によるオーバーライドを防ぐためのsafe_attrsを追加しました
0.1.3 2016 年 11 月 24 日
- リモートサービスが利用できない場合に、ホストされたデータファイルを追加しました
- データをダウンロードする方法がない場合に、 fake_useragent.errors.FakeUserAgentErrorを発生させます。
- 不明なブラウザの場合は、 Noneではなく、 fake_useragent.errors.FakeUserAgentErrorが発生します。
- データをダウンロードしようとするときに、 geventパッチが適用された環境にgevent.sleepサポートを追加しました。
XXX xxxxxxx xx、xxxx
- xxxxx ?????