aso-keyword-researchlisted

# ASO Keyword Research Compute App Store keyword popularity and difficulty scores using the public iTunes Search API (no API key needed). ## Quick Start ```bash # Single keyword python3 scripts/aso_research.py "seed oil" --country us # Batch analysis python3 scripts/aso_research.py --batch "seed oil,allergen,food dye,preservative" --country us ``` ## Output Each keyword returns: - **popularity** (5-100): Estimated search volume based on competitor landscape - **difficulty** (1-100): How hard it is to rank for this keyword - **verdict**: SWEET SPOT / HIGH COMPETITION / HIDDEN GEM / AVOID - **top_5_apps**: Top competing apps with review counts and ratings ## Arthur's Golden Ratio From the ASO Playbook: target keywords with **popularity > 20** and **difficulty < 50**. | Verdict | Popularity | Difficulty | Action | |---------|-----------|------------|--------| | SWEET SPOT | >= 20 | < 50 | Target these | | HIDDEN GEM | < 20 | < 50 | Use if relevant, low volume | | HIGH COMPETITION | >= 20 | >= 50 | Avoid unless you have traction | | AVOID | < 20 | >= 50 | Skip entirely | ## ASO Rules (from Arthur's Playbook) - Never repeat keywords across title, subtitle, and keyword field - Use singular forms only (Apple handles plurals) - Keyword field is 100 characters max, comma-separated - Check both popularity AND revenue of top 5 apps (avoid vanity keywords) - Iterate keywords weekly (scores shift over time) ## Country Codes Common: `us`, `gb`, `de`, `fr`, `br`, `jp`, `kr`, `n