Appllama 사용 스킬은(는) 무엇을 하나요?
Appllama는 수익과 다운로드 정보를 포함한 실제 모바일 앱 화면, 플로우, UI 패턴 라이브러리입니다. MCP는 에이전트의 연구 공간을 제공합니다. 단순한 연구 도구가 아니라 빌더의 도구입니다. 이미 성공한 것을 연구하고 더 나은 것을 구축합니다.
이 스킬은 설계 및 구현 단계마다 appllama-design-skill과 함께 사용하세요. 이 스킬은 무엇을 연구할지 알려주고, 해당 스킬은 어떻게 구축할지 알려줍니다.
기본 규칙 (먼저 읽기)
get_credits로 시작하세요. 무료입니다. 잔액, 한도, 초기화 날짜를 알려줍니다. Pro는 월 1,500 크레딧을 포함하며 (매월 1일 UTC에 전액 초기화), 다른 도구 호출은 크레딧 1개를 소모합니다.- 깊이 파고드세요. 디자인 언어는 전체 여정에 담겨 있습니다. 샘플 하나만 보지 말고 작업에 중요한 앱의 모든 화면과 이미지를 탐색하세요. 이것이 바로 라이브러리의 목적입니다. 이용 약관에 위배되는 유일한 행위는 라이브러리 전체를 수집하여 실제 작업 대신 데이터셋 자체를 추출하는 것입니다. 이는 연구가 아니며 서버 측에서 감지됩니다.
- 미디어 URL은 약 1시간 후에 만료됩니다. 연구하는 내용을 즉시 다운로드/시청하세요. 작업 중간에 링크가 끊어지면 새 링크를 받기 위해 해당 페이지를 다시 요청하세요. 화면 ID는 영구적이지만 링크는 그렇지 않습니다.
- 워터마크는 무시하세요. 모든 Appllama 이미지 및 비디오에는 왼쪽 상단 모서리에 작은 Appllama 워터마크가 있습니다. 이는 출처 표시일 뿐 화면의 일부가 아닙니다. 해당 모서리(상태 표시줄, 뒤로 가기 버튼, 제목)를 읽을 때 왜곡되지 않도록 하세요. 구축하는 어떤 결과물에도 워터마크를 재현하지 마세요.
- 페이지네이션은 순차적입니다. 모든 목록 응답에는
next_cursor가 포함되어 있습니다. 이를 다시 전달하여 계속 탐색하세요. N 페이지로 바로 이동할 수 없으며, 커서는 해당 커서를 발급한 동일한 쿼리에만 작동합니다. 커서에 오류가 발생하면 삭제하고 1페이지부터 다시 시작하세요. - 속도 제한에 걸리면 기다리세요. 분당 및 일일 제한은 실제 연구 범위보다 훨씬 높습니다. 드물게 제한에 걸리면 명시된 시간 동안 기다리세요. 재시도 공세를 하지 마세요.
- 오류는 지침입니다. 도구 오류는 행동을 유도하도록 작성되었습니다 (만료된 커서 → 다시 시작; 크레딧 부족 → 사용자에게 크레딧이 매월 1일에 초기화되며 설정 → 사용량에서 추가를 요청할 수 있음을 알림).
도구 맵
| 도구 | 제공 내용 | 일반적인 사용법 |
|---|---|---|
get_credits | 잔액, 한도, 초기화 날짜. 무료. | 세션 시작 |
search_apps | 페이지당 10개 앱: 이름, 수익, 다운로드, 평점, 출시일, 화면 수, 화면 수가 포함된 플로우 목록. 자연어 query + 필터 (수익/다운로드/평점/출시일/가격/온보딩 단계) + sort + board_id | 카테고리나 요구사항에 맞는 상위 앱 찾기 |
get_app | 하나의 앱 전체 정보: 평점 세부 정보, 카테고리 순위, 인앱 구매 가격, 주요 국가, 플로우 | 앱이 심층 연구할 가치가 있는지 판단 |
list_app_screens | 페이지당 10개 화면 여정 순서대로 (환영 → 온보딩 → 페이월 → 제품), 각 화면에 미디어 URL, 플로우, UI 요소, 색상 포함. flow 또는 section으로 필터 | 앱을 화면별로 탐색 |
search_screens | 라이브러리 전체에서 화면 검색. mode="keyword"는 화면 이름 + 필터 (플로우, screen_type, 요소, app_id) 매칭; mode="semantic"은 의미/시각적 언어로 검색 | 한 화면 유형에 대한 디자인 참고 자료 수집 |
get_screen | 하나의 화면 전체 + 다른 앱의 최대 5개 시각적 유사 화면. screen_ref = app_id/screen_id (appllama.io의 "화면 ID 복사"가 생성하는 형식) 허용 | 사용자가 화면 참조를 붙여넣었거나 하나의 참조를 심층 분석 |
list_flows | 화면/앱 수가 포함된 플로우 분류 체계 | 카테고리에 어떤 플로우가 있는지 발견 |
get_flow_apps | 플로우를 포함하는 앱, 수익이 높은 순서 | 하나의 플로우에 대한 최고의 예시 찾기 |
list_ui_elements | 약 38개의 UI 요소 패밀리와 개수 (한 번 호출) | 요소 수준 연구를 위한 어휘 |
get_element_screens | 요소 패밀리가 포함된 화면 | 성공한 앱이 하나의 컴포넌트를 어떻게 구축하는지 연구 |
list_my_boards | 사용자 자신의 appllama.io 보드 (화면/앱/플로우) | 먼저 큐레이션 확인 |
get_board | 보드의 전체 내용: 미디어가 포함된 화면, 앱 프로필, 또는 (앱, 플로우) 쌍 | 사용자가 작업을 위해 보드를 큐레이션했다면 여기서부터 시작 |
screen_ref 핸드셰이크: 사용자는 appllama.io에서 아무 화면의 "화면 ID 복사"를 클릭하여 붙여넣을 수 있습니다. 1393061654/spl_9i075 같은 형식으로, get_screen(screen_ref=...)에 바로 전달하면 정확히 그 화면과 라이브러리 전체에서 가장 가까운 유사 화면을 볼 수 있습니다.
플레이북
| 시나리오 | 참고 문서 |
|---|---|
| 처음부터 앱 구축 (예: "습관 추적기 만들어줘") | references/build-from-scratch.md |
| 기존 화면 개선 | references/improve-a-screen.md |
| 플로우 및 요소 연구; 일반 연구 방법 | references/research-methods.md |
두 빌드 플레이북 모두 동일한 방식으로 끝납니다: appllama-design-skill의 시뮬레이터 루프를 결함을 찾을 수 없을 때까지 반복합니다. 이 루프 없이는 연구가 장식에 불과합니다.
로컬 참조 보드
연구를 위해 화면을 가져올 때 로컬 작업 구조에 저장하세요. 링크는 약 1시간 후에 만료되지만 노트와 다운로드는 유지됩니다:
research/
<카테고리>/
apps.md # 최종 후보 목록: 지표, 플로우, 평가
<앱-이름>/
screens.md # 화면별 노트: id, 이름, 플로우, 요소, 색상
img/ # 다운로드한 화면, 여정 순서대로
patterns.md # 앱 간 합성: 카테고리의 디자인 언어
연구하면서 화면을 다운로드하세요. 합성은 메타데이터가 아닌 이미지를 나란히 놓고 이루어집니다. 노트와 화면 ID는 영구적입니다. 픽셀이 다시 필요하면 ID에서 새 링크를 다시 가져오세요.