Skill de Uso do Appllama
Appllama é uma biblioteca de aplicativos móveis de alto faturamento — suas telas reais, fluxos e padrões de UI, com contexto de receita e downloads. O MCP o torna um piso de pesquisa para o agente: não apenas uma ferramenta de pesquisa, uma ferramenta de construtor. Você estuda o que já vence, depois constrói algo melhor.
Combine este skill com o appllama-design-skill para cada etapa de design/implementação — este skill diz o que estudar; aquele diz como construir.
Regras básicas (leia primeiro)
- Comece com
get_credits— é gratuito. Informa o saldo, limites e data de redefinição. O Pro inclui 1.500 créditos por mês (eles são redefinidos integralmente no dia 1, UTC); cada outra chamada de ferramenta custa 1 crédito. - Vá fundo. A linguagem de design vive em toda a jornada, não em uma amostra — percorra cada tela dos aplicativos que importam para a tarefa, imagens incluídas. É exatamente para isso que a biblioteca serve. A única coisa contra os termos é a coleta: varrer o catálogo para extrair o próprio conjunto de dados em vez de responder a uma tarefa real. Isso não é pesquisa e é detectado no lado do servidor.
- URLs de mídia expiram em ~1 hora. Baixe/visualize o que estuda prontamente. Se os links morrerem no meio da tarefa, solicite novamente aquela página para obter novos — os IDs de tela são duráveis, os links não são.
- Ignore a marca d'água. Toda imagem e vídeo do Appllama carrega uma pequena marca d'água do Appllama no canto superior esquerdo. É proveniência, não parte da tela — não deixe que distorça sua leitura daquele canto (barra de status, botão voltar, título) e nunca a reproduza em nada que você construir.
- A paginação é sequencial. Toda resposta de lista carrega
next_cursor; passe-o de volta para continuar. Você não pode pular para a página N — e um cursor só funciona para a mesma consulta que o criou. Se um cursor gerar erro, descarte-o e recomece da página um. - Se você atingir um limite de taxa, espere. Os limites por minuto e por dia estão muito acima da pesquisa real; na rara ocorrência, aguarde o tempo informado — não tente novamente repetidamente.
- Erros são instruções. Erros de ferramenta são escritos para serem agidos (cursor expirado → recomece; sem créditos → informe ao usuário que seus créditos são redefinidos no dia 1 e ele pode solicitar mais em Configurações → Uso).
Mapa de ferramentas
| Ferramenta | O que fornece | Uso típico |
|---|---|---|
get_credits | Saldo, limites, data de redefinição. Gratuito. | Início de sessão |
search_apps | 10 aplicativos/página: nome, receita, downloads, avaliação, data de lançamento, contagem de telas, lista de fluxos com contagens de telas. query em linguagem natural + filtros (receita/downloads/avaliação/data de lançamento/preço/etapas de integração) + sort + board_id | Encontrar os principais aplicativos para uma categoria ou necessidade |
get_app | Um aplicativo completo: detalhamento de avaliações, classificação da categoria, preços de compras no aplicativo, principais países, fluxos | Decidir se um aplicativo merece um estudo aprofundado |
list_app_screens | 10 telas/página em ordem de jornada (boas-vindas → integração → paywall → produto), cada uma com URL de mídia, fluxo, elementos de UI, cores. Filtrar por flow ou section | Percorrer um aplicativo tela por tela |
search_screens | Telas em toda a biblioteca. mode="keyword" corresponde a nomes de tela + filtros (flow, screen_type, element, app_id); mode="semantic" pesquisa por significado/linguagem visual | Reunir referências de design para um tipo de tela |
get_screen | Uma tela completa + até 5 telas visualmente semelhantes de outros aplicativos. Aceita screen_ref = app_id/screen_id (o que o "Copiar ID da Tela" do appllama.io produz) | O usuário colou uma referência de tela; ou aprofunde-se em uma referência |
list_flows | A taxonomia de fluxos com contagens de telas/aplicativos | Descobrir quais fluxos existem para uma categoria |
get_flow_apps | Aplicativos contendo um fluxo, primeiro os de maior receita | Encontrar os melhores exemplos de um fluxo |
list_ui_elements | ~38 famílias de elementos de UI com contagens (uma chamada) | Vocabulário para pesquisa em nível de elemento |
get_element_screens | Telas apresentando uma família de elementos | Estudar como os vencedores constroem um componente |
list_my_boards | Os próprios quadros do membro no appllama.io (telas / aplicativos / fluxos) | Encontrar sua curadoria primeiro |
get_board | O conteúdo completo de um quadro: telas com mídia, perfis de aplicativos ou pares (aplicativo, fluxo) | Quando o membro selecionou um quadro para a tarefa, COMECE por ele |
O handshake screen_ref: os membros podem clicar em "Copiar ID da Tela" em qualquer
tela no appllama.io e colá-lo para você. Parece com
1393061654/spl_9i075 — alimente-o diretamente no
get_screen(screen_ref=...) e você estará olhando exatamente para a tela que eles
querem dizer, além de seus irmãos mais próximos em toda a biblioteca.
Os playbooks
| Cenário | Referência |
|---|---|
| Construir um aplicativo do zero (por exemplo, "crie um rastreador de hábitos para mim") | references/build-from-scratch.md |
| Melhorar uma tela existente | references/improve-a-screen.md |
| Pesquisa de fluxo e elemento; método de pesquisa geral | references/research-methods.md |
Ambos os playbooks de construção terminam da mesma maneira: o loop do simulador do appllama-design-skill, repetido até que você não encontre uma falha. Pesquisa sem esse loop é decoração.
Quadros de referência locais
Ao buscar telas para estudo, salve-as em uma estrutura de trabalho local — os links expiram em cerca de uma hora, mas suas anotações e downloads não:
research/
<categoria>/
apps.md # a lista final: métricas, fluxos, veredictos
<nome-do-app>/
screens.md # anotações por tela: id, nome, fluxo, elementos, cores
img/ # telas baixadas, em ordem de jornada
patterns.md # síntese entre aplicativos: a linguagem de design da categoria
Baixe as telas conforme as estuda — a síntese acontece com as imagens lado a lado, não a partir de metadados. Anotações e IDs de tela são duráveis; recupere um novo link a partir do ID se precisar dos pixels novamente.