Lamda

FIRERPA Android ｜ AI を活用した自動化

デバイス上のサービス、AI 対応エージェント、拡張可能なツール呼び出しを統合した、オールインワンの Android 自動化フレームワークです。

ドキュメント | 使用ドキュメント | TELEGRAM | QQ グループ | スキル | llms-full.txt | 日本語版

FIRERPA は、オールインワンの Android デバイス制御プラットフォームです。サーバーはデバイス上で直接動作し、追加のランタイム依存関係はありません。複数世代の Android に対応し、root の有無を問わず動作します。PC 側では、Python クライアントライブラリが、UI 自動化、リモート操作、トラフィックキャプチャ、Hook ベースのリバースエンジニアリング、ネットワークプロキシ、分散ネットワーク、AI エージェント、MCP を、単一のサービスと API を通じて統合します。Appium、mitmproxy、frida-server、adb、uiautomator2、個別に用意したスクリプトや運用ツールを組み合わせる方法と比べて、FIRERPA は機能の単一の供給元、統一された設定、連携したワークフロー、複数デバイスでの長時間にわたる本番運用を想定したスタックを提供します。

リモートデスクトップとライブストリーミング

FIRERPA はブラウザベースのリモートデスクトップを提供します。専用の PC クライアントをインストールすることなく、LAN 経由またはネットワークをまたいで、デバイスをリアルタイムに表示・操作できます。ストリーミングはMJPEGとH.264に対応し、ソフトウェアとハードウェアのエンコードバックエンドを利用できます。フレームレート（最大 60fps）、解像度スケール、ビットレート、品質をデバイスの性能やネットワーク状況に合わせて調整できるため、通信環境の弱い接続でも帯域幅を抑え、滑らかさを向上できます。WebRTCにも対応しており、STUN/TURN サーバーを設定することで、パブリックネットワークやリージョンをまたぐ環境で NAT 越えを改善し、エンドツーエンドの遅延を低減できます。

リモートデスクトップは、共同デバッグ、デモ、トレーニングに役立つ複数ユーザーの同時アクセスに対応しています。双方向クリップボードの共有とライブ音声（Android 10 以降）に加え、統合ターミナル、ドラッグ＆ドロップによるアップロード、ブラウザ上でのファイル閲覧とダウンロードも利用できます。これらはすべて単一のポートで動作します。組み込みのビジュアルレイアウト検査では要素を強調表示し、Tab キーによる移動に対応するほか、座標と RGB 値を表示し、XML レイアウトツリーをエクスポートできます。同じ UI 上でセレクターや自動化ロジックを検証できるため、画面からスクリプトまでの反復を短縮できます。

リモートデスクトップと RPC は、エンドツーエンド TLSとサービス証明書によるアクセス制御に対応しています。パブリックネットワークでの露出を抑えるため、WebUI のログインパスワードを任意で設定することもできます。リモートデスクトップ機能は、WebSocket を介して独自の Web アプリに組み込むこともできます（ライブ動画、タッチ操作、ターミナル、キーなど）。クロスオリジン連携用の allow_origin にも対応しており、実機制御の製品化に適しています。

UI 自動化

FIRERPA は、テキスト、resourceId、説明、スクロール可能かどうかなど、一般的なマッチャーを備えたセレクターベースの自動化システムを提供します。また、重複する要素、深い階層にある要素、特徴的な属性のないコントロールに対応するため、子要素／兄弟要素を連結できます。要素レベルでは、スクリーンショット、出現／消失の待機、隅／中央の座標、存在確認、Unicode 入力、段階的なスワイプ、フリングスクロール、最後までスクロールなどを利用できます。Android 8.0 以降では、ほかのアクセシビリティサービスと共存でき、ハイブリッドアプリの WebView ノード検出も改善します。

UI ウォッチャーは UI の変化をリアルタイムで監視し、条件に一致した場合にクリック、キーイベント、カウンターの処理を実行します。規約への同意、アップデート通知、広告などの割り込みを自動で閉じる場合に便利です。複数のセレクター条件と、イベントごとの有効／無効の切り替えに対応しており、一時的な画面をカウントできます。

仮想ディスプレイは特長的な機能です。デバイス上に分離されたバックグラウンドディスプレイを作成し、メイン画面に影響を与えずにアプリや自動化を実行できます。たとえば、通常どおりスマートフォンを使いながら、仮想ディスプレイ上で自動返信を実行できます。仮想ディスプレイ API はメインデバイスの API を踏襲しています（d.xxx → vd.xxx）。ウォッチャーの対象を仮想ディスプレイに限定することもできます。WebUI のリモートデスクトップは、複数ディスプレイの表示と切り替えに対応しており、バックグラウンドタスク、並行作業、人間参加型の作業と機械による自動化に最適です。

標準的なビュー階層のない画面（ゲームや独自描画 UI など）に対して、FIRERPA はOCRと画像マッチングを提供します。OCR は paddleocr、easyocr、カスタム HTTP バックエンドに対応します。クラスター環境では、各 PC にモデルを読み込む代わりに認識処理を中央で実行でき、GPU アクセラレーションと柔軟なテキストマッチングも利用できます。画像マッチングはテンプレート方式または SIFT 方式でデバイス上で実行され、PC のリソースを消費しません。SIFT は回転、拡大縮小、照明の変化に強い方式です。マルチタッチは、複雑なジェスチャーの記録、再生、プログラムによる構成、バイナリ形式での保存に対応します。

アーキテクチャでは、FIRERPA はクライアント／サーバーモデルを採用しており、AutoJS のようなデバイス上で動くスクリプトランナーよりも集中スケジューリング、バージョン管理、フリート制御に適しています。Appium より軽量で、複数デバイスのシナリオでは uiautomator2 より安定しています。ドキュメントでは、FIRERPA を一般的な Android 自動化スタックの機能的な上位互換として位置付けています。自動化、キャプチャ、Hook、運用を、ツールを切り替えずに単一のプラットフォーム上でコードから連携できます。

パケットキャプチャと MITM

FIRERPA はワンクリック MITM キャプチャを提供します。システムルート CA の自動インストール、プロキシ設定、Android バージョンの違いへの対応、終了時のネットワーク設定の自動復元を行うため、証明書やプロキシを手動で切り替える必要はありません。グローバルキャプチャ、パッケージ単位のキャプチャ、リクエスト／レスポンスのリアルタイム編集、mitmweb の共有、国際通信向けの上流 HTTP プロキシに対応しています。組み込みの QUIC ダウングレードにより、QUIC による妨害を軽減します。PC とデバイスが FIRERPA のポートを 1 つだけ共有している場合（ADB 接続や frp 転送など）でも、キャプチャは動作します。

ワンクリックスクリプトにとどまらず、MITM は完全にAPI 駆動です。mitmproxy、Fiddler、Charles などと互換性のあるシステム CA をインストール／アンインストールでき、UI 操作や Frida Hook と並行して、自動化パイプラインにキャプチャを組み込めます。Python をインストールせずに使える Windows 用の startmitm.exe も用意されています。

ネットワーク、プロキシ、接続

デバイス上で、FIRERPA は HTTP / HTTPS / SOCKS5 / Shadowsocks（複数の暗号方式）、アプリごとのプロキシ（マルチユーザーのクローンを含む）、DNS プロキシ、UDP プロキシ、LAN バイパス、OpenVPN との併用、設定済みプロキシへの起動時の自動接続を含む、完全なプロキシサポートを提供します。プロキシは、複雑なネットワーク向けに IPv6 と UDP をサポートします。

**デバイス HTTP ブリッジプロキシ（tunnel2）**は、リバースプロキシ機能を提供します。PC またはブラウザーの HTTP プロキシをスマートフォンに向けると、トラフィックはスマートフォンのネットワーク経由で転送され、送信元 IP はスマートフォンのものになります。送信インターフェースには Wi‑Fi またはモバイル通信（rmnet）を選択できます。共同デバッグ、海外向けアプリ、複数デバイスの IP プールに便利です。

組み込みの OpenVPN クライアントは、証明書、ユーザー名とパスワード、混合認証に対応し、システムプロキシと併用できます。OpenVPN Docker イメージと設定ジェネレーターを使うと、デバイス側のコードと自動起動設定を生成できます。組み込みの frp クライアントは、暗号化と TLS を使用し、fwd.* 経由でデバイスのサービスをパブリックサーバーに転送します。

mDNS 検出により、リモートデスクトップなどのサービスに {device_id}.local でアクセスできます。LAN 内のデバイス検出用に、モデル、ABI、デバイス ID などの TXT メタデータを任意で付与できます。

Frida とリバースエンジニアリング

FIRERPA には最新の Fridaがバンドルされており、別途 frida-server を用意する必要はありません。リモートデスクトップのターミナルから、-U、-H などを指定せずに Frida のツールを使用できます。組み込みの検出回避パッチ（オープンソースと独自実装）は、検出方法に対応できるよう保守されています。接続には FIRERPA のポート経由でトークン認証を使用します。objection のパッチと Frida 17.x の java-bridge ヘルパーにより、移行が容易になります。

永続化 Frida スクリプトは、アプリのクラッシュや終了後に再注入されます。ディレクトリー監視とホットリロードに対応する、YAML 形式のオフライン永続化も利用できます。Frida RPC は、JVM、UI メイン、純粋な JS スレッド上で、Python メソッドおよび HTTP + JSON-RPC 2.0 のリモート呼び出しに対応します。スクリプトの emit データは、デバイス／アプリのメタデータ、zlib 圧縮、HTTP 再試行、MQTT TLS とともに、**HTTP / Redis / RabbitMQ（MQTT）**へ送信できます。

ADB、SSH、組み込みターミナル

FIRERPA には、スタンドアロンの組み込み ADBが含まれています。システムの開発者向けオプションを有効にせずに、ワイヤレスで高権限の ADB を利用できるため、開発者モードを検出するアプリにも便利です。Magisk モジュールを使って adb_keys を事前インストールすれば、デフォルトの認証を設定できます。リモートシェルとファイル転送には、組み込みの SSH と ssh.sh / scp.sh を使用できます。

組み込みターミナルには、strace、ltrace、tcpdump、scapy、fsmon、frida-tools、MemDumper、および Crypto、cv2、unicorn、capstone、keystone、redis、grpc などの Python スタックが含まれています。sqlite3 は wxsqlite / sqlcipher / sqlcrypto に対応しており、WeChat、WeCom、Alibaba 系クライアントなどのアプリが使用する暗号化データベースを読み取れます。リモートデスクトップ、SSH、ADB で同じ環境を使えるため、PC との行き来を減らし、デバイス上で分析と制御を行えます。

分散型・複数デバイス管理

**FIRERPA StarLink Platform（Hub + hub-bridge）**は、ローカルとリモートのデバイスを統合管理し、P2P アクセスにも対応する、一元的な複数デバイスアクセスを提供します。「デバイスは自宅、オペレーターは別の場所」という利用形態や、複数デバイスでの共同作業に最適です。hub v3 は SAPI を使用し、ローカルとリモートのデバイスへのリクエストを統一します。Hub に加え、frp 転送と OpenVPN メッシュもセルフホスト可能な選択肢としてサポートされており、ドキュメントと Docker にも完全対応しています。

9.0 以降は、P2P Bridge のピア接続と組み込みの分散タスクシステムに対応しています。7.50 以降は、ネットワークサブスクリプションサービスが利用可能となり、frp／OpenVPN をセルフホストする必要はありません。クラウドフォンのプール、デバイスファーム、エミュレータクラスター向けに設計されており、デバイスの一括運用、常時稼働、無人運用を実現します。

AI／MCP／エージェント

FIRERPA には、Claude、Cursor などの MCP クライアントと互換性のある streamable-http 対応の MCP サーバー（/mcp/）が含まれており、ツール呼び出し、リソースの読み取り、プロンプト、進捗通知、ログを利用できます。公式の MCP 拡張機能は ~/modules/extension にあります。

組み込みの agent コマンドは、ツール呼び出しに対応する OpenAI 互換 API を通じて、自然言語でデバイスを操作します。vision モードと OpenAI セマンティックタスク実行エンジンも備えています。crontab と組み合わせることで、実機で AI タスクをスケジュール実行できます。

システム制御と拡張機能

160 種類以上の Python APIで、アプリ操作、ファイル入出力、コマンド実行、デバイスの状態、WiFi、プロキシ、OpenVPN、シャットダウン／再起動、サービスログなどに対応します。setprop では、読み取り専用の ro.* プロパティも書き換えられます。設定 API では、明るさや開発者モードなどを調整できます。SELinux のドメイン作成、Permissive モード、きめ細かな許可／拒否にも対応しています。マルチインスタンスアプリ向けの API 一式、権限のサイレントな許可／取り消し、非エクスポートのアクティビティの起動、リソース節約のためのアプリ無効化も可能です。

バイナリパッチ適用（16 進数のワイルドカード、glob パス、ドライラン）に加え、ディスク、バッテリー、CPU、メモリー、ネットワーク入出力のランタイムメトリクスを利用できます。WAV の再生と内部ストレージ API にも対応しています。デバイス上の tflite-runtime は、エッジ推論向けのハードウェアアクセラレーション演算を利用できます。

仮想 Debian 環境では、apt を備えた完全な Debian を実行できます。BPF のコンパイル、OpenSSH のデプロイ、組み込みターミナルの制限を超える任意の Python 依存関係のインストールが可能です。

デプロイ、セキュリティ、ガバナンス

ワンクリック APP（root または Shizuku）、Magisk モジュールによる自動起動、手動展開、ROM への統合でデプロイでき、24 時間 365 日の運用を想定して設計されています。APP はサービス証明書を自動生成できます。Magisk zip にはプロパティ、lamda.pem、adb_keys を同梱できます。INI サービス設定で、ポート、WebUI、証明書、OpenVPN、gproxy、frp、tunnel2、cron、sshd、adb、mdns などを一元管理します。WebUI では視覚的な編集、プレーンテキスト編集、サービスの再読み込みができ、リモートからの設定ファイル読み込みにも対応しています。

root と shell のユーザー識別情報に対応し、arm64、armeabi-v7a、x86、x86_64 をサポートしています。実機、エミュレーター（LDPlayer、Nox など）、Redroid、WSA、AVD、クラウドフォンで動作します。クリーンなアンインストール手段も備えています。API の排他ロックでクライアント間の競合を防ぎます。プライバシーポリシーにより、連絡先、SMS、位置情報などは収集しません。オフラインライセンスにも対応しています。

ツールと進化

6 年以上にわたり継続的に開発されており、Android 14～16 との互換性修正を行っています。また、マルチユーザー対応リモートデスクトップ、標準化されたタッチ API、MCP、Frida のバージョンとステルス性、プロキシの IPv6／UDP、P2P Bridge、分散タスクにも継続して取り組んでいます。

FIRERPA の強みは、単一の機能ではなく、リモートデスクトップ（WebRTC／H.264／マルチユーザー）、UI 自動化（仮想ディスプレイ、Watcher、OCR、画像マッチング、マルチタッチ）、ワンクリックキャプチャ、組み込み Frida、フルスタックのプロキシと VPN／frp／P2P、ADB／SSH／組み込みターミナル、AI MCP／エージェント、システムレベルの制御、仮想 Debian、永続 KV、スクリプト暗号化を、1 台の Android デバイス、1 つのサービス、1 つの Python クライアントに統合している点です。これにより、セキュリティテスト、コンプライアンス分析、プロトコル解析、フリート管理、自動化を、複数のツールをつなぎ合わせるのではなく、1 つのパイプラインで実行できます。