lamda

# **FIRERPA Android** ｜ AI駆動の自動化

<img src="https://raw.githubusercontent.com/firerpa/lamda/HEAD/image/logo.svg" alt="FIRERPA" width="200" align="right" />

<p>
<img src="https://img.shields.io/badge/python-3.6+-blue.svg?logo=python&amp;labelColor=yellow" />
<img src="https://img.shields.io/badge/android-6.0+-blue.svg?logo=android&amp;labelColor=white" />
<img src="https://img.shields.io/badge/root/non--root--mode-green.svg?logo=android&amp;labelColor=black" />
<img src="https://img.shields.io/badge/Built--in%20MCP-000.svg?logo=anthropic&amp;labelColor=black" />
</p>

<h6>オンデバイスサービス、AI対応エージェント、拡張可能なツール呼び出しを組み合わせたオールインワンのAndroid自動化フレームワーク。</h6>

<p align="left"><a href="https://device-farm.com/docs/en/">ドキュメント</a> | <a href="https://device-farm.com/docs/zh/">使用文档</a> | <a href="https://device-farm.com/contact#telegram">テレグラム</a> | <a href="https://device-farm.com/contact#QQ">QQグループ</a> | <a href="https://github.com/firerpa/skills">スキル</a> | <a href="https://device-farm.com/llms-full.txt">llms-full.txt</a> | <a href="https://github.com/firerpa/lamda/blob/10/README.zh.md">中文版本</a></p>

FIRERPAは**オールインワンのAndroidデバイス制御プラットフォーム**です。サーバーはデバイス上で直接動作し、**追加のランタイム依存関係は不要**です。**複数のAndroid世代をサポート**し、**rootあり/なし**の両方で動作します。PC側では、PythonクライアントライブラリがUI自動化、リモート操作、トラフィックキャプチャ、フックベースのリバースエンジニアリング、ネットワークプロキシ、分散ネットワーキング、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でセレクタと自動化ロジックを検証でき、画面からスクリプトまでのループを短縮します。

<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/7312/251d9eed35540aadebab75dec6f3a59aaeb7c4b5f93ee39e8f74dcb8b0cfa68d.gif" alt="demo" width="100%">
</p>

リモートデスクトップとRPCは**エンドツーエンドTLS**とサービス証明書によるアクセス制御をサポートし、オプションのカスタムWebUIログインパスワードによりパブリックネットワークでの露出を低減します。リモートデスクトップ機能は、WebSocketを介して独自のWebアプリに埋め込むこともできます（ライブビデオ、タッチ、ターミナル、キーなど）。クロスオリジン統合用の`allow_origin`を備えており、実デバイス制御の製品化に適しています。

## UI自動化

FIRERPAは完全なセレクタベースの自動化システムを提供します：テキスト、resourceId、description、scrollableなどの一般的なマッチャーに加え、重複要素、深い階層、または特徴的な属性がないコントロールのための**子/兄弟**チェーン。要素レベルでは：スクリーンショット、出現/消失待機、コーナー/センター座標、存在確認、Unicode入力、ステップスワイプ、フリングスクロール、スクロールエンドなど。Android 8.0+では**他のアクセシビリティサービスと共存**でき、ハイブリッドアプリ向けのWebViewノード発見が改善されています。

**UI Watcher**はUIの変更をリアルタイムで監視し、条件が一致したときにクリック、キーイベント、またはカウンターを実行します。契約の自動却下、アップデートプロンプト、広告、その他の割り込みに役立ちます。複数のセレクタ条件とイベントごとの有効/無効がサポートされており、過渡的な画面をカウントできます。

**バーチャルディスプレイ**は差別化要素です：デバイス上に分離されたバックグラウンドディスプレイを作成し、**メイン画面に影響を与えずに**アプリと自動化を実行できます。例えば、通常通り電話を使用しながらバーチャルディスプレイで自動返信を行えます。バーチャルディスプレイAPIはメインデバイスAPIをミラーリングします（`d.xxx` → `vd.xxx`）。Watcherはバーチャルディスプレイにスコープを設定できます。WebUIはリモートデスクトップでの**マルチディスプレイ表示と切り替え**をサポートしており、バックグラウンドタスク、並行作業、ヒューマンインザループとマシン自動化の組み合わせに最適です。

標準のビューツリーがないシーン（ゲーム、カスタム描画UI）では、FIRERPAは**OCR**と**画像マッチング**を提供します。OCRはpaddleocr、easyocr、カスタムHTTPバックエンドをサポートします。クラスターでは、すべてのPCにモデルをロードする代わりに、認識を集中実行でき、GPUアクセラレーションと柔軟なテキストマッチングを備えています。画像マッチングは**デバイス上**で実行され（テンプレートまたはSIFT）、PCリソースを消費しません。SIFTは回転、スケール、照明に対して堅牢です。**マルチタッチ**は、複雑なジェスチャーと圧力のための録画、リプレイ、プログラムによる構築、バイナリ永続化をサポートします。

アーキテクチャ的には、FIRERPAはクライアント/サーバーモデルを使用しており、AutoJSのようなオンデバイススクリプトランナーよりも**集中スケジューリング、バージョン管理、フリート制御**に優れています。Appiumよりも軽量で、**マルチデバイスシナリオではuiautomator2よりも安定**しています。ドキュメントでは、一般的なAndroid自動化スタックの**機能スーパーセット**として位置付けられており、自動化、キャプチャ、フック、運用をツールを切り替えることなく一つのプラットフォームでコード連鎖できます。

## パケットキャプチャ＆MITM

FIRERPAは**ワンクリックMITMキャプチャ**を提供します：システムルートCAの自動インストール、プロキシ設定、Androidバージョンの違いの処理、終了時の自動ネットワーク復元。手動での証明書やプロキシの切り替えは不要です。グローバルキャプチャ、パッケージごとのキャプチャ、ライブリクエスト/レスポンス編集、共有mitmweb、**国際トラフィック**のためのアップストリームHTTPプロキシをサポートしています。内蔵の**QUICダウングレード**によりQUICの干渉を低減します。PCとデバイスが単一のFIRERPAポートのみを共有する場合（例：ADB接続やfrp転送）でもキャプチャは機能します。

ワンクリックスクリプトを超えて、MITMは完全に**API駆動**です：mitmproxy、Fiddler、Charlesなどと互換性のあるシステムCAのインストール/アンインストール。UI手順やFridaフックと並行して自動化パイプラインにキャプチャを組み込むことができます。Windows用の**startmitm.exe**がPythonインストールなしで利用可能です。

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

デバイス上で、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フリート検出のためのオプションのTXTメタデータ（モデル、ABI、デバイスID）があります。

## Frida＆リバースエンジニアリング

FIRERPAは**最新のFridaをバンドル**しています。別個のfrida-serverは不要です。リモートデスクトップターミナルから`-U`や`-H`などを使用せずにfridaツールを使用できます。内蔵の隠蔽パッチ（オープンソース＋社内製）が検出対策として維持されています。接続はFIRERPAポートを介したトークン認証を使用します。objectionパッチとFrida 17.x java-bridgeヘルパーが移行を容易にします。

**永続Fridaスクリプト**はアプリのクラッシュまたは終了後に再注入されます。ディレクトリ監視とホットリロードによるYAMLオフライン永続化。Frida RPCは**Pythonメソッド**および**HTTP + JSON-RPC 2.0**リモートコールにマッピングされ、JVM、UIメイン、または純粋なJSスレッドで実行されます。スクリプトの`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は、WeChat、WeCom、Alibaba系クライアントなどのアプリからの暗号化データベースを読み取るための**wxsqlite / sqlcipher / sqlcrypto**をサポートします。リモートデスクトップ、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は**streamable-http**上に**MCPサーバー**（`/mcp/`）を含み、ツール呼び出し、リソース読み取り、プロンプト、進行通知、ログを提供します。**Claude、Cursor**、その他のMCPクライアントと互換性があります。公式のMCP拡張機能は`~/modules/extension`にあります。

内蔵の**`agent`コマンド**は、**ビジョン**モードを含むツール呼び出しを備えた任意のOpenAI互換APIを介して**自然言語**でデバイスを操作し、さらに**OpenAIセマンティックタスク実行**を行います。**crontab**と組み合わせて、実デバイスでスケジュールされたAIタスクを実行できます。

<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/7312/92639519cee4c07efbe1da1030a4107808841995e15962977a1364f22df70248.gif" alt="MCP" width="100%">
</p>

## システム制御＆拡張機能

**160以上のPython API**がアプリ操作、ファイルI/O、コマンド実行、デバイスステータス、WiFi、プロキシ、OpenVPN、シャットダウン/再起動、サービスのログなどをカバーします。`setprop`は**`ro.*`**読み取り専用プロパティを書き込めます。設定APIは明るさ、開発者モードなどを調整します。**SELinux**ドメイン作成、許容モード、きめ細かい許可/不許可。完全なマルチインスタンスアプリAPI、サイレント権限付与/取り消し、エクスポートされていないアクティビティの起動、リソース節約のためのアプリ無効化。

**バイナリパッチ**（16進ワイルドカード、グロブパス、ドライラン）とディスク、バッテリー、CPU、メモリ、ネットワークI/Oのランタイムメトリクス。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およびシェルID。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つのパイプライン**で実行されます。