● 社区
furkancingoz
⚡ 即开即用
aso-skill
作者 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.
为什么要用
核心特性
- 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
使用场景
实战用法: aso-skill
何时使用: Conversion rate on your product page is flat and you want a data-driven refresh.
步骤
-
Run competitor analysis
Use aso-skill to pull the top 10 competitors for 'habit tracker' in the US store. Compare their subtitles and keywords.✓ 已复制
→ 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.✓ 已复制
→ 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.✓ 已复制
→ Version draft created; ready for manual review
结果: A refreshed listing with a data-grounded story, submitted without clicking through ASC.
注意事项
- Keyword stuffing beyond the 100-char field — Skill validates, but double-check — stuffing kills relevance
何时使用: You have an IPA ready and want everything else automated.
前置条件
- IPA uploaded to App Store Connect — xcode or Transporter
步骤
-
Generate metadata + legal
Generate metadata and auto-draft privacy policy + terms for a meditation app targeting EN/DE/FR.✓ 已复制
→ 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.✓ 已复制
→ PNG set at correct resolutions
-
Submit for review
Attach the build, upload screenshots, submit for review with a phased 7-day rollout.✓ 已复制
→ Version status: Waiting For Review
结果: App in review without opening ASC manually.
注意事项
- Screenshot text violates store guidelines — Ask the skill to keep screenshot text minimal and within safe areas
何时使用: Every quarter or when competitors shift their keyword strategy.
步骤
-
Diff keyword sets vs last quarter
Compare this quarter's competitor keyword cluster against last quarter's. What's new?✓ 已复制
→ Added / dropped keywords
-
Propose updates
Propose a keyword update — keep my wins, capture 2–3 new opportunities.✓ 已复制
→ Revised 100-char keyword field
结果: Live keyword edit that reflects reality, not 6-month-old research.
组合
与其他 MCP 搭配,撬动十倍杠杆
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.✓ 已复制
Commit the metadata and screenshots to repo for version control
Write metadata to fastlane/metadata and commit with the version tag.✓ 已复制
成本与限制
运行它的成本
- API 配额
- iTunes Search API: free, lightly rate-limited. App Store Connect: per-account quota.
- 每次调用 Token 数
- Large for screenshot generation; moderate otherwise
- 费用
- Free skill; Gemini usage is separate
- 提示
- Cache competitor data locally for a quarter — it doesn't change hourly
安全
权限、密钥、影响范围
最小权限: App Store Connect: App Manager on one app (prefer) over admin
凭据存储: JWT .p8 key stored locally; reference via path in env, never check into git
数据出站: iTunes API (public), Apple ASC API, Gemini MCP if screenshots enabled
切勿授予: 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.
故障排查
常见错误与修复
ASC 401
JWT expired (max 20min) — regenerate; check issuer id and key id are correct
验证: 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
替代方案
aso-skill 对比其他方案
| 替代方案 | 何时用它替代 | 权衡 |
| 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 |