Metadata-Version: 2.4
Name: fxapk
Version: 0.8.0
Summary: 涉诈 APK / iOS IPA 调证分析 CLI — 静态分析 + 配置键值/服务归属提取，产出调证线索清单
Author: s-silt
License: MIT
Project-URL: Homepage, https://github.com/s-silt/fxapk
Project-URL: Repository, https://github.com/s-silt/fxapk
Project-URL: Issues, https://github.com/s-silt/fxapk/issues
Keywords: android,apk,forensics,fraud,reverse-engineering,security,androguard,调证,反诈
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Environment :: Console
Classifier: Topic :: Security
Classifier: Intended Audience :: Information Technology
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: androguard>=4.1
Requires-Dist: jinja2
Requires-Dist: typer
Requires-Dist: python-whois
Requires-Dist: requests
Requires-Dist: pyyaml
Requires-Dist: psutil
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: ruff; extra == "dev"
Requires-Dist: pyright; extra == "dev"
Provides-Extra: graph
Requires-Dist: kuzu==0.11.3; extra == "graph"
Provides-Extra: track
Requires-Dist: flask; extra == "track"
Dynamic: license-file

# fxapk

[![CI](https://github.com/s-silt/fxapk/actions/workflows/ci.yml/badge.svg)](https://github.com/s-silt/fxapk/actions/workflows/ci.yml)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue.svg)](https://www.python.org/)

*CLI 命令 `fxapk`（保留 `apkscan` 别名）· PyPI 包名 `fxapk`* · **English**: [README.en.md](README.en.md)

APK / iOS IPA **静态 + 动态分析 CLI**：抠出应用真实配置（AppID / AppKey / 渠道号 / uni-app 应用 ID 等）、网络端点、第三方组件与加固指纹，对域名 / IP 做归属富化，输出**结构化 HTML / JSON 报告**，并可跨样本关联聚类。

`pip install` 即可跑核心分析，**零环境**（不需要 JDK / 模拟器 / 真机）。加固样本的脱壳、抓包是可选的真机步骤。

## 安装

要求 **Python 3.11+**。

```bash
pip install fxapk

# 或从源码
git clone https://github.com/s-silt/fxapk.git && cd fxapk && pip install -e .
```

动态脱壳 / 抓包、关系图谱、网页看板等能力按需安装可选依赖；缺失时对应命令给出提示，核心分析不受影响。

## 用法

```bash
# 静态分析，产出 HTML + JSON 到 out/
fxapk analyze app.apk --out out

# 一键全自动（接好 root 真机 / 模拟器）：体检 → 静态 → 脱壳 → 抓包 → 合并一份报告
fxapk auto app.apk --out out       # 无设备则自动跳过动态步骤，仍产出静态报告
```

主要命令：`analyze`（静态）、`auto`（一键）、`doctor`（设备环境体检 + 自动修）、`graph`（跨样本关联聚类）、`track`（本地网页跟进线索）。完整命令与参数见 `fxapk --help`。

未安装为命令时用 `python -m apkscan.cli <…>` 等价调用。

## 输出

- `out/report.html` —— 自包含单文件报告（可直接分享 / 手机打开）
- `out/report.json` —— 完整结构化数据（机器读 / 二次处理）
- `--fmt pdf` 可选导出 PDF（需本机 Chrome / Edge）

![报告示例](docs/images/report-demo.png)

## 合规边界

仅用于**授权范围内**的安全研究与分析，只做静态 / 动态分析与信息提取，**不提供任何针对第三方的攻击 / 漏洞利用 / 主动探测能力**。境外服务器只做被动归属（RDAP / WHOIS / DNS / ASN / 证书透明度），对目标零主动流量；脱壳仅对**样本自身**在自备授权环境的分析机上运行时进行。请在合法授权范围内使用。

## License

[MIT](LICENSE)
