---
name: analyze-mobile-app
description: "Mobile App Competitive Analyzer. Automated competitive analysis of Android mobile apps via ADB. Navigate the app, capture screenshots, document UX/UI, generate complete reports. Use when: analyzing competitor apps, exploring app UX, mobile app analysis, competitive research."
---
# Mobile App Competitive Analyzer
Analisi competitiva automatizzata di app mobile Android via ADB. Naviga l'app, cattura screenshot, documenta UX/UI, genera report completi.
## Trigger
- "analizza app [nome]"
- "competitor analysis [app]"
- "esplora UX di [app]"
- "analisi competitiva [app]"
- /analyze-mobile-app
## Config
```yaml
adb_path: D:\Software\Android\Sdk\platform-tools\adb.exe
screenshot_format: "{app}_{seq:02d}.png"
output_structure:
- docs/{APP}_ANALYSIS.md
- docs/{APP}_REPORT.html
- docs/{APP}_USER_FLOWS.md
- img/*.png
```
## Workflow
### 1. SETUP
```bash
# Verifica connessione
adb devices
# Output: emulator-5554 device
# Info device
adb shell wm size
# Package app corrente
adb shell dumpsys window | grep mCurrentFocus
```
### 2. LOOP PRINCIPALE (ripetere per ogni schermata)
```bash
# A) Screenshot
adb exec-out screencap -p > {app}_{seq:02d}.png
# B) Analizza screenshot visivamente (Read tool)
# C) UI dump per coordinate
adb shell uiautomator dump /sdcard/ui.xml
adb shell cat /sdcard/ui.xml
# D) Trova bounds: [left,top][right,bottom]
# E) Calcola centro: x=(left+right)/2, y=(top+bottom)/2
# F) Tap
adb shell input tap X Y
# G) Ripeti da A)
```
### 3. COMANDI NAVIGAZIONE
```bash
adb shell input tap X Y # Tap
adb shell input swipe 540 1500 540 500 300 # Scroll down
adb shell input swipe 540 500 540 1500 300 # Scroll up
adb shell input swipe 900 1000 100 1000 300 # Swipe left
adb shell input swipe 100 1000 900 1000 300 # Swipe right
adb shell input swipe X Y X Y 1000 # Long press
adb shell input keyevent 4 # Back
adb shell input keyevent 3 # Home
adb shell input keyevent 66 # Enter
adb shell input text "testo" # Type
```
## Analisi
### Visual Design
- Colori (hex), tipografia, spaziature, icone, illustrazioni, brand
### UX Patterns
- Navigazione, gerarchia info, CTA, form, onboarding, stati vuoti/errore
### Psicologia
- Social proof, scarcity, commitment, gamification, loss aversion
### Business Model
- Paywall type, pricing, free vs premium, upsell timing
## Report Templates
### ANALYSIS.md
```markdown
# {APP} - Competitive Analysis
> Date: {DATE} | Version: {VERSION} | Method: ADB + UI inspection
## Executive Summary
| Metric | Value |
|--------|-------|
| Onboarding screens | {N} |
| Input methods | {N} |
| Price (annual) | {PRICE} |
## Company Profile
| Attribute | Value |
|-----------|-------|
| Company | {NAME} |
| HQ | {LOCATION} |
| Founded | {YEAR} |
## Target Market
### Segment A ({PCT}%)
- Profile: {PROFILE}
- Motivation: {MOTIVATION}
## Onboarding Flow
| Stage | Screens | Purpose |
|-------|---------|---------|
## Psychology
- Social Proof: {DESC}
- Gamification: {DESC}
## Pricing
| Plan | Price |
|------|-------|
| Monthly | {PRICE} |
| Annual | {PRICE} |
## Design System
```css
--primary: {HEX};
--accent: {HEX};
--radius: {PX};
```
## Navigation
| Tab | Function |
|-----|----------|
## Features
| Feature | Free | Premium |
|---------|------|---------|
## Recommendations
1. {REC}
## Screenshot Index
| File | Content |
|------|---------|
| {app}_01.png | {DESC} |
```
### USER_FLOWS.md
```markdown
# {APP} - User Flows
## Navigation
\`\`\`mermaid
flowchart TD
TAB1[Tab 1] --> CONTENT1
TAB2[Tab 2] --> CONTENT2
\`\`\`
## Onboarding
\`\`\`mermaid
flowchart TD
START([Launch]) --> WELCOME
WELCOME --> QUESTIONS
QUESTIONS --> PAYWALL
PAYWALL --> HOME([Home])
\`\`\`
## Core Feature
\`\`\`mermaid
flowchart TD
HOME --> ADD[+]
ADD --> METHOD1
ADD --> METHOD2
METHOD1 --> RESULT
RESULT --> SAVE --> HOME
\`\`\`
```
### REPORT.html
```html
{APP} - Analisi Competitiva
```
## Checklist
- [ ] Onboarding completo
- [ ] Tutti i tab esplorati
- [ ] Settings catturati
- [ ] Paywall documentato
- [ ] Input methods testati
- [ ] User flows creati
- [ ] Design tokens estratti
- [ ] Psicologia analizzata
- [ ] Business model mappato
- [ ] Raccomandazioni scritte
- [ ] ZIP creato
## Troubleshooting
```bash
# No device
adb kill-server && adb start-server && adb devices
# UI dump fail
adb shell uiautomator dump /data/local/tmp/ui.xml
adb shell cat /data/local/tmp/ui.xml
# Screenshot nero
adb shell screencap -p /sdcard/s.png && adb pull /sdcard/s.png
# Tap non funziona
# → Ricalcola coordinate da UI dump fresco
# → Verifica clickable="true"
# → Aggiungi sleep 1 prima
```
## PowerShell Helpers
```powershell
$ADB="D:\Software\Android\Sdk\platform-tools\adb.exe"
function ss($p){& $ADB exec-out screencap -p|Set-Content $p -Enc Byte}
function ui{& $ADB shell uiautomator dump /sdcard/ui.xml;& $ADB shell cat /sdcard/ui.xml}
function tap($x,$y){& $ADB shell input tap $x $y}
function sd{& $ADB shell input swipe 540 1500 540 500 300}
function su{& $ADB shell input swipe 540 500 540 1500 300}
function bk{& $ADB shell input keyevent 4}
```
## Example
```
User: Analizza Yazio
Agent:
1. adb devices → emulator-5554 ✓
2. ss "yazio_01.png" → splash
3. ui → "Get Started" [100,1800][980,1900]
4. tap 540 1850
5. ss "yazio_02.png" → goal selection
... [50+ screens] ...
6. Genera YAZIO_ANALYSIS.md
7. Genera YAZIO_REPORT.html
8. Genera YAZIO_USER_FLOWS.md
9. ZIP → Desktop
```
