● 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
- Generación de metadatos + validación de límites de caracteres
- Análisis de competencia desde la iTunes API gratuita
- Generación de capturas de pantalla con IA mediante Gemini MCP
- API directo de App Store Connect mediante JWT — sin clics en la interfaz web
- Control de implementación gradual
- Política de privacidad + términos generados automáticamente
Demo en vivo
Cómo se ve en la práctica
Casos de uso
Usos del mundo real: aso-skill
Cuándo usarlo: La tasa de conversión en tu página de producto es plana y deseas una actualización basada en datos.
Flujo
-
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
-
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
-
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
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
-
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
-
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
-
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
Cuándo usarlo: Cada trimestre o cuando los competidores cambian su estrategia de palabras clave.
Flujo
-
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
-
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
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
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
- Un .p8 filtrado da acceso completo de escritura a tus apps — rota si alguna vez lo confirmas.
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
| Alternativa | Cuándo usarla | Contrapartida |
|---|
| claude-code-aso-skill | Deseas el marco de informes ASO basado en agentes | Integración directa de ASC menos directa |
| Fastlane deliver | Ya tienes un pipeline de Fastlane | Sin borrador automático de metadatos con IA |