claude-code-aso-skill MCP — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

4 specialized agents (aso-master, aso-research, aso-optimizer, aso-strategist)
Real iTunes API integration for competitor and keyword research
Character validation: Apple (30/30/100), Google (50/80/4000)
47-item pre-launch validation checklist
4 slash commands: full audit, optimization-only, pre-launch, competitive analysis

Demo ao vivo

Como fica na prática

claude-code-aso-skill.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "claude-code-aso-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/alirezarezvani/claude-code-aso-skill",
        "~/.claude/skills/claude-code-aso-skill"
      ],
      "_inferred": true
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "claude-code-aso-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/alirezarezvani/claude-code-aso-skill",
        "~/.claude/skills/claude-code-aso-skill"
      ],
      "_inferred": true
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "claude-code-aso-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/alirezarezvani/claude-code-aso-skill",
        "~/.claude/skills/claude-code-aso-skill"
      ],
      "_inferred": true
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "claude-code-aso-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/alirezarezvani/claude-code-aso-skill",
        "~/.claude/skills/claude-code-aso-skill"
      ],
      "_inferred": true
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "claude-code-aso-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/alirezarezvani/claude-code-aso-skill",
        "~/.claude/skills/claude-code-aso-skill"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "claude-code-aso-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/alirezarezvani/claude-code-aso-skill",
          "~/.claude/skills/claude-code-aso-skill"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add claude-code-aso-skill -- git clone https://github.com/alirezarezvani/claude-code-aso-skill ~/.claude/skills/claude-code-aso-skill

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: claude-code-aso-skill

Generate a complete ASO asset pack before app store submission

👤 Indie developers and small studios launching a new app ⏱ ~60 min intermediate

Quando usar: You're 2 weeks from submission and need titles, keywords, descriptions, and screenshots captions.

Pré-requisitos

App concept and category — A 1-paragraph description and the App Store category

Fluxo

Run the pre-launch command

/aso pre-launch — my app is a focus timer for developers, category Productivity.✓ Copiado

→ aso-research scans similar apps via iTunes API; aso-optimizer drafts metadata
Review and iterate

Title feels too generic — give me 5 alternatives that include 'Pomodoro' without keyword stuffing.✓ Copiado

→ Variants within char limits
Walk the 47-item checklist

Run the launch checklist.✓ Copiado

→ Pass/fail per item with fixes

Resultado: A submission-ready ASO asset pack plus a checked-off launch list.

Armadilhas

Keyword stuffing triggers store rejection — aso-optimizer flags this; trust the warnings

Combine com: claude-ads-skill

Analyze the top 10 competitors in your category

👤 PMs and founders positioning against incumbents ⏱ ~30 min intermediate

Quando usar: You want to understand how competitors describe themselves before writing your own copy.

Fluxo

Run competitive analysis

/aso competitive in category 'Productivity' — top 10.✓ Copiado

→ Real iTunes data on title, subtitle, keywords, rating patterns
Find the positioning gap

Where are all 10 saying the same thing? What's the whitespace?✓ Copiado

→ Concrete positioning angle

Resultado: A differentiated positioning statement backed by live data.

Armadilhas

Top 10 may be dominated by one big player — skewed signal — Filter by category refinement or include mid-tail apps

Optimize metadata for an existing app that's underperforming

👤 App owners with a live app and stagnant downloads ⏱ ~30 min intermediate

Quando usar: Your app has been live 6+ months and ranking has plateaued.

Fluxo

Run optimization

/aso optimize — my app is MyApp, current metadata [paste].✓ Copiado

→ Suggestions grounded in current top-ranking apps for the keyword set
A/B plan

Which changes should I A/B test first, and in what order?✓ Copiado

→ Prioritized test roadmap

Resultado: A testing roadmap to improve rank.

Armadilhas

Too many concurrent changes make attribution impossible — Skill recommends one variable at a time

Combinações

Combine com outros MCPs para 10× de alavancagem

claude-code-aso-skill + claude-ads-skill

Align ASO keywords with paid-ads keyword strategy

Take the ASO keyword list and have claude-ads plan a UA campaign around the same terms.✓ Copiado

claude-code-aso-skill + nano-banana-pro-prompts-recommend-skill

Generate App Store screenshot-caption image prompts

For each screenshot caption the ASO skill suggests, recommend a visual prompt via nano-banana.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
/aso full-audit	app concept or URL	New app or comprehensive review	Tokens + iTunes API (free)
/aso optimize	current metadata	Refreshing an existing app	Tokens
/aso pre-launch	concept + category	Before submission	Tokens
/aso competitive	category or competitor list	Positioning work	Tokens + iTunes API

Custo e limites

O que custa rodar

Cota de API: iTunes Search API is free, generous limits
Tokens por chamada: 5-15k per command
Monetário: Free — skill is local
Dica: Run full-audit once, then use optimize + competitive periodically.

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: No credentials — iTunes Search API is unauthenticated

Saída de dados: iTunes Search API only

Solução de problemas

Erros comuns e correções

iTunes API returns empty for a known app

Check the bundleID or the country code; country defaults to US.

Suggested title exceeds 30 chars

The optimizer should catch this; if not, re-run with explicit '30 char max' reminder.

Slash commands not recognized

Ensure the skill is cloned into ~/.claude/skills/ and Claude Code is restarted.

Verificar: ls ~/.claude/skills/claude-code-aso-skill/commands/

Alternativas

claude-code-aso-skill vs. outros

Alternativa	Quando usar	Troca
AppTweak / Sensor Tower (paid)	You need deeper keyword volume data and can pay	Better data, real cost
claude-ads-skill	You're focused on paid UA rather than organic ASO	Different funnel stage

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills