google-one-tools — FridaでGoogle Oneのプランや決済を調査するツール
hatsunemiku-ai/google-one-tools
★ 1,047 ・ Python ・ MIT
概要
google-one-tools は、Androidエミュレータ(MuMu Playerなど)内で動作している Google One アプリのプロセスに対して Frida を用いてコードを動的注入し、Google Play の BillingClient を直接呼び出すための Python 製ツールキットです。
アカウントに対して提供されている各種 Google One プラン(ストレージ容量や AI 関連の各 SKU)のオファー状況(無料試用や割引価格など)をスキャンして一覧化したり、指定した任意の SKU の Google Play 決済画面(チェックアウト画面)を端末上に立ち上げたりできます。Google Play のアプリ内課金(In-App Billing)の挙動調査や、アカウントごとの提供プラン状況を確認したいリサーチャーや開発者に向いているツールです。
主な特徴
-
利用可能なサブスクリプションオファーのスキャン アカウントに対して提供されている候補 SKU(約70種類)を網羅的に走査し、無料試用枠や割引、通常価格といったオファー情報およびトークンを取得・確認できます。特定の SKU のみを指定して照会する機能も備わっています。
-
任意 SKU の決済画面呼び出し 指定した SKU の Play ストア決済画面を画面上にポップアップ表示させることができます。スクリプト自体は決済の完了ボタンを押さず、画面を立ち上げるだけの仕様になっています。
-
自己完結型の構成 元となったスクリプトから必要なロジック(ADB 接続、frida-server の管理、課金モジュール、注入テンプレートなど)が
ultra0_core.pyとして切り出されており、外部リポジトリのスクリプトに依存せずに単体で動作します。 -
複数エミュレータ環境のサポート ADB 経由で複数台のエミュレータインスタンスが稼働している環境でも、シリアル番号(ポート番号)を引数または環境変数で明示的に指定することで、目的のインスタンスに正確に接続して注入を行えます。
-
診断スクリプトの同梱 Frida のバージョン整合性、Java ブリッジの状態、Google Play ストアの稼働状態などを事前にチェックできる環境診断スクリプトが用意されています。
-
エミュレータ内 VPN との共存を意識した設計 注入経路は ADB のポートフォワードを介して行われるため、エミュレータ内部で VPN やプロキシツールが動作している状態でも干渉しにくい設計となっています。
使い方
前提条件
README では、動作に必要な条件として以下が挙げられています。
- Python 3.9 以上(Windows 環境では
pythonではなくpyランチャーの使用が推奨されています) - ホスト側の Frida バージョンが 16.x であること(推奨は
16.7.19) ※Frida 17.x では MuMu(Android 12 / x86_64)環境で Java ブリッジが破損し動作しないため、バージョン指定が必須とされています。 - root 化されたエミュレータ環境(Google アカウントにログイン済みで、Google One と Google Play ストアがインストールされていること)
# Frida 16.x のインストール(推奨バージョン)
py -m pip install frida==16.7.19
実行手順
リポジトリのディレクトリに移動後、以下の手順で実行します。
cd C:\path\to\google-one-tools
# 0. 環境の自己診断(初回実行時に推奨)
py probe_env.py
# 1. 現在のアカウントで利用可能な全オファーをスキャン(購入は行われません)
py scan_all.py # 1台目のエミュレータを自動選択
py scan_all.py 127.0.0.1:16384 # インスタンスを指定する場合
# 2. 特定の SKU のみを指定して照会
py query_sku.py g1.30tb g1.20tb
# 3. 指定した SKU の決済画面を呼び出す(画面が表示されるのみで、自動課金はされません)
py launch_checkout.py --sku g1.20tb
py launch_checkout.py --sku g1.30tb 127.0.0.1:16384
複数インスタンスを管理している場合は、環境変数 SERIAL に ADB の接続先を指定して実行することも可能です。
$env:SERIAL="127.0.0.1:16384"; py scan_all.py
技術的なポイント
Frida と JavaScript による動的フック
本ツールは、Python から Frida API を経由してターゲットプロセス(Google One)に JavaScript スクリプト(launch_checkout.js や scan_offers.js)を注入しています。Android の Java ランタイム上の BillingClient インスタンスや関連クラスにアクセスし、SKU の問い合わせ処理(queryProductDetailsAsync 等に相当する処理)や購入フロー開始(launchBillingFlow)の呼び出しをエミュレータ内部で代行させています。
Frida 16.x への固定と環境互換性
MuMu Player 12(Android 12 / x86_64)などのエミュレータ環境において、Frida 17.x 系で発生する Java ブリッジの不具合(Java is not defined エラー)を避けるため、Frida 16.7.19 の利用が強く前提づけられています。また、ターゲットデバイス側で動作する frida-server も同バージョンが必要ですが、スクリプト側で適切なバイナリを自動取得して配置するロジックが含まれています。
ネットワークと VPN 対策
課金サービス(InAppBillingService)は Google サーバーとの通信を伴うため、エミュレータ側で VPN を全トラフィックに適用していると gRPC 呼び出しのタイムアウトやサービスのクラッシュが発生しやすくなります。README では、スプリットトンネリング(アプリ別ルーティング)機能を用いて以下の主要パッケージを VPN 対象外に設定することが推奨されています。
com.android.vending(Google Play ストア)com.google.android.gms(Google Play 開発者サービス)com.google.android.apps.subscriptions.red(Google One)
注意点
-
試用資格の消費リスク
README の重要事項として、決済画面を呼び出す処理(launchBillingFlow)が正常終了(コード 0)した場合、実際に購入完了ボタンを押さなくても、対象アカウントの初回試用資格(無料トライアル枠)が消費されてしまう可能性があると明記されています。同一アカウントに対して無暗に無料プランの決済画面を立ち上げ直すことは避けるよう警告されています。 -
課金と自動更新の挙動
スクリプトは決済画面を表示するのみで自動購読は行いませんが、ユーザー自身が手動で画面上の定期購入ボタンを確定させた場合は正規の料金が発生します。また、無料試用期間が終了した後は通常の有料サブスクリプションとして自動更新されるため、試用目的の場合は手動での解約管理が必要です。 -
環境依存と Play サービスの挙動
エミュレータ環境や Google Play ストアのバージョンによっては、プロセスの強制終了(SIGABRT)やサービスのフリーズが発生する場合があります。その際はエミュレータの再起動や Play ストアのキャッシュ消去、診断スクリプト(probe_env.py)での確認が求められます。 -
ライセンス
本リポジトリは MIT ライセンスの下で公開されています。
まとめ
google-one-tools は、Android エミュレータ環境と Frida を組み合わせ、Google One の内部的な課金呼び出しを調査・検証するための Python スクリプト群です。Play Billing の挙動検証や特定アカウントにおけるオファー状況の確認に活用できますが、試用資格の消費リスクや課金発生の可能性があるため、仕様と注意点を正しく把握した上で扱う必要があります。





