Appllama Nutzungs-Skill
Appllama ist eine Bibliothek der umsatzstärksten mobilen Apps – ihre echten Bildschirme, Abläufe und UI-Muster, mit Umsatz- und Download-Kontext. Der MCP macht es zu einer Recherche-Etage für Agenten: nicht nur ein Recherche-Tool, sondern ein Baumeister-Tool. Du studierst, was bereits erfolgreich ist, und baust dann etwas Besseres.
Kombiniere diesen Skill mit appllama-design-skill bei jedem Design-/Implementierungs- Schritt – dieser Skill sagt dir, was du studieren sollst; der andere sagt dir, wie du baust.
Grundregeln (zuerst lesen)
- Beginne mit
get_credits– es ist kostenlos. Es zeigt dir das Guthaben, Limits und das Zurücksetzungsdatum. Pro beinhaltet 1.500 Credits pro Monat (sie werden am- vollständig zurückgesetzt, UTC); jeder andere Tool-Aufruf kostet 1 Credit.
- Gehe in die Tiefe. Die Designsprache lebt in der gesamten Reise, nicht in einer Stichprobe – durchlaufe jeden Bildschirm der für die Aufgabe relevanten Apps, inklusive Bilder. Genau dafür ist die Bibliothek da. Das Einzige, was gegen die Bedingungen verstößt, ist das Abschöpfen: das Durchsuchen des Katalogs, um den Datensatz selbst zu extrahieren, anstatt eine reale Aufgabe zu beantworten. Das ist keine Recherche und wird serverseitig erkannt.
- Media-URLs laufen in ~1 Stunde ab. Lade herunter / betrachte, was du studierst, zeitnah. Wenn Links während der Aufgabe ablaufen, fordere die Seite erneut an, um frische zu erhalten – Bildschirm-IDs sind dauerhaft, Links nicht.
- Ignoriere das Wasserzeichen. Jedes Appllama-Bild und -Video trägt ein kleines Appllama-Wasserzeichen in der oberen linken Ecke. Es ist ein Herkunftsnachweis, kein Teil des Bildschirms – lass dich nicht davon beeinflussen, wie du diese Ecke liest (Statusleiste, Zurück-Button, Titel), und reproduziere es niemals in dem, was du baust.
- Die Paginierung ist sequenziell. Jede Listenantwort enthält
next_cursor; gib es zurück, um fortzufahren. Du kannst nicht zu Seite N springen – und ein Cursor funktioniert nur für dieselbe Abfrage, die ihn erstellt hat. Wenn ein Cursor einen Fehler verursacht, verwerfe ihn und beginne erneut ab Seite eins. - Wenn du auf eine Ratenbegrenzung stößt, warte sie ab. Die Limits pro Minute und pro Tag liegen weit über realer Recherche; bei dem seltenen Treffer warte die angegebene Zeit ab – nicht erneut hämmern.
- Fehler sind Anweisungen. Tool-Fehler sind geschrieben, um darauf zu reagieren (abgelaufener Cursor → neu beginnen; keine Credits mehr → dem Benutzer mitteilen, dass seine Credits am 1. zurückgesetzt werden und er unter Einstellungen → Nutzung weitere anfordern kann).
Tool-Übersicht
| Tool | Was es dir gibt | Typische Verwendung |
|---|---|---|
get_credits | Guthaben, Limits, Zurücksetzungsdatum. Kostenlos. | Sitzungsstart |
search_apps | 10 Apps/Seite: Name, Umsatz, Downloads, Bewertung, Startdatum, Bildschirm-Anzahl, Ablauf-Liste mit Bildschirm-Anzahl. Natürlichsprachliche query + Filter (Umsatz/Downloads/Bewertung/Startdatum/Preis/Onboarding-Schritte) + sort + board_id | Finde die Top-Apps für eine Kategorie oder einen Bedarf |
get_app | Eine App vollständig: Bewertungsaufschlüsselung, Kategorierang, IAP-Preise, Top-Länder, Abläufe | Entscheide, ob eine App ein tiefes Studium verdient |
list_app_screens | 10 Bildschirme/Seite in Reise-Reihenfolge (Willkommen → Onboarding → Paywall → Produkt), jeweils mit Media-URL, Ablauf, UI-Elementen, Farben. Filtere nach flow oder section | Durchlaufe eine App Bildschirm für Bildschirm |
search_screens | Bildschirme in der gesamten Bibliothek. mode="keyword" matcht Bildschirmnamen + Filter (flow, screen_type, element, app_id); mode="semantic" sucht nach Bedeutung/visueller Sprache | Sammle Design-Referenzen für einen Bildschirmtyp |
get_screen | Ein Bildschirm vollständig + bis zu 5 visuell ähnliche Bildschirme aus anderen Apps. Akzeptiert screen_ref = app_id/screen_id (was appllama.io's "Bildschirm-ID kopieren" erzeugt) | Der Benutzer hat eine Bildschirmreferenz eingefügt; oder in eine Referenz eintauchen |
list_flows | Die Ablauf-Taxonomie mit Bildschirm-/App-Anzahl | Entdecke, welche Abläufe für eine Kategorie existieren |
get_flow_apps | Apps, die einen Ablauf enthalten, zuerst der höchste Umsatz | Finde die besten Beispiele für einen Ablauf |
list_ui_elements | ~38 UI-Element-Familien mit Anzahl (ein Aufruf) | Vokabular für elementbezogene Recherche |
get_element_screens | Bildschirme mit einer Element-Familie | Studiere, wie Gewinner eine Komponente bauen |
list_my_boards | Die eigenen appllama.io-Boards des Mitglieds (Bildschirme / Apps / Abläufe) | Finde zuerst ihre Kuratierung |
get_board | Der vollständige Inhalt eines Boards: Bildschirme mit Medien, App-Profile oder (App, Ablauf)-Paare | Wenn das Mitglied ein Board für die Aufgabe kuratiert hat, STARTE damit |
Der screen_ref-Handshake: Mitglieder können auf jedem Bildschirm auf appllama.io auf "Bildschirm-ID kopieren" klicken und ihn dir einfügen. Er sieht aus wie
1393061654/spl_9i075 – gib ihn direkt an
get_screen(screen_ref=...) weiter und du siehst genau den Bildschirm, den sie
meinen, plus seine nächsten Geschwister in der gesamten Bibliothek.
Die Playbooks
| Szenario | Referenz |
|---|---|
| Eine App von Grund auf neu bauen (z.B. "baue mir einen Gewohnheitstracker") | references/build-from-scratch.md |
| Einen bestehenden Bildschirm verbessern | references/improve-a-screen.md |
| Ablauf- & Element-Recherche; allgemeine Forschungsmethode | references/research-methods.md |
Beide Bau-Playbooks enden auf die gleiche Weise: der Simulator-Loop aus appllama-design-skill, wiederholt, bis du keinen Fehler mehr finden kannst. Recherche ohne diesen Loop ist nur Dekoration.
Lokale Referenz-Boards
Wenn du Bildschirme zum Studieren abrufst, speichere sie in einer lokalen Arbeitsstruktur – Links laufen in etwa einer Stunde ab, aber deine Notizen und Downloads nicht:
research/
<kategorie>/
apps.md # die Shortlist: Metriken, Abläufe, Urteile
<app-name>/
screens.md # Notizen pro Bildschirm: id, name, flow, elemente, farben
img/ # heruntergeladene Bildschirme, in Reise-Reihenfolge
patterns.md # appübergreifende Synthese: die Designsprache der Kategorie
Lade die Bildschirme herunter, während du sie studierst – die Synthese geschieht mit den Bildern Seite an Seite, nicht aus Metadaten. Notizen und Bildschirm-IDs sind dauerhaft; hole einen frischen Link aus der ID, falls du die Pixel jemals wieder brauchst.