@appfigures/cli

Appfigures CLI — 터미널에서 앱 지표, 리뷰, 스토어 데이터를 조회하세요.

설치 없이 바로 사용해 보세요:

npx @appfigures/cli auth login
npx @appfigures/cli apps search "youtube"

설치

npm install -g @appfigures/cli

Node.js 22+가 필요합니다. pnpm 및 yarn에서도 작동합니다.

Related MCP server: asc-mcp

빠른 시작

appfigures auth login
appfigures --help

af 별칭으로도 사용할 수 있습니다.

인증

• 직접 로그인. af auth login --interactive는 가이드 흐름에 따라 브라우저를 엽니다. 승인하고 코드를 다시 붙여넣으세요.

• 또는 에이전트가 안내하도록 하세요. 기본적으로 af auth login은 인증 URL을 출력합니다. 해당 URL을 열고 승인한 다음 표시된 코드로 af auth login --code <code>를 실행하여 마무리하세요. 에이전트가 이 과정을 처음부터 끝까지 수행할 수 있습니다. 무인 사용의 경우 대신 APPFIGURES_API_KEY를 설정하세요. appfigures.com/developers/keys에서 Create a New Client를 클릭한 다음 Create Personal Access Token을 클릭하여 토큰을 생성하세요.

두 로그인 방식 모두 OS 자격 증명 관리자(macOS Keychain, Windows Credential Manager, Linux Secret Service)에 토큰을 저장합니다. APPFIGURES_API_KEY 및 기타 재정의에 대한 자세한 내용은 환경을 참조하세요.

MCP 서버

af mcp는 stdio를 통해 로컬 Model Context Protocol 서버를 실행하여 CLI의 앱 인텔리전스 명령을 MCP 도구로 노출합니다. 모든 MCP 클라이언트(Claude Code, Claude Desktop, Cursor 등)에서 이 서버를 가리키면 에이전트가 앱 지표, 리뷰, 스토어 데이터를 직접 조회할 수 있습니다.

클라이언트의 MCP 구성에 추가하세요:

{
	"mcpServers": {
		"appfigures": {
			"command": "npx",
			"args": ["-y", "@appfigures/cli", "mcp"]
		}
	}
}

서버는 저장된 자격 증명으로 로그인하므로 먼저 af auth login을 한 번 실행하세요. 헤드리스 설정의 경우 클라이언트의 env를 통해 토큰을 전달하세요:

{
	"mcpServers": {
		"appfigures": {
			"command": "npx",
			"args": ["-y", "@appfigures/cli", "mcp"],
			"env": { "APPFIGURES_API_KEY": "<your-token>" }
		}
	}
}

npx로 실행하는 대신 CLI를 전역으로 설치했나요? "args": ["mcp"]와 함께 "command": "af"를 사용하세요.

Claude Code. 다음 한 줄 명령으로 추가하세요:

claude mcp add appfigures -- npx -y @appfigures/cli mcp

먼저 af auth login을 실행하여 로그인하거나, 헤드리스 설정을 위해 --env APPFIGURES_API_KEY=<your-token>을 추가하세요.

명령어

앱

앱을 찾고 앱의 식별 정보를 조회합니다. 다른 명령은 이러한 명령이 반환하는 앱 ID를 사용합니다.

탐색기(Explorer)

전체 앱 카탈로그를 검색하고 분석합니다: Apple, Google Play, Amazon 및 기타 주요 스토어의 수백만 개 제품에 대해 아이덴티티, 스토어프런트 및 국가별 제공 여부, 평점, 출시일, 차트 순위, 다운로드 및 수익 추정치, SDK 존재 여부, 인구 통계, 관련 앱 등을 아우르는 120개 이상의 필드가 있습니다.

지표

차원에 따른 숫자 데이터셋을 조회합니다.

앱 스토어

앱 스토어 존재감: 리스팅 콘텐츠, 카테고리 순위, 차트입니다.

오디언스

앱 사용자가 누구인지, 그리고 그들이 사용하는 다른 앱이 무엇인지에 대한 정보입니다. 추정 연령 및 성별과 다른 앱과의 오디언스 중복을 다룹니다.

리뷰

iOS 및 Google Play 앱 스토어 리뷰를 검색, 요약, 답변합니다.

키워드

유기적 검색(App Store, Google Play) 및 Apple Ads 전반의 키워드 가시성, 순위 추적, 발견 기능입니다.

Apple Ads

Apple Ads 캠페인, 광고 그룹, 키워드 및 실적을 관리합니다.

Sdks

추적 중인 SDK를 조회합니다.

Docs

특정 작업과 일반적인 태스크에 대한 참조 문서 및 가이드입니다.

API

MCP

Auth

af <command> --help를 실행하면 인수, 플래그, 예시를 확인할 수 있습니다.

환경

API 참조

모든 명령과 전체 인수 및 플래그 목록입니다. 한 줄 요약은 위의 명령을 참조하세요.

전역 플래그. 모든 명령에서 사용할 수 있습니다:

• -v, --verbose — HTTP 요청을 stderr에 기록합니다. AF_VERBOSE=1로도 설정할 수 있습니다.

• -V, --version — CLI 버전을 출력하고 종료합니다.

• -h, --help — 현재 명령의 사용법을 표시합니다.

출력 형식. 모든 명령은 stdout에 단일 JSON 값을 출력합니다. 필터링하려면 jq로 파이프하세요. 정보 메시지, 힌트, 업데이트 알림은 stderr로 전달되어 파이프라인이 깨끗하게 유지됩니다.

af apps search

af apps search <q> [flags]

이름 또는 게시자로 앱을 찾습니다. 통합 앱별로 한 행씩 반환합니다. 기본적으로 Apple 및 Google 목록을 반환하며, 다른 스토어프론트를 포함하려면 --all-stores를 전달하세요. 추정 값으로 앱을 필터링하려면(예: 지난달 다운로드 10만 건 초과 앱) explorer list-products를 사용하세요. 시간, 국가 또는 스토어프론트별 추정치가 필요하면 datasets estimates.sales 또는 estimates.revenue와 함께 metrics query를 사용하세요.

옵션

• <q> 필수 문자열. 검색어(앱 이름 또는 게시자).

• --all-stores 불리언, 기본값 false. Apple 및 Google 외 스토어프론트 포함: Amazon, Windows, Steam, Roku, LG TV, Samsung TV 등.

• --count 정수, 기본값 10. 반환할 결과 수.

• --page 정수, 기본값 1. 페이지 번호.

예시

# Find every Electronic Arts app.
af apps search 'electronic arts'

# Page through long results.
af apps search 'electronic arts' --count=25 --page=2

# Find Minecraft on every storefront (e.g. Amazon, Steam, Windows, Roku; not common).
af apps search minecraft --all-stores

af apps tracked

af apps tracked [flags]

Appfigures 계정이 추적하는 앱 목록을 표시합니다.

옵션

• --count 정수, 기본값 10. 반환할 결과 수.

• --page 정수, 기본값 1. 페이지 번호.

• --q 문자열. 필터링할 앱 이름.

• --filter-apps-by-id (정수 또는 문자열)[]. 제품 ID 또는 통합 앱 ID로 특정 앱에 대한 데이터만 포함합니다. 설정 시 다른 filterAppsBy* 키보다 우선합니다. 스토어프론트, 소스 또는 유형 필터는 해당 기준으로 설명할 수 있는 앱 집합에 더 적합합니다.

• --filter-apps-by-storefront 문자열[]. 계정의 추적 앱을 해당 스토어프론트의 앱으로 좁힙니다(예: apple:ios, google_play).

• --filter-apps-by-source 문자열[]. 추적 관계별로 계정의 추적 앱을 좁힙니다.

• --filter-apps-by-type 문자열[]. 계정의 추적 앱을 해당 유형의 제품으로 좁힙니다.

예시

# List your apps with private-data access.
af apps tracked --filter-apps-by-source=own,shared

# List your tracked fitness apps.
af apps tracked --q=fitness

# List just your iOS apps.
af apps tracked --filter-apps-by-storefront=apple:ios

# Page through long results.
af apps tracked --filter-apps-by-source=own,shared --count=50 --page=2

# List tracked competitors.
af apps tracked --filter-apps-by-source=manual

# Find individual IAPs or subscriptions (not common).
af apps tracked --filter-apps-by-type=inapp,subscription

af apps get

af apps get <app-id> [flags]

앱의 레코드를 가져옵니다: 기본 메타데이터(이름, 개발자 등)와, 사용자가 추적 중인 경우 접근 가능한 데이터를 표시합니다. 한 스토어프론트의 제품 ID를 전달하거나, 모든 스토어프론트를 함께 보려면 통합 앱 ID를 전달하세요.

옵션

• <app-id> 필수 정수 또는 문자열. 앱의 통합 앱 ID 또는 제품 ID.

• --all-stores 불리언, 기본값 false. 통합 앱 ID의 경우: 모든 스토어프론트(Amazon, Steam, Windows, Roku 등)의 구성 제품을 포함합니다. false인 경우 member_products는 앱 인텔리전스 커버리지가 있는 스토어프론트(iOS + Google Play)로 제한됩니다. 제품 ID에는 무시됩니다.

예시

# Get Minecraft's unified-app record (iOS + Google Play by default).
af apps get ua_X7iNgb

# Get Minecraft's Google Play product record.
af apps get 6938219

af explorer list-products

af explorer list-products [flags]

하나 또는 여러 앱의 카탈로그 필드를 읽습니다. query 또는 sort가 참조하는 필드는 자동으로 반환되며, 추가 필드는 --extra-fields로 전달하세요. 단일 앱에는 ["match","product_id",<id>]를 사용하고, 인구 조사 쿼리에는 필터를 결합하세요(예: 미국 매출 100만 달러 이상의 Firebase 사용 iOS 앱). 120개 이상의 필드는 순위, 평점, 다운로드 및 매출 추정치, SDK, 인구 통계 등을 포함합니다. 쿼리 문법과 필드 목록은 docs get catalog_playbook에 있습니다.

옵션

• --query 배열, 기본값 []. 일치하는 카탈로그 Product를 선택하는 JSON 배열 형식의 Explorer 쿼리. 누락된 값과 []는 모든 스토어프론트의 모든 Product와 일치합니다. 전체 필드 목록과 쿼리 문법은 docs get catalog_playbook에 문서화되어 있습니다.

• --extra-fields 문자열[]. query 또는 sort가 이미 참조하는 필드 외에 포함할 추가 필드. 필드 경로(및 읽을 수 있는 필드)는 explorer describe-fields로 확인하세요.

• --sort 문자열. Explorer 필드 이름. 전체 필드 목록은 docs get catalog_playbook에 문서화되어 있습니다.

• --order 문자열, 기본값 desc. 정렬 방향.

• --count 정수, 기본값 10. 반환할 결과 수.

• --page 정수, 기본값 1. 페이지 번호.

• --allow-unscoped-nested 불리언, 기본값 false. 의도적으로 광범위한 쿼리를 위한 탈출구. 일반적으로 결과를 부풀리는 범위 없는 중첩 조건자에 대한 기본 차단을 우회합니다.

예시

# Find iOS apps that have Firebase installed.
af explorer list-products --query='["and",["match","storefronts","apple:ios"],["nested","all_sdks",["and",["match","all_sdks.id","firebase"],["match","all_sdks.active",true]]]]'

# Rank the biggest US iOS games by revenue.
af explorer list-products --query='["and",["match","storefronts","apple:ios"],["match","categories.all",6014]]' --sort='custom_meta[country=us].revenue_estimates_sum_30_days' --order=desc --count=25

# Find US iOS apps in the $100k–$1M/month revenue tier.
af explorer list-products --query='["and",["match","storefronts","apple:ios"],["nested","custom_meta",["and",["match","custom_meta.country","us"],["match","custom_meta.revenue_estimates_sum_30_days",["number_range",100000,1000000]]]]]'

# Page through results.
af explorer list-products --query='["and",["match","storefronts","apple:ios"],["match","categories.all",6014]]' --count=50 --page=2

# Pass `--extra-fields` for columns the query doesn't already reference. Common for single-app reads.
af explorer list-products --query='["match","product_id",304004187384]' --extra-fields='custom_meta[country=zz].revenue_estimates_sum_365_days,all_sdks[id=firebase].active'

af explorer aggregate-products

af explorer aggregate-products <fields> [flags]

Apple, Google Play, Amazon 및 기타 주요 스토어의 수백만 제품 전체 카탈로그에 대해 집계합니다: 일치하는 제품 집합에 대한 개수, 평균, 최소/최대, 히스토그램. explorer list-products와 동일한 쿼리 문법을 사용하며, 제품 레코드가 아닌 집계 값을 반환합니다. 시장 규모 산정, 벤치마킹, 세그먼트 분석에 사용합니다.

옵션

• <fields> 필수 string[]. 필드+집계 쌍 (예: all_rating/stats, storefronts/terms). 집계: stats, terms, histogram, date_histogram, cardinality. 전체 필드 목록은 docs get catalog_playbook에 문서화되어 있습니다.

• --query 배열, 기본값 []. 일치하는 카탈로그 Products를 선택하기 위한 JSON 배열 형식의 탐색기 쿼리. 누락된 값과 []는 모든 스토어프론트의 모든 Product와 일치합니다. 전체 필드 목록과 쿼리 구문은 docs get catalog_playbook에 문서화되어 있습니다.

• --allow-unscoped-nested 불리언, 기본값 false. 의도적으로 광범위한 쿼리를 위한 탈출구. 일반적으로 결과를 부풀리는 범위가 지정되지 않은 중첩 조건자에 대한 기본 차단을 우회합니다.

• --terms-count 정수, 기본값 20. 각 terms 집계에 대해 반환되는 최대 버킷 수. 다른 집계 유형은 이를 무시합니다.

• --date-histogram-interval 문자열. 각 date_histogram 집계의 버킷 세분성. 다른 집계 유형은 이를 무시합니다.

예시

# How many monthly downloads does an average iOS app get in Japan?
af explorer aggregate-products 'custom_meta[country=jp].download_estimates_average_30_days/stats' --query='["and",["match","storefronts","apple:ios"],["match","countries","jp"]]'

# What's the rating, category mix, and developer concentration for US iOS apps in the $100k–$10M/mo net-revenue tier?
af explorer aggregate-products all_rating/stats,categories.all/terms,developer_id/cardinality --query='["and",["match","storefronts","apple:ios"],["nested","custom_meta",["and",["match","custom_meta.revenue_estimates_sum_30_days",["number_range",100000,10000000]],["match","custom_meta.country","us"]]]]'

# Are new iOS games still launching at the same rate as two years ago?
af explorer aggregate-products release_date/date_histogram --query='["and",["match","storefronts","apple:ios"],["match","categories.all",6014],["match","release_date",["range","2024-01-01","2025-12-31"]]]'

# What SDKs do apps commonly ship alongside OneSignal?
af explorer aggregate-products 'all_sdks[*].id/terms' --query='["nested","all_sdks",["and",["match","all_sdks.id","onesignal"],["match","all_sdks.active",true]]]'

# How do iOS app ratings distribute?
af explorer aggregate-products all_rating/histogram --query='["match","storefronts","apple:ios"]'

# How many apps are on each storefront?
af explorer aggregate-products storefronts/terms

af explorer describe-fields

af explorer describe-fields [flags]

카탈로그 필드와 각 필드에 대한 현재 사용자의 접근 수준을 나열합니다. 키워드로 검색하여 필드를 찾습니다. explorer list-products 및 explorer aggregate-products가 허용하는 것과 동일한 필드 집합입니다.

옵션

• --count 정수, 기본값 50. 반환할 결과 수.

• --page 정수, 기본값 1. 페이지 번호.

• --q 문자열. path, title, description, type로 필터링합니다.

예시

# Search for revenue-related fields.
af explorer describe-fields --q=revenue

# List every catalog field with the current user's access level.
af explorer describe-fields

af metrics query

af metrics query <dataset> [flags]

하나 이상의 앱에 대한 모든 숫자 데이터셋을 쿼리합니다. 선택적으로 최대 두 개의 차원으로 그룹화되며, 앱 레코드가 아닌 중첩 파티션 트리로 반환됩니다. 국가, 기기 유형, 날짜 범위로 독립적으로 필터링할 수 있습니다. filterAppsBy* 옵션은 앱 집합을 좁힙니다(ID, 스토어프론트, 소스 또는 유형 기준). 하나도 지정하지 않으면 쿼리는 계정이 추적하는 모든 앱을 대상으로 합니다.

옵션

• <dataset> 필수 문자열. 쿼리할 데이터셋 (예: sales.combined_downloads). 전체 목록과 비공개 데이터(소유하거나 공유된 앱에만 표시되는 데이터)인 데이터셋은 metrics describe-datasets를 참조하세요.

• --group-by string[]. 그룹화할 차원. 최대 2개: 첫 번째 슬롯은 외부 엔티티 유형이 되고, 두 번째는 내부 시리즈가 됩니다. 각 차원은 결과 크기를 곱합니다.

• --granularity 문자열. 날짜별 그룹화 시 시간 세분성.

• --count 정수. 행 상한. --group-by 사용 시 값 기준 외부 엔티티 유형의 상위 N개(날짜별 그룹화 시 가장 이른 N개). --group-by 없이 사용 시 단일 페이지 미리보기.

• --countries string 배열. 하나 이상의 ISO 국가 코드로 필터링 (예: US, JP, GB).

• --device-type 문자열. 기기 유형.

• --all-time 불리언, 기본값 false. 전체 기록을 포함하도록 선택. 이 플래그가 없으면(그리고 start/end도 없으면) 쿼리는 기본적으로 최근 30일로 설정됩니다. start 및 end와 상호 배타적입니다.

• --filter-apps-by-id (정수 또는 문자열) 배열. 제품 ID 또는 통합 앱 ID로 특정 앱에 대한 데이터만 포함합니다. 설정 시 다른 filterAppsBy* 키보다 우선합니다. 스토어, 소스 또는 유형 필터는 해당 기준으로 설명할 수 있는 앱 집합에 더 적합합니다.

• --filter-apps-by-storefront string 배열. 계정의 추적 앱을 해당 스토어프론트의 앱으로 좁힙니다 (예: apple:ios, google_play).

• --filter-apps-by-source string 배열. 추적 관계별로 계정의 추적 앱을 좁힙니다.

• --filter-apps-by-type string 배열. 계정의 추적 앱을 해당 유형의 제품으로 좁힙니다.

• --start 문자열. 시작 날짜 (YYYY-MM-DD).

• --end 문자열. 종료 날짜 (YYYY-MM-DD, 기본값은 오늘).

예시

# Get total downloads across your apps with private-data access.
af metrics query sales.combined_downloads --filter-apps-by-source=own,shared

# Get revenue split by storefront, plus a top-level total.
af metrics query sales.combined_revenue --filter-apps-by-source=own,shared --group-by=storefront

# Rank the top 5 tracked competitors by estimated monthly revenue.
af metrics query estimates.revenue --filter-apps-by-source=manual --group-by=product --count=5

# Track Candy Crush Saga's daily download estimates.
af metrics query estimates.sales --filter-apps-by-id=ua_V1Q1uX --group-by=date --granularity=daily

# Track net monthly recurring revenue per app, month over month.
af metrics query subscriptions.mrr --filter-apps-by-source=own,shared --group-by=product,date --granularity=monthly

# Get Minecraft's new ratings.
af metrics query ratings.new_total --filter-apps-by-id=ua_X7iNgb

# Track daily ad spend across your apps.
af metrics query adspend.cost --filter-apps-by-source=own,shared --group-by=date --granularity=daily

# Compare Candy Crush's December 2025 downloads across the US, Japan, and UK.
af metrics query estimates.sales --filter-apps-by-id=ua_V1Q1uX --countries=US,JP,GB --group-by=country --start=2025-12-01 --end=2025-12-31

# Track all-time monthly revenue across your apps with private-data access.
af metrics query sales.combined_revenue --filter-apps-by-source=own,shared --group-by=date --granularity=monthly --all-time

# Get Minecraft's review volume by country.
af metrics query reviews.total --filter-apps-by-id=ua_X7iNgb --group-by=country

af metrics describe-datasets

af metrics describe-datasets [flags]

metrics query가 허용하는 모든 숫자 데이터셋을 나열합니다. 각 데이터셋에 대해 값 유형과 자체 앱으로 제한되는지 여부를 한 행씩 표시합니다.

옵션

• --count 정수, 기본값 50. 페이지네이션 결과 수.

• --page 정수, 기본값 1. 페이지 번호.

• --q 문자열. dataset, value_type, label, description로 필터링합니다.

예시

# Search by keyword (matches name, label, or description).
af metrics describe-datasets --q='combined downloads'

# Look up one dataset by its exact name.
af metrics describe-datasets --q=sales.combined_downloads

# List every dataset with its value type and whether it's limited to your own apps.
af metrics describe-datasets

af store app-ranks

af store app-ranks <app-ids> [flags]

국가, 기기 유형, 카테고리 하위 유형 및 카테고리 전반에 걸쳐 하나 이상의 앱의 순위 기록을 추적합니다. 일별 변화량이 포함된 시계열 위치로 표시됩니다.

옵션

• <app-ids> 필수 (정수 또는 문자열) 배열. 앱 식별자 (통합 앱 ID 또는 제품 ID).

• --countries string 배열. 쿼리할 국가 코드. 기본값은 순위 데이터가 있는 모든 국가입니다.

• --granularity 문자열, 기본값 hourly. 샘플링 속도. 시간별이 가장 최신 데이터를 제공합니다. 여러 날의 간결한 기록을 보려면 --granularity=daily를 전달하세요.

• --device-types string 배열, 기본값 ["handheld"]. 포함할 기기 유형; 각각 자체 차트에서 순위가 매겨집니다. 응답을 넓히려면 더 추가하세요.

• --subtypes string 배열, 기본값 ["free"]. 포함할 카테고리 하위 유형; 각각 자체 차트에서 순위가 매겨집니다. 응답을 넓히려면 더 추가하세요.

• --category-ids 정수 배열. 응답 행을 특정 카테고리 ID로 필터링; 생략하면 모두. 카테고리 ID는 store categories에서 가져옵니다.

• --start 문자열. 시작 날짜 (YYYY-MM-DD).

• --end 문자열. 종료 날짜 (YYYY-MM-DD, 기본값은 오늘).

• --count 정수, 기본값 10. 페이지네이션 결과 수.

• --page 정수, 기본값 1. 페이지 번호.

예시

# Check ChatGPT's current ranks (unified app).
af store app-ranks ua_miTXv6 --countries=US

# Check ChatGPT's current ranks on one storefront.
af store app-ranks 336744124021 --countries=US

# Compare ChatGPT's ranks across the US, UK, and Japan.
af store app-ranks ua_miTXv6 --countries=US,GB,JP

# Check Procreate's paid iPad chart ranks.
af store app-ranks ua_CxA1MS --subtypes=paid --device-types=tablet --countries=US

# Trace ChatGPT's chart history through December 2025.
af store app-ranks ua_miTXv6 --granularity=daily --start=2025-12-01 --end=2025-12-31 --countries=US

# Check ChatGPT's rank in one category (US iOS Productivity).
af store app-ranks 336744124021 --category-ids=6007 --countries=US

af store top-charts

af store top-charts [flags]

주어진 국가와 카테고리의 카테고리 차트에서 상위 앱을 현재 위치와 일별 변화와 함께 나열합니다.

옵션

• --country 필수 문자열. ISO 국가 코드 (예: US, JP, GB).

• --category-id 필수 정수. 카테고리 ID는 store categories에서 가져옵니다.

• --subtype 문자열, 기본값 free. 카테고리 하위 유형 (카테고리 내 차트 변형).

• --date 문자열. 스냅샷 날짜 (YYYY-MM-DD, 기본값은 현재).

• --count 정수, 기본값 10. 페이지네이션 결과 수.

• --page 정수, 기본값 1. 페이지 번호.

예시

# Find the Games category, then pull its US chart.
af store categories --q=games
af store top-charts --country=US --category-id=6014

# List top paid apps on the US App Store.
af store top-charts --country=US --category-id=25204 --subtype=paid

# List top free apps on the Japan App Store.
af store top-charts --country=JP --category-id=25204

# List top free apps on Google Play in the US.
af store top-charts --country=US --category-id=100

# List top free apps on the US App Store in December 2025.
af store top-charts --country=US --category-id=25204 --date=2025-12-01

af store categories

af store categories [flags]

ID와 함께 모든 스토어 카테고리를 나열합니다. store app-ranks --category-ids 및 store top-charts --category-id에서 필요한 숫자 카테고리 ID를 여기에서 확인할 수 있습니다.

옵션

• --count 정수, 기본값 50. 페이지네이션 결과 수.

• --page 정수, 기본값 1. 페이지 번호.

• --q 문자열. name으로 필터링합니다.

• --sort 문자열. 정렬 기준 필드. q가 설정된 경우 관련성 순으로 정렬하고, 그렇지 않으면 목록 순서를 유지하려면 생략합니다.

• --order 문자열, 기본값 desc. 정렬 방향.

• --category-id 정수 배열. 이 카테고리 ID만 반환합니다.

• --parent-id 정수. 이 상위 카테고리의 하위 카테고리만 포함합니다 (ID로 드릴다운).

• --storefront string 배열. 이 스토어프론트의 카테고리만 포함합니다 (예: apple:ios, google_play).

• --device-type string 배열. 이 기기 유형의 카테고리만 포함합니다 (예: handheld, tablet).

• --all 불리언, 기본값 false. 비순위 스토어(roku, vizio 등)를 포함합니다. 이들은 카테고리는 있지만 순위 데이터는 없습니다.

예시

# Find the Games category.
af store categories --q=games

# List every Apple iOS category.
af store categories --storefront=apple:ios

# List subcategories of a parent category (here, Apple Games).
af store categories --parent-id=6014

# Include categories from non-rank-supporting stores (e.g. Roku, Vizio) (not common).
af store categories --all

af store featured

af store featured <app-id> [flags]

앱 또는 스토어프론트 제품의 추천 및 편집 배치를 나열합니다. 요약 통계만 보려면 0행을 요청하세요.

옵션

• <app-id> 필수 정수 또는 문자열. 앱의 통합 앱 ID 또는 제품 ID.

• --countries string 배열. 포함할 국가. 생략하면 US만 쿼리하거나 여러 개를 전달하여 시장을 비교합니다. 모든 국가를 포함하려면 --all-countries를 대신 설정하세요.

• --all-countries 불리언, 기본값 false. 모든 국가를 포함합니다. --countries와 결합할 수 없습니다.

• --include-rank-trend 불리언, 기본값 false. 각 배치에 대한 간격별 rank_trend를 포함합니다.

• --sort 문자열, 기본값 relevance. 관련성 또는 날짜별로 배치를 정렬합니다.

• --order 문자열, 기본값 desc. 정렬 방향.

• --start 문자열. 시작 날짜 (YYYY-MM-DD).

• --end 문자열. 종료 날짜 (YYYY-MM-DD, 기본값은 오늘). 최대 31일 범위입니다.

• --count 정수, 기본값 10. 페이지네이션 결과 수.

• --page 정수, 기본값 1. 페이지 번호.

예시

# List Minecraft's recent featured placements (unified app).
af store featured ua_X7iNgb

# List Minecraft's recent featured placements on one storefront.
af store featured 10157213

# Compare Minecraft's placement coverage across the US, UK, and Japan.
af store featured ua_X7iNgb --countries=US,GB,JP

# List Minecraft's placements during a specific month (December 2025).
af store featured ua_X7iNgb --start=2025-12-01 --end=2025-12-31

# List Minecraft's placements with rank history.
af store featured ua_X7iNgb --include-rank-trend

# List Minecraft's placements sorted by end date, newest run first.
af store featured ua_X7iNgb --sort=date --order=desc

# Get Minecraft's placement summary only.
af store featured ua_X7iNgb --count=0

af store app-listing

af store app-listing <product-id> [flags]

한 스토어프론트의 전체 스토어 목록을 읽습니다: 지역화된 텍스트(이름, 부제, 설명, 릴리스 노트)와 스크린샷, 비디오, 카테고리, 수익화, 지원 기기, 국가 가용성, 가격, 파일 크기 및 연령 등급. 숫자 제품 ID를 사용합니다(한 번에 한 스토어프론트; 통합 앱은 스토어프론트당 하나의 제품을 가짐). 요청당 하나의 로케일.

옵션

• <product-id> 필수 정수. 한 스토어프론트의 숫자 제품 ID. 통합 앱 ID가 아닙니다. 멤버 product_id 값은 apps get '<unified-app-id>'에서 사용할 수 있습니다.

• --language 문자열. 이름, 부제, 설명, 릴리스 노트 및 스크린샷의 로케일 (예: en, ja, zh-Hans). 기본값은 en; 요청한 로케일에 메타데이터가 없으면 첫 번째 사용 가능한 로케일로 대체됩니다. 응답은 해결된 언어를 반영합니다.

• --device-type 문자열, 기본값 handheld. Apple 앱에 관련됩니다. iPhone 특정 메타데이터는 handheld, iPad는 tablet, Mac은 desktop 등을 선택하세요.

예시

# Read Minecraft's store listing.
af store app-listing 10157213

# Read Minecraft's Japanese-localized listing.
af store app-listing 10157213 --language=ja

# Read Minecraft's iPad screenshots.
af store app-listing 10157213 --device-type=tablet

af audience demographics

af audience demographics <app-id>

앱의 잠재 고객 인구 통계를 읽습니다: 추정 연령 및 성별 분포.

옵션

• <app-id> 필수 정수 또는 문자열. 앱의 통합 앱 ID 또는 제품 ID.

예시

# Read Minecraft's audience across all its storefronts (unified app ID).
af audience demographics ua_X7iNgb

# Read Minecraft's audience on Google Play only (product ID).
af audience demographics 6938219

af audience cross-usage

af audience cross-usage <app-id> [flags]

앱 사용자가 함께 사용하는 앱을 찾습니다.

옵션

• <app-id> 필수 정수 또는 문자열. 앱의 통합 앱 ID 또는 제품 ID.

• --count 정수, 기본값 10. 페이지네이션 결과 수.

• --page 정수, 기본값 1. 페이지 번호.

예시

# Find the apps ChatGPT's users also use (unified app ID).
af audience cross-usage ua_miTXv6

# Find the apps ChatGPT's users also use on the App Store only (product ID).
af audience cross-usage 336744124021

af reviews list

af reviews list [flags]

하나 이상의 앱에 대한 개별 리뷰를 읽습니다. 리뷰 텍스트, 별점, 국가 및 앱 버전을 반환합니다. 별점, 날짜 범위, 국가, 버전 및 추적 관계로 필터링할 수 있습니다.

옵션

• --stars number[]. 별점으로 필터링합니다.

• --versions string[]. 앱 버전으로 필터링합니다. 여러 개를 전달하여 결합합니다.

• --countries string[]. 하나 이상의 ISO 국가 코드(예: US, JP, GB)로 필터링합니다.

• --q string. 리뷰 제목과 본문을 검색합니다. 여러 키워드를 전달하면 하나라도 일치하면 매칭됩니다. 대소문자를 구분하지 않으며 다른 필터와 결합됩니다.

• --sort string. 리뷰 날짜 또는 별점으로 정렬합니다.

• --order string, 기본값 desc. 정렬 방향입니다.

• --filter-apps-by-id (integer 또는 string)[]. 제품 ID 또는 통합 앱 ID로 특정 앱에 대한 데이터만 포함합니다. 설정하면 다른 filterAppsBy* 키보다 우선합니다. 해당 기준으로 설명할 수 있는 앱 세트에는 스토어프론트, 소스 또는 유형 필터가 더 적합합니다.

• --filter-apps-by-storefront string[]. 계정에서 추적하는 앱을 해당 스토어프론트의 앱으로 좁힙니다(예: apple:ios, google_play).

• --filter-apps-by-source string[]. 추적 관계별로 계정의 추적 앱을 좁힙니다.

• --filter-apps-by-type string[]. 계정의 추적 앱을 해당 유형의 제품으로 좁힙니다.

• --start string. 시작 날짜(YYYY-MM-DD)

• --end string. 종료 날짜(YYYY-MM-DD, 기본값은 오늘)

• --count integer, 기본값 10. 반환할 결과 수입니다.

• --page integer, 기본값 1. 페이지 번호. 1-500.

예시

# Read Minecraft's recent reviews.
af reviews list --filter-apps-by-id=ua_X7iNgb

# Read Minecraft's 5-star reviews.
af reviews list --filter-apps-by-id=ua_X7iNgb --stars=5

# Compare Minecraft's reviews across the US, Japan, and the UK.
af reviews list --filter-apps-by-id=ua_X7iNgb --countries=US,JP,GB

# Read Minecraft's December 2025 reviews.
af reviews list --filter-apps-by-id=ua_X7iNgb --start=2025-12-01 --end=2025-12-31

# Page through long results across your own apps.
af reviews list --filter-apps-by-source=own --count=50 --page=2

af reviews breakdown

af reviews breakdown [flags]

하나 이상의 앱에 대한 리뷰 수를 차원별로 집계합니다. 차원 값별 개수 하나와 일치하는 세트 전체의 전체 합계를 반환합니다.

옵션

• --stars number[]. 별점으로 필터링합니다.

• --versions string[]. 앱 버전으로 필터링합니다. 여러 개를 전달하여 결합합니다.

• --countries string[]. 하나 이상의 ISO 국가 코드(예: US, JP, GB)로 필터링합니다.

• --q string. 리뷰 제목과 본문을 검색합니다. 여러 키워드를 전달하면 하나라도 일치하면 매칭됩니다. 대소문자를 구분하지 않으며 다른 필터와 결합됩니다.

• --filter-apps-by-id (integer 또는 string)[]. 제품 ID 또는 통합 앱 ID로 특정 앱에 대한 데이터만 포함합니다. 설정하면 다른 filterAppsBy* 키보다 우선합니다. 해당 기준으로 설명할 수 있는 앱 세트에는 스토어프론트, 소스 또는 유형 필터가 더 적합합니다.

• --filter-apps-by-storefront string[]. 계정에서 추적하는 앱을 해당 스토어프론트의 앱으로 좁힙니다(예: apple:ios, google_play).

• --filter-apps-by-source string[]. 추적 관계별로 계정의 추적 앱을 좁힙니다.

• --filter-apps-by-type string[]. 계정의 추적 앱을 해당 유형의 제품으로 좁힙니다.

• --start string. 시작 날짜(YYYY-MM-DD)

• --end string. 종료 날짜(YYYY-MM-DD, 기본값은 오늘)

• --by string[]. 응답을 해당 차원으로 제한합니다. 생략하면 모두 반환합니다.

• --top integer, 기본값 20. 차원당 반환되는 최대 값 수입니다. 나머지는 __other__로 합산됩니다.

예시

# Break down Minecraft's recent reviews.
af reviews breakdown --filter-apps-by-id=ua_X7iNgb

# Where are Minecraft's biggest fans writing from?
af reviews breakdown --filter-apps-by-id=ua_X7iNgb --stars=5

# Count Minecraft's December 2025 5-star reviews.
af reviews breakdown --filter-apps-by-id=ua_X7iNgb --stars=5 --start=2025-12-01 --end=2025-12-31

# How many Minecraft reviewers raved?
af reviews breakdown --filter-apps-by-id=ua_X7iNgb --q='love amazing fun great best'

# Compare review volume across your own apps.
af reviews breakdown --filter-apps-by-source=own

af reviews reply

af reviews reply <review-id> [flags]

특정 리뷰에 개발자 응답을 게시하거나 철회합니다. 게시하려면 content를 전달하고, 이전에 게시한 응답을 철회하려면 delete: true를 전달합니다. 제출한 계정과 함께 결과 상태(published/pending은 게시, removed/removal_pending은 철회)를 반환합니다.

옵션

• <review-id> 필수 string. 작업할 리뷰입니다. reviews list의 review_id를 사용합니다.

• --content string. 개발자가 게시하려는 응답 텍스트입니다.

• --delete boolean. 이 리뷰에 대해 이전에 게시한 응답을 철회합니다. content와 함께 사용할 수 없습니다.

예시

# Reply to a low-star review after shipping a fix.
af reviews reply rev123 --content='We just shipped a fix in v2.1. Let us know if you still see this.'

# Withdraw a previously-posted response.
af reviews reply rev123 --delete

af keywords organic

af keywords organic [flags]

하나 이상의 앱이 순위를 차지하는 오가닉 키워드를 위치, 인기도, 경쟁력과 함께 확인합니다.

옵션

• --product-ids integer[]. 제품 식별자(숫자, 각각 하나의 스토어프론트).

• --countries 필수 string[]. 하나 이상의 ISO 국가 코드(예: US, JP, GB). 여러 개를 전달하여 시장을 비교합니다.

• --device-type string. 기기 유형

• --count integer, 기본값 10. 반환할 결과 수입니다(최소 10).

• --page integer, 기본값 1. 페이지 번호.

예시

# Check ChatGPT's current US keyword rankings.
af keywords organic --product-ids=336744124021 --countries=US

# Check ChatGPT's iPad-only keyword rankings.
af keywords organic --product-ids=336744124021 --countries=US --device-type=tablet

# Compare ChatGPT and Gemini's US keyword rankings.
af keywords organic --product-ids=336744124021,337217072531 --countries=US

af keywords paid

af keywords paid <product-ids> [flags]

하나 이상의 앱이 광고를 게재하는 유료 키워드를 노출 점유율 및 오가닉 순위와 함께 나열합니다.

옵션

• <product-ids> 필수 integer[]. 제품 식별자(숫자, 각각 하나의 스토어프론트).

• --days integer, 기본값 180. 조회 기간(일)입니다. 일반적인 값: 7, 14, 30, 90, 180, 365.

• --countries 필수 string[]. 하나 이상의 ISO 국가 코드(예: US, JP, GB). 여러 개를 전달하여 시장을 비교합니다.

• --device-types string[]. 기기 유형으로 필터링합니다. 기본값은 핸드헬드입니다.

• --count integer, 기본값 10. 반환할 결과 수입니다(최소 10).

• --page integer, 기본값 1. 페이지 번호.

예시

# Find Headspace's US paid keywords.
af keywords paid 15250929 --countries=US

# Compare Headspace's and Calm's US paid keywords.
af keywords paid 15250929,304554144 --countries=US

# Find Headspace's paid keywords across the US, UK, and Japan.
af keywords paid 15250929 --countries=US,GB,JP

# Find Headspace's US iPad paid keywords.
af keywords paid 15250929 --countries=US --device-types=tablet

# Check Headspace's US paid keywords over the last 30 days.
af keywords paid 15250929 --countries=US --days=30

af keywords tracked-ranks

af keywords tracked-ranks <product-id> [flags]

단일 앱+국가 조합에 대해 추적 중인 모든 키워드의 순위를 각 키워드의 현재 위치, 마지막 변경 이후 변동, 시작 위치, 인기도, 경쟁력과 함께 확인합니다.

옵션

• <product-id> 필수 integer. 하나의 스토어프론트에 대한 숫자 제품 ID입니다. 통합 앱 ID가 아닙니다. 멤버 product_id 값은 apps get '<unified-app-id>'에서 확인할 수 있습니다.

• --country 필수 string. ISO 국가 코드(예: US, JP, GB)

• --device-type string. 순위를 읽을 기기입니다. 생략하면 스토어 기본값을 사용합니다.

• --count integer, 기본값 10. 반환할 결과 수입니다(최소 10).

• --page integer, 기본값 1. 페이지 번호.

• --sort string. 결과를 정렬할 필드입니다.

• --order string, 기본값 desc. 정렬 방향입니다.

• --start string. 기간의 시작(YYYY-MM-DD)입니다. 범위를 생략하면 최근 7일이 사용되며, 시작 날짜의 순위가 시작 위치 기준이 됩니다.

• --end string. 기간의 종료(YYYY-MM-DD, 기본값은 오늘)입니다. 최대 31일까지입니다.

• --keyword-term string. 용어에 이 텍스트가 포함된 추적 키워드만 포함합니다.

• --min-position integer. 포함할 최고 순위(1 = 최상위)입니다.

• --max-position integer. 포함할 최저 순위입니다.

• --min-popularity integer. 포함할 최저 인기도(0-100)입니다.

• --max-popularity integer. 포함할 최고 인기도(0-100)입니다.

• --min-competitiveness integer. 포함할 최저 경쟁력(0-100)입니다.

• --max-competitiveness integer. 포함할 최고 경쟁력(0-100)입니다.

예시

# Check how ChatGPT's tracked keywords are ranking.
af keywords tracked-ranks 336744124021 --country=US

# List ChatGPT's best-ranking keywords first.
af keywords tracked-ranks 336744124021 --country=US --sort=position --order=asc

# Show only the keywords ChatGPT ranks in the top 10.
af keywords tracked-ranks 336744124021 --country=US --max-position=10

# Find the most-searched keywords ChatGPT should prioritize.
af keywords tracked-ranks 336744124021 --country=US --sort=popularity --min-popularity=50

# Trace ChatGPT's keyword movement across a custom week.
af keywords tracked-ranks 336744124021 --country=US --start=2026-01-06 --end=2026-01-12

# Page through a long tracked keyword set.
af keywords tracked-ranks 336744124021 --country=US --page=2

af keywords tracked-trend

af keywords tracked-trend <keyword-id> [flags]

단일 앱+국가 조합에 대해 추적 중인 하나의 키워드 순위가 시간에 따라 어떻게 변하는지 추적합니다. 각 지점은 순위와 이전 지점 대비 이동한 순위 수를 제공합니다.

옵션

• <keyword-id> 필수 string. 추적할 키워드입니다. 이 앱과 국가에 대해 추적 중이어야 하며, 불투명 ID는 keywords tracked-ranks 또는 keywords tracked에서 가져옵니다.

• --product-id 필수 integer. 하나의 스토어프론트에 대한 숫자 제품 ID입니다. 통합 앱 ID가 아닙니다. 멤버 product_id 값은 apps get '<unified-app-id>'에서 확인할 수 있습니다.

• --country 필수 string. ISO 국가 코드(예: US, JP, GB)

• --device-type string. 순위를 읽을 기기입니다. 생략하면 스토어 기본값을 사용합니다.

• --granularity string, 기본값 daily. 샘플링 주기입니다.

• --start string. 기간의 시작(YYYY-MM-DD)입니다. 범위를 생략하면 최근 7일이 사용됩니다.

• --end string. 기간의 종료(YYYY-MM-DD, 기본값은 오늘)입니다. 시간별 세분화의 경우 최대 14일, 일별의 경우 31일까지입니다.

예시

# Find a tracked keyword, then trace its rank day by day.
af keywords tracked-ranks 336744124021 --country=US
af keywords tracked-trend 00f2b1ead3a0990b818517356cb40280 --product-id=336744124021 --country=US

# Trace a keyword's rank for ChatGPT across a specific week.
af keywords tracked-trend 00f2b1ead3a0990b818517356cb40280 --product-id=336744124021 --country=US --start=2026-01-06 --end=2026-01-12

# Trace a keyword hour by hour.
af keywords tracked-trend 00f2b1ead3a0990b818517356cb40280 --product-id=336744124021 --country=US --granularity=hourly

af keywords suggestions

af keywords suggestions <product-id> [flags]

단일 앱+국가 조합에 대해 타게팅을 고려할 키워드 아이디어를 발견합니다. 앱과의 관련성 순으로 정렬되며 경쟁 앱에서 가져온 일부도 포함됩니다. 각 키워드에는 인기도, 경쟁력, 앱의 현재 순위가 함께 제공됩니다.

옵션

• <product-id> 필수 integer. 하나의 스토어프론트에 대한 숫자 제품 ID입니다. 통합 앱 ID가 아닙니다. 멤버 product_id 값은 apps get '<unified-app-id>'에서 확인할 수 있습니다.

• --country 필수 string. ISO 국가 코드(예: US, JP, GB)

• --device-type string. 순위를 읽을 기기입니다. 생략하면 스토어 기본값을 사용합니다.

• --count integer, 기본값 10. 반환할 결과 수입니다.

• --page integer, 기본값 1. 페이지 번호.

예시

# Discover keywords ChatGPT should consider targeting.
af keywords suggestions 336744124021 --country=US

# Find keyword ideas for ChatGPT in Japan.
af keywords suggestions 336744124021 --country=JP

# Pull a broader set of suggestions.
af keywords suggestions 336744124021 --country=US --count=50

af keywords ranking-apps

af keywords ranking-apps <keyword-term> [flags]

오가닉 검색에서 특정 키워드에 대해 순위를 차지하는 앱과 해당 키워드 자체의 인기도 및 경쟁력 점수를 나열합니다.

옵션

• <keyword-term> 필수 string. 조회할 키워드입니다.

• --country 필수 string. ISO 국가 코드(예: US, JP, GB)

• --storefront 필수 string. 앱 스토어 플랫폼(예: apple:ios, google_play, amazon_appstore, steam, windows10, apple:mac, apple:tv, apple:imessage 또는 기타 지원되는 스토어프론트).

• --device-type string. 기기 유형

• --count integer, 기본값 10. 반환할 결과 수입니다.

• --page integer, 기본값 1. 페이지 번호.

예시

# Find US iOS apps ranking for "fitness".
af keywords ranking-apps fitness --country=US --storefront=apple:ios

# Find Google Play apps ranking for "fitness".
af keywords ranking-apps fitness --country=US --storefront=google_play

# Find US iPad apps ranking for "meditation".
af keywords ranking-apps meditation --country=US --storefront=apple:ios --device-type=tablet

af keywords advertisers

af keywords advertisers <keyword-term> [flags]

특정 키워드로 광고하는 앱을 각 광고주의 노출 점유율, 오가닉 순위, 입찰 기간과 함께 나열합니다.

옵션

• <keyword-term> 필수 string. 광고주를 조회할 키워드

• --days integer, 기본값 180. 조회 기간(일)입니다. 일반적인 값: 7, 14, 30, 90, 180, 365.

• --country 필수 string. ISO 국가 코드(예: US, JP, GB)

• --device-type string. 기기 유형

• --count integer, 기본값 10. 반환할 결과 수입니다.

• --page integer, 기본값 1. 페이지 번호.

예시

# Find US apps advertising on the "notion" brand.
af keywords advertisers notion --country=US

# Find US iPad apps advertising on "meditation".
af keywords advertisers meditation --country=US --device-type=tablet

# Find US apps advertising on "fitness" over the last 30 days.
af keywords advertisers fitness --country=US --days=30

af keywords related

af keywords related <keyword-term> [flags]

ASO 리서치를 위해 시드 용어와 관련된 키워드를 찾습니다. 유사한 잠재 고객을 보유하면서 더 인기 있거나 경쟁이 덜한 대안을 찾는 데 유용합니다.

옵션

• <keyword-term> 필수 string. 관련 용어를 찾을 시드 키워드입니다.

• --country 필수 string. ISO 국가 코드(예: US, JP, GB)

• --storefront 필수 string. 앱 스토어 플랫폼(예: apple:ios, google_play, amazon_appstore, steam, windows10, apple:mac, apple:tv, apple:imessage 또는 기타 지원되는 스토어프론트).

• --device-type string. 기기 유형

• --count integer, 기본값 10. 반환할 결과 수입니다.

• --page integer, 기본값 1. 페이지 번호.

예시

# Find US iOS keywords related to "fitness".
af keywords related fitness --country=US --storefront=apple:ios

# Find US Google Play keywords related to "fitness".
af keywords related fitness --country=US --storefront=google_play

# Find US iPad keywords related to "meditation".
af keywords related meditation --country=US --storefront=apple:ios --device-type=tablet

af keywords tracked

af keywords tracked [flags]

추적 중인 키워드를 불투명 ID와 함께 나열합니다.

옵션

• --count integer, 기본값 10. 반환할 결과 수입니다.

• --page integer, 기본값 1. 페이지 번호.

• --q string. keyword_term으로 필터링합니다.

• --sort string. 정렬할 필드입니다. q가 설정된 경우 관련성 순으로 정렬하려면 생략하고, 그렇지 않으면 목록 순서를 사용합니다.

• --order string, 기본값 desc. 정렬 방향입니다.

• --include-relationships boolean, 기본값 false. 각 행에 (제품, 국가)별 추적 세부 정보와 동기화 상태를 포함합니다. 기본값은 꺼져 있으며, 추적 중인 (제품, 국가) 쌍마다 중첩 블록을 추가합니다.

예시

# List every tracked keyword.
af keywords tracked

# Search tracked keywords for "fitness".
af keywords tracked --q=fitness

# List the most-recently-tracked keywords first.
af keywords tracked --sort=added_on

# Show each keyword's tracking and sync detail.
af keywords tracked --include-relationships

af keywords track

af keywords track <keyword-term> [플래그]

키워드를 추적해 시간이 지남에 따라 앱의 시간별 순위를 모니터링하고, 순위가 변동될 때 자동 알림을 받습니다.

옵션

• <keyword-term> 필수 문자열. 추적을 시작할 키워드

• --product-id 필수 정수. 키워드를 추적할 앱의 제품 ID

• --country 필수 문자열. ISO 국가 코드 (예: US, JP, GB)

예시

# Start tracking "meditation" for one of your apps in the US.
af keywords track meditation --product-id=336744124021 --country=US

# Track "workout" in Japan.
af keywords track workout --product-id=336744124021 --country=JP

af keywords untrack

af keywords untrack <keyword-id>

키워드 추적을 중지합니다.

옵션

• <keyword-id> 필수 문자열. 추적된 키워드 행의 식별자(keywords tracked에서 반환됨). 키워드 텍스트가 아닙니다.

예시

# Stop tracking a keyword.
af keywords untrack a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6

af 애플 광고 조직

af apple-ads organizations [플래그]

캠페인을 관리하는 Apple Ads 조직과 각 조직의 통화 및 시간대를 나열합니다.

옵션

• --count 정수, 기본값 10. 반환할 결과 수.

• --page 정수, 기본값 1. 페이지 번호.

예시

# List all the Apple Ads organizations you manage.
af apple-ads organizations

af 애플 광고 캠페인

af apple-ads campaigns [플래그]

각 캠페인의 상태, 예산, 타겟 국가 및 일정과 함께 Apple Ads 캠페인을 나열합니다.

옵션

• --display-status 문자열. 하나의 상태에 있는 캠페인으로 필터링합니다. 생략하면 모든 상태를 포함합니다.

• --name 문자열. 이름에 이 텍스트가 포함된 캠페인으로 필터링합니다.

• --countries 문자열[]. 이 국가 중 하나를 타겟팅하는 캠페인으로 필터링합니다.

• --count 정수, 기본값 10. 반환할 결과 수.

• --page 정수, 기본값 1. 페이지 번호.

예시

# List all your Apple Ads campaigns.
af apple-ads campaigns

# List only your running campaigns.
af apple-ads campaigns --display-status=running

# Search your campaigns by name.
af apple-ads campaigns --name=Brand

# List campaigns targeting the US or UK.
af apple-ads campaigns --countries=US,GB

af 애플 광고 광고그룹

af apple-ads ad-groups [campaign-id] [플래그]

각 광고 그룹의 기본 입찰가, CPA 상한, 가격 책정 모델 및 일정과 함께 Apple Ads 광고 그룹을 나열합니다.

옵션

• [campaign-id] 문자열. 하나의 캠페인 내 광고 그룹으로 범위를 지정합니다.

• --display-status 문자열. 지정된 상태의 광고 그룹으로 필터링합니다. 생략하면 모든 상태를 포함합니다.

• --name 문자열. 이름에 이 부분 문자열이 포함된 광고 그룹으로 필터링합니다.

• --count 정수, 기본값 10. 반환할 결과 수.

• --page 정수, 기본값 1. 페이지 번호.

예시

# List all your ad groups across every campaign.
af apple-ads ad-groups

# List the ad groups in one campaign.
af apple-ads ad-groups aac_W9YthU

애플 광고-키워드(키워드)

af apple-ads keywords <campaign-id> [플래그]

날짜 범위별 각 키워드의 실적(노출 수, 탭, 설치 수, 지출, 설치당 비용)과 일치 유형, 입찰가, 타겟팅 또는 제외 용어 여부와 함께 캠페인의 입찰 키워드를 나열합니다.

옵션

• <campaign-id> 필수 문자열. 입찰 키워드를 나열할 캠페인.

• --ad-group-id 문자열. 하나의 광고 그룹 내 키워드로 필터링합니다.

• --status 문자열. 지정된 상태의 키워드로 필터링합니다. 생략하면 모든 상태를 포함합니다.

• --match-type 문자열. 하나의 일치 유형으로 필터링합니다. 생략하면 둘 다 포함합니다.

• --name 문자열. 텍스트에 이 부분 문자열이 포함된 키워드로 필터링합니다.

• --sort 문자열. 성과 지표 또는 입찰가를 기준으로 키워드를 정렬합니다. 생략하면 최신순으로 정렬합니다.

• --order 문자열, 기본값 desc. 정렬 방향.

• --start 문자열. 시작 날짜 (YYYY-MM-DD)

• --end 문자열. 종료 날짜 (YYYY-MM-DD, 기본값은 오늘)

• --count 정수, 기본값 10. 반환할 결과 수.

• --page 정수, 기본값 1. 페이지 번호.

예시

# Find a running campaign, then list its bid keywords.
af apple-ads campaigns --display-status=running
af apple-ads keywords aac_W9YthU

# See how a campaign's keywords performed over July 2026.
af apple-ads keywords aac_W9YthU --start=2026-07-01 --end=2026-07-31

# Find a campaign's highest-spending keywords.
af apple-ads keywords aac_W9YthU --sort=spend

애플 광고-검색어

af apple-ads search-terms <campaign-id> [플래그]

캠페인의 광고를 트리거한 실제 사용자 검색어를 각 검색어의 전체 기간 실적(노출 수, 탭, 설치 수, 지출, 설치당 비용)과 함께 나열합니다. 이를 사용해 입찰하거나 제외할 새 키워드를 찾아보세요.

옵션

• <campaign-id> 필수 문자열. 검색어를 나열할 캠페인.

• --count 정수, 기본값 10. 반환할 결과 수.

• --page 정수, 기본값 1. 페이지 번호.

예시

# Find a campaign, then see the user searches that triggered its ads.
af apple-ads campaigns
af apple-ads search-terms aac_uDGL4v

af 애플 광고 보고서

af apple-ads report [플래그]

날짜 범위에 따른 캠페인별 Apple Ads 실적(노출, 탭, 설치 수, 지출, 설치당 비용) 외에도 계정 전체 합계를 보고합니다.

옵션

• --campaign-ids 문자열[]. 보고서를 특정 캠페인으로 제한합니다.

• --start 문자열. 시작 날짜 (YYYY-MM-DD)

• --end 문자열. 종료 날짜 (YYYY-MM-DD, 기본값은 오늘)

• --count 정수, 기본값 10. 반환할 결과 수.

• --page 정수, 기본값 1. 페이지 번호.

예시

# See how much an install costs across all your campaigns.
af apple-ads report

# Report on July 2026 performance.
af apple-ads report --start=2026-07-01 --end=2026-07-31

# List campaigns, then report on specific ones.
af apple-ads campaigns
af apple-ads report --campaign-ids=aac_uDGL4v

Apple 앱 광고 상위 키워드

af apple-ads top-keywords <campaign-id> [플래그]

날짜 범위 내 전환율, 지출, 설치 수를 기준으로 캠페인의 상위 실적 키워드의 순위를 매기세요. 각 목록에는 한 가지 지표의 상위 키워드가 포함됩니다.

옵션

• <campaign-id> 필수 문자열. 키워드 순위를 매길 캠페인.

• --top 정수, 기본값 5. 순위당 반환할 키워드 수(최대 10).

• --start 문자열. 시작 날짜 (YYYY-MM-DD)

• --end 문자열. 종료 날짜 (YYYY-MM-DD, 기본값은 오늘)

예시

# Find a campaign, then see its top-performing keywords.
af apple-ads campaigns
af apple-ads top-keywords aac_uDGL4v

# Rank a campaign's keywords for a specific week.
af apple-ads top-keywords aac_uDGL4v --start=2026-07-25 --end=2026-07-31

# Widen each ranking to the maximum of 10 keywords.
af apple-ads top-keywords aac_uDGL4v --top=10

참조

AF SDK 목록 나열

af sdks list [플래그]

알려진 모든 SDK를 ID와 함께 나열하거나 검색하여 특정 SDK를 찾습니다.

옵션

• --count 정수, 기본값 50. 반환할 결과 수.

• --page 정수, 기본값 1. 페이지 번호.

• --q 문자열. name, description, tags로 필터링합니다.

• --sort 문자열. 정렬 기준 필드. q가 설정된 경우에는 관련성순으로, 그렇지 않으면 목록 순서로 정렬하려면 생략합니다.

• --order 문자열, 기본값 desc. 정렬 방향.

• --sdk-id 문자열[]. 이 SDK ID만 반환합니다.

• --include-inactive 부울, 기본값 false. 비활성 SDK를 포함합니다. 드물며, 대부분의 호출자는 활성 SDK만 필요로 합니다.

예시

# Find OneSignal's id.
af sdks list --q=OneSignal

# Search for analytics SDKs.
af sdks list --q=analytics

# Look up details for several SDK ids.
af sdks list --sdk-id=firebase,admob,onesignal

# Include inactive SDKs in the listing (not common).
af sdks list --include-inactive

문서 가져오기

af docs get <slug>

슬러그로 참조 문서 또는 가이드를 반환합니다.

옵션

• <slug> 필수 문자열. 반환할 참조 문서 지정

예시

# Read the dataset naming conventions and pitfalls for [`metrics query`](#command-metrics-query); the dataset list itself is in [`metrics describe-datasets`](#command-metrics-describe-datasets).
af docs get numeric_metrics

# Read the catalog query grammar, field-reference syntax, aggregation rules, and worked queries for [`explorer list-products`](#command-explorer-list-products) and [`explorer aggregate-products`](#command-explorer-aggregate-products).
af docs get catalog_playbook

# Read the glossary of domain terms seen in responses.
af docs get glossary

API

af api <경로> [플래그]

전용 명령이 만들지지 않은 엔드포인트에 원시 API 요청을 수행합니다. 엔드 포인트, 매개 변수 및 응답 형태는 https://docs.appfigures.com에 문서화되어 있습니다.

옵션

• <path> 필수 문자열. API 경로(예: /users, /products)

• --method 문자열, 기본값 GET. HTTP 메서드(GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS 중 하나)

• --body 문자열. 요청 본문(JSON 문자열)

참조

MCP용 mcp

af mcp

stdio를 통해 MCP 서버를 실행하여 Claude Desktop 및 Cursor와 같은 MCP 클라이언트가 Appfigures 도구를 호출할 수 있도록 합니다.

참조

af 인증 로그인

af auth login [플래그]

Appfigures에 로그인

이 CLI를 승인할 URL을 출력합니다. 이 URL을 열고 접근을 승인한 뒤 승인 후 표시된 코드를 사용해 --code <code>로 다시 실행합니다. 대신 --interactive를 전달하면 안내되는 브라우저 흐름을 통해 로그인할 수 있습니다.

무인 실행(CI, 스크립트) 환경에서는 대신에 APPFIGURES_TOKEN을 환경 변수로 설정하세요. 브라우저 흐름이 필요 없습니다.

옵션

• --code 문자열. OAuth 동의 페이지의 인증 코드. af auth login의 두 번째 단계: 코드를 교환하고 토큰을 저장하고 종료합니다.

• --interactive boolean. 안내되는 브라우저 흐름을 통해 로그인합니다.

참조

af 인증 로그아웃

af auth logout

저장된 자격 증명 제거

참조

상태 인증 상태

af auth status

인증 및 계정 상태 표시

지원

• 이슈: github.com/appfigures/cli/issues

• API 문서: docs.appfigures.com

기여

이 패키지는 개인 모노레포에서 개발되어 이곳에 미러로 게시됩니다. 버그를 신고하거나 기능을 요청하려면 이슈를 개설하세요.

또한 AI 네이티브 개발자도 채용 중입니다. AI 앱 인텔리전스의 미래를 만들고 싶다면 appfigures.com/careers에 지원하세요.

라이선스

Apache 2.0