Compétence d'utilisation Appllama
Appllama est une bibliothèque d'applications mobiles les plus rentables — leurs écrans réels, flux et schémas d'interface utilisateur, avec contexte de revenus et de téléchargements. Le MCP en fait un étage de recherche pour l'agent : pas seulement un outil de recherche, un outil de construction. Vous étudiez ce qui gagne déjà, puis vous construisez quelque chose de mieux.
Associez cette compétence avec appllama-design-skill pour chaque étape de conception/réalisation — cette compétence vous dit quoi étudier ; l'autre vous dit comment construire.
Règles de base (à lire en premier)
- Commencez par
get_credits— c'est gratuit. Cela vous indique le solde, les limites et la date de réinitialisation. Pro comprend 1 500 crédits par mois (ils se réinitialisent complètement le 1er, UTC) ; chaque autre appel d'outil coûte 1 crédit. - Allez en profondeur. Le langage de conception vit dans l'ensemble du parcours, pas dans un échantillon — parcourez chaque écran des applications qui comptent pour la tâche, images comprises. C'est exactement à cela que sert la bibliothèque. La seule chose qui est contraire aux conditions d'utilisation est la récolte : parcourir le catalogue pour extraire l'ensemble de données plutôt que pour répondre à une tâche réelle. Ce n'est pas de la recherche, et c'est détecté côté serveur.
- Les URL des médias expirent dans ~1 heure. Téléchargez/visualisez ce que vous étudiez rapidement. Si les liens meurent en cours de tâche, redemandez cette page pour en obtenir de nouveaux — les identifiants d'écran sont durables, les liens ne le sont pas.
- Ignorez le filigrane. Chaque image et vidéo Appllama porte un petit filigrane Appllama dans le coin supérieur gauche. C'est une provenance, pas une partie de l'écran — ne le laissez pas fausser votre lecture de ce coin (barre d'état, bouton retour, titre), et ne le reproduisez jamais dans ce que vous construisez.
- La pagination est séquentielle. Chaque réponse de liste comporte un
next_cursor; renvoyez-le pour continuer. Vous ne pouvez pas sauter à la page N — et un curseur ne fonctionne que pour la même requête qui l'a créé. Si un curseur génère une erreur, abandonnez-le et recommencez à la page un. - Si vous rencontrez une limite de débit, attendez. Les limites par minute et par jour sont bien au-dessus de la recherche réelle ; en cas de rare dépassement, attendez le temps indiqué — ne frappez pas en boucle.
- Les erreurs sont des instructions. Les erreurs d'outil sont écrites pour être exploitées (curseur expiré → recommencer ; crédits épuisés → informer l'utilisateur que ses crédits se réinitialisent le 1er et qu'il peut en demander plus dans Paramètres → Utilisation).
Cartographie des outils
| Outil | Ce qu'il vous donne | Utilisation typique |
|---|---|---|
get_credits | Solde, limites, date de réinitialisation. Gratuit. | Début de session |
search_apps | 10 applications/page : nom, revenus, téléchargements, note, date de lancement, nombre d'écrans, liste des flux avec nombre d'écrans. query en langage naturel + filtres (revenus/téléchargements/note/date de lancement/prix/étapes d'onboarding) + sort + board_id | Trouver les meilleures applications pour une catégorie ou un besoin |
get_app | Une application complète : répartition des notes, classement par catégorie, tarification des achats intégrés, principaux pays, flux | Décider si une application mérite une étude approfondie |
list_app_screens | 10 écrans/page dans l'ordre du parcours (bienvenue → onboarding → paywall → produit), chacun avec URL média, flux, éléments d'interface, couleurs. Filtrer par flow ou section | Parcourir une application écran par écran |
search_screens | Écrans dans toute la bibliothèque. mode="keyword" correspond aux noms d'écran + filtres (flow, screen_type, element, app_id) ; mode="semantic" recherche par sens/langage visuel | Rassembler des références de conception pour un type d'écran |
get_screen | Un écran complet + jusqu'à 5 écrans visuellement similaires d'autres applications. Accepte screen_ref = app_id/screen_id (ce que produit le "Copier l'ID d'écran" d'appllama.io) | L'utilisateur a collé une référence d'écran ; ou approfondir une référence |
list_flows | La taxonomie des flux avec le nombre d'écrans/applications | Découvrir quels flux existent pour une catégorie |
get_flow_apps | Applications contenant un flux, d'abord par revenu le plus élevé | Trouver les meilleurs exemples d'un flux |
list_ui_elements | ~38 familles d'éléments d'interface avec compteurs (un seul appel) | Vocabulaire pour la recherche au niveau des éléments |
get_element_screens | Écrans présentant une famille d'éléments | Étudier comment les gagnants construisent un composant |
list_my_boards | Les propres tableaux appllama.io du membre (écrans / applications / flux) | Trouver d'abord leur curation |
get_board | Le contenu complet d'un tableau : écrans avec médias, profils d'application, ou paires (application, flux) | Lorsque le membre a organisé un tableau pour la tâche, COMMENCEZ par celui-ci |
La poignée de main screen_ref : les membres peuvent cliquer sur "Copier l'ID d'écran" sur n'importe quel
écran sur appllama.io et le coller pour vous. Cela ressemble à
1393061654/spl_9i075 — donnez-le directement à
get_screen(screen_ref=...) et vous regardez exactement l'écran qu'ils
veulent dire, plus ses frères et sœurs les plus proches dans toute la bibliothèque.
Les playbooks
| Scénario | Référence |
|---|---|
| Construire une application de zéro (ex. "construis-moi un tracker d'habitudes") | references/build-from-scratch.md |
| Améliorer un écran existant | references/improve-a-screen.md |
| Recherche de flux et d'éléments ; méthode de recherche générale | references/research-methods.md |
Les deux playbooks de construction se terminent de la même manière : la boucle de simulation de appllama-design-skill, répétée jusqu'à ce que vous ne trouviez aucun défaut. La recherche sans cette boucle n'est que de la décoration.
Tableaux de référence locaux
Lorsque vous extrayez des écrans pour les étudier, enregistrez-les dans une structure de travail locale — les liens expirent dans environ une heure, mais vos notes et téléchargements ne le font pas :
research/
<catégorie>/
apps.md # la shortlist : métriques, flux, verdicts
<nom-application>/
screens.md # notes par écran : id, nom, flux, éléments, couleurs
img/ # écrans téléchargés, dans l'ordre du parcours
patterns.md # synthèse inter-applications : le langage de conception de la catégorie
Téléchargez les écrans au fur et à mesure que vous les étudiez — la synthèse se fait avec les images côte à côte, pas à partir des métadonnées. Les notes et les identifiants d'écran sont durables ; récupérez un nouveau lien à partir de l'identifiant si vous avez à nouveau besoin des pixels.