Androidアプリの中身を丸裸に！APKからAPI情報を自動抽出するClaude Codeスキル — android-reverse-engineering-skill

アーキテクチャ・仕組み

android-reverse-engineering-skillはClaude Codeのプラグインとして動作し、以下の5フェーズで処理を行います：

1. 依存関係チェック — jadx、Java JDKなどが正しくインストールされているか確認
2. 逆コンパイル — APK/XAPK/JAR/AARファイルをソースコードに変換
3. 構造分析 — AndroidManifest、パッケージ構成、アーキテクチャパターンの解析
4. API抽出 — Retrofit、OkHttp、ハードコードURL、認証ヘッダー・トークンの検出
5. コールフロー追跡 — Activity/FragmentからViewModel、Repositoryを経てHTTP呼び出しに至るまでの流れを追跡

対応ファイル形式

• APK — Androidアプリのインストールパッケージ
• XAPK — 複数APKを含むバンドル形式（自動的に展開して各APKを逆コンパイル）
• JAR — Javaライブラリ
• AAR — Androidライブラリ

逆コンパイルエンジン

--engine bothオプションで2つのエンジンの出力を並べて比較可能。

API検出パターン

find-api-calls.shスクリプトで以下のパターンを検出：

• Retrofitアノテーション: @GET, @POST, @PUT, @DELETEなどのエンドポイント定義
• OkHttpクライアント呼び出し: OkHttpClient, Request.Builderの使用箇所
• ハードコードURL: ソースコード内に直接記述されたURLやベースURL
• 認証パターン: Authorizationヘッダー、Bearerトークン、APIキー

# Retrofit関連のみ抽出
bash scripts/find-api-calls.sh output/sources/ --retrofit

# URL関連のみ抽出
bash scripts/find-api-calls.sh output/sources/ --urls

難読化対応

ProGuard/R8で難読化されたコードに対しても解析戦略を提供。--deobfオプションで難読化マッピングを活用した逆コンパイルが可能。

利用方法

• スラッシュコマンド: /decompile path/to/app.apk
• 自然言語指示: 「Decompile this APK」「Extract API endpoints from this app」「Follow the call flow from LoginActivity」など
• スタンドアロンスクリプト: check-deps.sh, install-dep.sh, decompile.sh, find-api-calls.shを個別に実行可能

対応環境

• Java JDK 17以上が必要
• install-dep.shはOSとパッケージマネージャを自動検出して依存関係をインストール

ライセンス・利用条件

• ライセンス: Apache 2.0（商用利用可）
• 法的注意: セキュリティ研究、認可されたペネトレーションテスト、相互運用性分析（EU指令2009/24/EC、米国DMCA §1201(f)準拠）、マルウェア分析、教育目的での使用を想定。許可なく他者のソフトウェアを逆コンパイルすることは法律に抵触する可能性あり。

Claude Code内からのインストール（推奨）

/plugin marketplace add SimoneAvogadro/android-reverse-engineering-skill
/plugin install android-reverse-engineering@android-reverse-engineering-skill

ローカルクローンからのインストール

git clone https://github.com/SimoneAvogadro/android-reverse-engineering-skill.git

Claude Code内で以下を実行：

/plugin marketplace add /path/to/android-reverse-engineering-skill
/plugin install android-reverse-engineering@android-reverse-engineering-skill

前提条件

• 必須: Java JDK 17以上、jadx（CLI）
• 推奨: Vineflower または Fernflower、dex2jar