Habilidad de uso de Appllama
Appllama es una biblioteca de aplicaciones móviles de alto rendimiento: sus pantallas reales, flujos y patrones de UI, con contexto de ingresos y descargas. El MCP lo convierte en un laboratorio de investigación para el agente: no solo una herramienta de investigación, una herramienta de constructor. Estudias lo que ya triunfa, luego construyes algo mejor.
Combina esta habilidad con appllama-design-skill en cada paso de diseño/implementación — esta habilidad te dice qué estudiar; la otra te dice cómo construir.
Reglas básicas (léelas primero)
- Empieza con
get_credits— es gratis. Te indica el saldo, los límites y la fecha de reinicio. Pro incluye 1500 créditos al mes (se reinician completamente el día 1, UTC); cualquier otra llamada de herramienta cuesta 1 crédito. - Profundiza. El lenguaje de diseño vive en todo el recorrido, no en una muestra — recorre cada pantalla de las apps que importan para la tarea, incluidas las imágenes. Para eso exactamente sirve la biblioteca. Lo único que va en contra de los términos es la recolección masiva: barrer el catálogo para extraer el conjunto de datos en sí en lugar de responder a una tarea real. Eso no es investigación, y se detecta en el servidor.
- Las URLs de los medios caducan en ~1 hora. Descarga/visualiza lo que estudies de inmediato. Si los enlaces mueren a mitad de la tarea, vuelve a solicitar esa página para obtener unos nuevos — los IDs de pantalla son duraderos, los enlaces no.
- Ignora la marca de agua. Cada imagen y video de Appllama lleva una pequeña marca de agua de Appllama en la esquina superior izquierda. Es procedencia, no parte de la pantalla — no dejes que sesgue tu interpretación de esa esquina (barra de estado, botón de retroceso, título), y nunca la reproduzcas en nada que construyas.
- La paginación es secuencial. Cada respuesta de lista lleva
next_cursor; pásalo de vuelta para continuar. No puedes saltar a la página N — y un cursor solo funciona para la misma consulta que lo creó. Si un cursor da error, descártalo y reinicia desde la página uno. - Si alcanzas un límite de velocidad, espera. Los límites por minuto y por día están muy por encima de la investigación real; en el raro caso de alcanzarlos, espera el tiempo indicado — no insistas con reintentos.
- Los errores son instrucciones. Los errores de las herramientas están escritos para actuar sobre ellos (cursor caducado → reiniciar; sin créditos → informa al usuario que sus créditos se reinician el día 1 y que puede solicitar más en Configuración → Uso).
Mapa de herramientas
| Herramienta | Qué te da | Uso típico |
|---|---|---|
get_credits | Saldo, límites, fecha de reinicio. Gratis. | Inicio de sesión |
search_apps | 10 apps/página: nombre, ingresos, descargas, valoración, fecha de lanzamiento, número de pantallas, lista de flujos con número de pantallas. Consulta en lenguaje natural query + filtros (ingresos/descargas/valoración/fecha de lanzamiento/precio/pasos de onboarding) + sort + board_id | Encontrar las mejores apps para una categoría o necesidad |
get_app | Una app completa: desglose de valoraciones, rango en la categoría, precios de compras integradas, países principales, flujos | Decidir si una app merece un estudio profundo |
list_app_screens | 10 pantallas/página en orden de recorrido (bienvenida → onboarding → muro de pago → producto), cada una con URL de medios, flujo, elementos de UI, colores. Filtra por flow o section | Recorrer una app pantalla por pantalla |
search_screens | Pantallas de toda la biblioteca. mode="keyword" coincide con nombres de pantalla + filtros (flow, screen_type, element, app_id); mode="semantic" busca por significado/lenguaje visual | Recopilar referencias de diseño para un tipo de pantalla |
get_screen | Una pantalla completa + hasta 5 pantallas visualmente similares de otras apps. Acepta screen_ref = app_id/screen_id (lo que produce "Copiar ID de pantalla" en appllama.io) | El usuario ha pegado una referencia de pantalla; o profundizar en una referencia |
list_flows | La taxonomía de flujos con recuentos de pantallas/apps | Descubrir qué flujos existen para una categoría |
get_flow_apps | Apps que contienen un flujo, primero las de mayores ingresos | Encontrar los mejores ejemplos de un flujo |
list_ui_elements | ~38 familias de elementos de UI con recuentos (una sola llamada) | Vocabulario para investigación a nivel de elementos |
get_element_screens | Pantallas que presentan una familia de elementos | Estudiar cómo los ganadores construyen un componente |
list_my_boards | Los tableros propios del miembro en appllama.io (pantallas / apps / flujos) | Encontrar su curación primero |
get_board | El contenido completo de un tablero: pantallas con medios, perfiles de app o pares (app, flujo) | Cuando el miembro ha curado un tablero para la tarea, EMPIEZA desde él |
El apretón de manos screen_ref: los miembros pueden hacer clic en "Copiar ID de pantalla" en cualquier
pantalla de appllama.io y pegártelo. Tiene este aspecto:
1393061654/spl_9i075 — pásalo directamente a
get_screen(screen_ref=...) y estarás viendo exactamente la pantalla que quieren decir,
más sus hermanos más cercanos en toda la biblioteca.
Los manuales
| Escenario | Referencia |
|---|---|
| Construir una app desde cero (ej.: "construye un rastreador de hábitos") | references/build-from-scratch.md |
| Mejorar una pantalla existente | references/improve-a-screen.md |
| Investigación de flujos y elementos; método general de investigación | references/research-methods.md |
Ambos manuales de construcción terminan de la misma manera: el bucle de simulación de appllama-design-skill, repetido hasta que no encuentres un fallo. La investigación sin ese bucle es decoración.
Tableros de referencia locales
Cuando extraigas pantallas para estudiarlas, guárdalas en una estructura de trabajo local — los enlaces caducan en aproximadamente una hora, pero tus notas y descargas no:
research/
<categoría>/
apps.md # la lista corta: métricas, flujos, veredictos
<nombre-app>/
screens.md # notas por pantalla: id, nombre, flujo, elementos, colores
img/ # pantallas descargadas, en orden de recorrido
patterns.md # síntesis entre apps: el lenguaje de diseño de la categoría
Descarga las pantallas a medida que las estudias — la síntesis se realiza con las imágenes una al lado de la otra, no a partir de metadatos. Las notas y los IDs de pantalla son duraderos; vuelve a obtener un enlace nuevo a partir del ID si alguna vez necesitas los píxeles de nuevo.