/ Directorio / Playground / aso-skill
● Comunidad furkancingoz ⚡ Instantáneo

aso-skill

por furkancingoz · furkancingoz/aso-skill

Optimización completa de App Store desde Claude Code: metadatos + análisis de competencia + capturas de pantalla + envío directo a App Store Connect mediante JWT.

Seis comandos que cubren todo el ciclo ASO: generación de metadatos con validación de caracteres, análisis de competencia mediante iTunes API, capturas de pantalla generadas con IA (Gemini MCP), envío mediante App Store Connect API (JWT), gestión de versiones y términos legales generados automáticamente (privacidad, términos). Elimina los clics en la interfaz web para envíos de iOS.

Por qué usarlo

Características clave

Demo en vivo

Cómo se ve en la práctica

aso-skill.replay ▶ listo
0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "aso-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/furkancingoz/aso-skill",
        "~/.claude/skills/aso-skill"
      ],
      "_inferred": true
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "aso-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/furkancingoz/aso-skill",
        "~/.claude/skills/aso-skill"
      ],
      "_inferred": true
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "aso-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/furkancingoz/aso-skill",
        "~/.claude/skills/aso-skill"
      ],
      "_inferred": true
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "aso-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/furkancingoz/aso-skill",
        "~/.claude/skills/aso-skill"
      ],
      "_inferred": true
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

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

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json
{
  "context_servers": {
    "aso-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/furkancingoz/aso-skill",
          "~/.claude/skills/aso-skill"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

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

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: aso-skill

Optimiza un listado existente de App Store en una sesión

👤 Desarrolladores indie de iOS cuya tasa de instalación se estancó ⏱ ~60 min intermediate

Cuándo usarlo: La tasa de conversión en tu página de producto es plana y deseas una actualización basada en datos.

Requisitos previos
  • Clave API de App Store Connect (JWT) — App Store Connect -> Users and Access -> Integrations -> crear clave; descargar .p8
  • Skill instalada — git clone https://github.com/furkancingoz/aso-skill ~/.claude/skills/aso-skill
Flujo
  1. Ejecuta análisis de competencia
    Usa aso-skill para obtener los 10 mejores competidores de 'habit tracker' en la tienda estadounidense. Compara sus subtítulos y palabras clave.✓ Copiado
    → Tabla de comparación con grupos de palabras clave ponderados por frecuencia
  2. Genera metadatos optimizados
    Ahora genera un nuevo título, subtítulo, lista de palabras clave y texto promocional para mi app. Valida los límites de caracteres.✓ Copiado
    → Campos dentro del límite, clasificados por impacto estimado
  3. Envía mediante API de ASC
    Sube los nuevos metadatos a App Store Connect como una nueva versión pendiente de envío.✓ Copiado
    → Borrador de versión creado; listo para revisión manual

Resultado: Un listado actualizado con una historia basada en datos, enviado sin hacer clic en ASC.

Errores comunes
  • Relleno de palabras clave más allá del campo de 100 caracteres — Skill valida, pero verifica dos veces — el relleno mata la relevancia
Combinar con: github

Envía una nueva app de iOS de extremo a extremo

👤 Desarrolladores en solitario que envían por primera vez ⏱ ~180 min advanced

Cuándo usarlo: Tienes un IPA listo y deseas automatizar todo lo demás.

Requisitos previos
  • IPA subido a App Store Connect — xcode o Transporter
Flujo
  1. Genera metadatos + términos legales
    Genera metadatos y términos de privacidad + términos automáticos para una app de meditación dirigida a EN/DE/FR.✓ Copiado
    → Metadatos localizados + URLs de términos legales alojados
  2. Genera capturas de pantalla
    Usa aso-skill + Gemini MCP para generar 5 capturas de pantalla de App Store por idioma que coincidan con la identidad visual de la app.✓ Copiado
    → Conjunto PNG a resoluciones correctas
  3. Envía para revisión
    Adjunta el build, sube las capturas de pantalla, envía para revisión con un rollout gradual de 7 días.✓ Copiado
    → Estado de versión: Esperando Revisión

Resultado: App en revisión sin abrir ASC manualmente.

Errores comunes
  • El texto de la captura de pantalla viola las directrices de la tienda — Pídele a la skill que mantenga el texto de la captura de pantalla mínimo y dentro de áreas seguras

Actualización trimestral de palabras clave basada en cambios de competencia

👤 Especialistas en crecimiento en apps en directo ⏱ ~30 min intermediate

Cuándo usarlo: Cada trimestre o cuando los competidores cambian su estrategia de palabras clave.

Flujo
  1. Compara conjuntos de palabras clave vs trimestre pasado
    Compara el clúster de palabras clave de competencia de este trimestre con el del trimestre pasado. ¿Qué hay de nuevo?✓ Copiado
    → Palabras clave agregadas / eliminadas
  2. Propone actualizaciones
    Propón una actualización de palabras clave — mantén mis ganancias, captura 2–3 nuevas oportunidades.✓ Copiado
    → Campo de palabras clave revisado de 100 caracteres

Resultado: Edición de palabras clave en directo que refleja la realidad, no investigación de hace 6 meses.

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

Usa la capa de informes de la otra skill ASO sobre la capa de ejecución de esta

Después de que aso-skill envíe, usa los informes de claude-code-aso-skill para resumir los cambios.✓ Copiado
aso-skill + github

Confirma los metadatos y capturas de pantalla en el repositorio para control de versiones

Escribe metadatos en fastlane/metadata y confirma con la etiqueta de versión.✓ Copiado

Herramientas

Lo que expone este MCP

HerramientaEntradasCuándo llamarCoste
competitor_analysis término de búsqueda, país Fase de investigación 0 (iTunes API gratuita)
generate_metadata perfil de app, palabras clave objetivo Borrador 0
generate_screenshots identidad de app, tamaños de dispositivo Preparación de recursos cuota de Gemini MCP
generate_legal perfil de app, jurisdicciones Antes del envío 0
asc_submit versión, metadatos, capturas de pantalla, build Envío final llamadas API de ASC

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API
iTunes Search API: gratuita, limitada levemente. App Store Connect: cuota por cuenta.
Tokens por llamada
Grande para generación de capturas de pantalla; moderado de otro modo
Monetario
Skill gratuita; el uso de Gemini es aparte
Consejo
Almacena datos de competencia localmente para un trimestre — no cambian cada hora

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: App Store Connect: Gestor de App en una app (preferido) en lugar de admin
Almacenamiento de credenciales: Clave JWT .p8 almacenada localmente; referencia mediante ruta en env, nunca confirmes en git
Salida de datos: iTunes API (pública), API de Apple ASC, Gemini MCP si las capturas de pantalla están habilitadas
No conceder nunca: Rol de Titular de Cuenta a la clave utilizada por la skill

Resolución de problemas

Errores comunes y soluciones

ASC 401

JWT expirado (máx 20min) — regenera; verifica que el id del emisor y el id de la clave sean correctos

Verificar: curl with the JWT against https://api.appstoreconnect.apple.com/v1/apps
Campo de metadatos rechazado por límite de caracteres

La validación de la skill se perdió la localización — valida por idioma

Resolución incorrecta de capturas de pantalla

Especifica la lista de dispositivos explícitamente; los tamaños requeridos de Apple cambian

Alternativas

aso-skill vs otros

AlternativaCuándo usarlaContrapartida
claude-code-aso-skillDeseas el marco de informes ASO basado en agentesIntegración directa de ASC menos directa
Fastlane deliverYa tienes un pipeline de FastlaneSin borrador automático de metadatos con IA

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills