Metadata-Version: 2.4
Name: app-sdk-finder
Version: 1.0.0
Summary: CLI tool to find SDKs used by iOS/Android apps via AppGoblin
Project-URL: Homepage, https://github.com/ProAlexUSC/app-sdk-finder
Project-URL: Repository, https://github.com/ProAlexUSC/app-sdk-finder
Project-URL: Issues, https://github.com/ProAlexUSC/app-sdk-finder/issues
Author: proalex
License-Expression: MIT
License-File: LICENSE
Keywords: android,appgoblin,ios,mobile,sdk
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.11
Requires-Dist: beautifulsoup4>=4.12
Requires-Dist: google-play-scraper>=1.2
Requires-Dist: httpx>=0.27
Requires-Dist: rich>=13
Requires-Dist: typer>=0.9
Description-Content-Type: text/markdown

# app-sdk-finder

[![PyPI version](https://badge.fury.io/py/app-sdk-finder.svg)](https://pypi.org/project/app-sdk-finder/)
[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

CLI tool to find SDKs used by iOS/Android apps via [AppGoblin](https://appgoblin.info). Query 6M+ apps' SDK data, compare tech stacks, and rank SDKs by popularity.

## Install

```bash
pip install app-sdk-finder

# Or run without installing
uvx app-sdk-finder --help
```

## Quick Start

```bash
# Search for an app
app-sdk-finder search "bereal" --platform ios

# See what SDKs it uses
app-sdk-finder get-sdk 1459645446 --platform ios

# Compare two apps
app-sdk-finder compare 835599320 1459645446 --platform ios

# Rank SDKs by popularity
app-sdk-finder list-sdks rank product-analytics --platform ios
```

## Commands

| Command | Description |
|---------|-------------|
| `search <name>` | Search apps by name (iOS & Android) |
| `get-sdk <store_id>` | Get SDKs used by an app |
| `get-sdk <store_id> --detail` | Get detailed SDK data (frameworks, bundles, permissions) |
| `compare <id1> <id2>` | Compare SDKs between two apps |
| `info <store_id>` | Get app metrics (installs, revenue, MAU) |
| `who-uses <domain>` | Find which apps use a specific SDK |
| `list-sdks` | Browse SDK companies by category |
| `list-sdks rank <category>` | Rank SDKs by app adoption |

### Search apps

```bash
app-sdk-finder search "bereal" --platform ios
app-sdk-finder search "whatsapp" --platform android --json
```

### Get SDK list

```bash
# Company-level overview
app-sdk-finder get-sdk 1459645446 --platform ios

# Detailed: framework names, bundles, permissions
app-sdk-finder get-sdk 1459645446 --platform ios --detail
```

### Compare two apps

```bash
app-sdk-finder compare 835599320 1459645446 --platform ios
```

### App info

```bash
app-sdk-finder info 835599320 --platform ios
```

### Which apps use a specific SDK

```bash
app-sdk-finder who-uses amplitude.com
app-sdk-finder who-uses firebase.google.com --platform ios
```

### Browse and rank SDKs

```bash
# List all SDKs in a category
app-sdk-finder list-sdks --category product-analytics

# Rank by popularity
app-sdk-finder list-sdks rank product-analytics --platform ios
```

**Categories:** `ad-networks`, `ad-attribution`, `product-analytics`, `development-tools`, `business-tools`, `mediation`

## Output Formats

All commands support `--json` for machine-readable output:

```bash
app-sdk-finder get-sdk 1459645446 --platform ios --json
```

Default output uses rich tables for terminal readability.

## Store IDs

- **iOS**: numeric trackId (e.g. `835599320` for TikTok)
- **Android**: package name (e.g. `com.bereal.ft`)

Use `search` to find the store ID, then pass it to other commands.

## Claude Code Skill

A [Claude Code](https://claude.ai/code) skill is included in `skills/app-sdk-finder/` that enables Claude to automatically call this CLI to answer SDK-related questions.

## Development

```bash
# Clone and install
git clone https://github.com/ProAlexUSC/app-sdk-finder.git
cd app-sdk-finder
uv sync

# Run tests
uv run pytest tests/ -v

# Run locally
uv run app-sdk-finder --help
```

## License

MIT
