● Communauté
furkancingoz
⚡ Instantané
aso-skill
par furkancingoz · furkancingoz/aso-skill
End-to-end App Store Optimization from Claude Code: metadata + competitor analysis + screenshots + direct App Store Connect submission via JWT.
Six commands covering ASO lifecycle: metadata generation with character validation, competitor analysis via iTunes API, AI-generated screenshots (Gemini MCP), App Store Connect API submission (JWT), version management, and auto-generated legal (privacy, terms). Eliminates web interface clicking for iOS submissions.
Pourquoi l'utiliser
Fonctionnalités clés
- Metadata generation + character limit validation
- Competitor analysis from the free iTunes API
- AI screenshot generation via Gemini MCP
- Direct App Store Connect API via JWT — no web UI clicking
- Phased rollout control
- Auto-generated privacy policy + terms
Démo en direct
Aperçu en pratique
Cas d'usage
Usages concrets : aso-skill
Quand l'utiliser : Conversion rate on your product page is flat and you want a data-driven refresh.
Déroulement
-
Run competitor analysis
Use aso-skill to pull the top 10 competitors for 'habit tracker' in the US store. Compare their subtitles and keywords.✓ Copié
→ Comparison table with frequency-weighted keyword clusters
-
Generate optimized metadata
Now generate a new title, subtitle, keyword list, and promotional text for my app. Validate character limits.✓ Copié
→ Fields under limit, ranked by estimated impact
-
Submit via ASC API
Push the new metadata to App Store Connect as a new version pending submission.✓ Copié
→ Version draft created; ready for manual review
Résultat : A refreshed listing with a data-grounded story, submitted without clicking through ASC.
Pièges
- Keyword stuffing beyond the 100-char field — Skill validates, but double-check — stuffing kills relevance
Quand l'utiliser : You have an IPA ready and want everything else automated.
Prérequis
- IPA uploaded to App Store Connect — xcode or Transporter
Déroulement
-
Generate metadata + legal
Generate metadata and auto-draft privacy policy + terms for a meditation app targeting EN/DE/FR.✓ Copié
→ Localized metadata + hosted legal URLs
-
Generate screenshots
Use aso-skill + Gemini MCP to generate 5 App Store screenshots per locale matching the app's visual identity.✓ Copié
→ PNG set at correct resolutions
-
Submit for review
Attach the build, upload screenshots, submit for review with a phased 7-day rollout.✓ Copié
→ Version status: Waiting For Review
Résultat : App in review without opening ASC manually.
Pièges
- Screenshot text violates store guidelines — Ask the skill to keep screenshot text minimal and within safe areas
Quand l'utiliser : Every quarter or when competitors shift their keyword strategy.
Déroulement
-
Diff keyword sets vs last quarter
Compare this quarter's competitor keyword cluster against last quarter's. What's new?✓ Copié
→ Added / dropped keywords
-
Propose updates
Propose a keyword update — keep my wins, capture 2–3 new opportunities.✓ Copié
→ Revised 100-char keyword field
Résultat : Live keyword edit that reflects reality, not 6-month-old research.
Combinaisons
Associez-le à d'autres MCPs pour un effet X10
Use the other ASO skill's reporting layer over this one's execution layer
After aso-skill submits, use claude-code-aso-skill reporting to summarize the changes.✓ Copié
Commit the metadata and screenshots to repo for version control
Write metadata to fastlane/metadata and commit with the version tag.✓ Copié
Coût et limites
Coût d'exécution
- Quota d'API
- iTunes Search API: free, lightly rate-limited. App Store Connect: per-account quota.
- Tokens par appel
- Large for screenshot generation; moderate otherwise
- Monétaire
- Free skill; Gemini usage is separate
- Astuce
- Cache competitor data locally for a quarter — it doesn't change hourly
Sécurité
Permissions, secrets, portée
Portées minimales : App Store Connect: App Manager on one app (prefer) over admin
Stockage des identifiants : JWT .p8 key stored locally; reference via path in env, never check into git
Sortie de données : iTunes API (public), Apple ASC API, Gemini MCP if screenshots enabled
Ne jamais accorder : Account Holder role to the key used by the skill
- A leaked .p8 gives full write on your apps — rotate if you ever commit it.
Dépannage
Erreurs courantes et correctifs
ASC 401
JWT expired (max 20min) — regenerate; check issuer id and key id are correct
Vérifier : curl with the JWT against https://api.appstoreconnect.apple.com/v1/apps
Metadata field rejected for character limit
Skill validation missed localization — validate per-locale
Screenshots wrong resolution
Specify device list explicitly; Apple's required sizes change
Alternatives
aso-skill vs autres
| Alternative | Quand l'utiliser | Compromis |
| claude-code-aso-skill | You want the agent-based ASO reporting framework | Less direct ASC integration |
| Fastlane deliver | You already have a Fastlane pipeline | No AI metadata drafting |