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

npm install -g @appfigures/cli

appfigures auth login
appfigures --help

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

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

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

# 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

# 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

# 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

# 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'

# 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

# 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

# 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

# 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

# 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

# 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

***

<a id="store-featured"></a> <a id="command-store-featured"></a>

### af store featured

`af store featured <app-id> [flags]`

アプリまたはストアフロントプロダクトの注目配置や編集者の配置を一覧表示します。まとめ統計のみが必要な場合は 0 行をリクエストします。

**オプション**

* `<app-id>` 必須 integer または string。アプリの統合アプリ ID またはプロダクト ID。
* `--countries` string[]。含める国。省略するとアメリカのみをクエリするか、複数渡して複数の市場を比較できます。すべての国を含めるには、代わりに `--all-countries` を設定します。
* `--all-countries` boolean、デフォルト `false`。すべての国を含めます。`--countries` とは併用できません。
* `--include-rank-trend` boolean、デフォルト `false`。各配置のインターバルごとの `rank_trend` を含めます。
* `--sort` string、デフォルト `relevance`。配置を関連性または日付で並べ替えます。
* `--order` string、デフォルト `desc`。並べ替え方向。
* `--start` string。開始日 (YYYY-MM-DD)
* `--end` string。終了日 (YYYY-MM-DD、デフォルト今日)。最大 31 日間です。
* `--count` integer、デフォルト `10`。返す結果の数。
* `--page` integer、デフォルト `1`。ページ番号。

**例**

```GXP18

`

<a id="store-app-listing"></a> <a id="command-store-app-listing"></a>

### af store app-listing

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

1 つのストアフロントの完全なストア掲載情報を読み取ります: ローカライズされたテキスト (名前、サブタイトル、説明、リリースノート) に加え、スクリーンショット、ビデオ、カテゴリ、マネタイズ方法、サポート対象デバイス、提供国、価格、ファイルサイズ、年齢制限。数値のプロダクト ID を受け付けます (一度に 1 つのストアフロント。統合アプリにはストアフロントごとに 1 つのプロダクトがあります)。リクエストごとに 1 つのロケールを指定します。

**オプション**

* `<product-id>` 必須 integer。1 つのストアフロントの数値プロダクト ID。統合アプリ ID ではありません。
* `--language` string。名前、サブタイトル、説明、リリースノート、スクリーンショットのロケール（例: en、ja、zh-Hans）。デフォルトは en; 指定したロケールにメタデータがない場合は、最初に利用可能なロケールへフォールバックします。レスポンスは解決に使用された言語をエコーします。
* `--device-type` string、デフォルト `handheld`。Apple アプリに関係します。iPhone 固有のメタデータは handheld、iPad は tablet、Mac は desktop など、デバイスで指定します。

**例**

```GXP19

***

<a id="audience-demographics"></a> <a id="command-audience-demographics"></a>

### af audience demographics

	`af audience demographics <app-id>`

アプリのオーディエンス人口統計を読み取ります: 推定年齢と性別の内訳。

**オプション**

* `<app-id>` is required integer or string. The app's unified app ID or product ID.

**例**

```GXP20

***

<a id="audience-cross-usage"></a> <a id="command-audience-cross-usage"></a>

### af audience cross-usage

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

あるアプリのユーザーも使用しているアプリを検索します。

**オプション**

* `<app-id>` is required integer or string. The app's unified app ID or product ID.
* `--count` integer, default `10`. Number of results to return.
* `--page` integer, default `1`. Page number.

**例**

```GXP21

***

<a id="reviews-list"></a> <a id="command-reviews-list"></a>

### af reviews list

	`af reviews list [flags]`

1 つ以上のアプリの個々のレビューを読み取ります。レビューテキスト、星評価、国、アプリバージョンのほか、星評価、日時、国、バージョン、追跡関係でフィルタリングできます。

**オプション**

* `--stars` number\[]. 星評価でフィルタリングします。
* `--versions` string\[]. アプリのバージョンでフィルタリングします。複数指定して組み合わせることができます。
* `--countries` string\[]. 1つ以上のISO国コード（例：US、JP、GB）にフィルタリングします。
* `--q` string. レビューのタイトルと本文を検索します。複数のキーワードを渡すと、いずれかに一致するものを検索します。大文字と小文字を区別しません。他のフィルターと組み合わせます。
* `--sort` string. レビューの日付または星評価で並べ替えます。
* `--order` string, デフォルト `desc`. 並べ替えの方向。
* `--filter-apps-by-id` (integer or 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。

**例**

GXP22

***

<a id="reviews-breakdown"></a> <a id="command-reviews-breakdown"></a>

### af reviews breakdown

`af reviews breakdown [flags]`

1つ以上のアプリのレビュー数を集計し、ディメンションごとにバケット化します。ディメンション値ごとに1つのカウントと、一致したセット全体の合計を返します。

**オプション**

* `--stars` number\[]. 星評価でフィルタリングします。
* `--versions` string\[]. アプリのバージョンでフィルタリングします。複数指定して組み合わせることができます。
* `--countries` string\[]. 1つ以上のISO国コード（例：US、JP、GB）にフィルタリングします。
* `--q` string. レビューのタイトルと本文を検索します。複数のキーワードを渡すと、いずれかに一致するものを検索します。大文字と小文字を区別しません。他のフィルターと組み合わせます。
* `--filter-apps-by-id` (integer or 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__` の下に合計されます。

**例**

GXP23

***

<a id="reviews-reply"></a> <a id="command-reviews-reply"></a>

### af reviews reply

`af reviews reply <review-id> [flags]`

特定のレビューに開発者の返信を投稿または撤回します。`content` を渡すと投稿し、`delete: true` を渡すと以前に投稿した返信を撤回します。結果の状態（投稿の場合は `published`/`pending`、撤回の場合は `removed`/`removal_pending`）と、提出したアカウントを返します。

**オプション**

* `<review-id>` 必須 string. 操作するレビュー。 [`reviews list`](#command-reviews-list) の `review_id` を使用します。
* `--content` string. 開発者が公開したい返信テキスト。
* `--delete` boolean. このレビューに以前投稿した返信を撤回します。`content` とは相互に排他的です。

**例**

GXP24

***

<a id="keywords-organic"></a> <a id="command-keywords-organic"></a>

### af keywords organic

`af keywords organic [flags]`

1つ以上のアプリがランクインしているオーガニックキーワードを、順位、人気度、競争度とともに確認します。

**オプション**

* `--product-ids` integer\[]. 製品識別子（数値、各ストアフロントにつき1つ）。
* `--countries` 必須 string\[]. 1つ以上のISO国コード（例：US、JP、GB）。複数渡して市場を比較します。
* `--device-type` string. デバイスタイプ
* `--count` integer, デフォルト `10`. 返す結果の数（最小10）。
* `--page` integer, デフォルト `1`. ページ番号。

**例**

GXP25

***

<a id="keywords-paid"></a> <a id="command-keywords-paid"></a>

### af keywords paid

`af keywords paid <product-ids> [flags]`

1つ以上のアプリが広告を掲載している有料キーワードを、インプレッションシェアとオーガニック順位とともに一覧表示します。

**オプション**

* `<product-ids>` 必須 integer\[]. 製品識別子（数値、各ストアフロントにつき1つ）。
* `--days` integer, デフォルト `180`. 遡る日数。一般的な値：7、14、30、90、180、365。
* `--countries` 必須 string\[]. 1つ以上のISO国コード（例：US、JP、GB）。複数渡して市場を比較します。
* `--device-types` string\[]. デバイスタイプでフィルタリングします。デフォルトはハンドヘルドです。
* `--count` integer, デフォルト `10`. 返す結果の数（最小10）。
* `--page` integer, デフォルト `1`. ページ番号。

**例**

GXP26

***

<a id="keywords-tracked-ranks"></a> <a id="command-keywords-tracked-ranks"></a>

### af keywords tracked-ranks

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

追跡しているすべてのキーワードが、単一のアプリ+国コンボでどの順位にあるかを表示します。各キーワードの現在の順位、最後に変更されてからの変動、開始時の順位、人気度、競争度が含まれます。

**オプション**

* `<product-id>` 必須 integer. 1つのストアフロントの数値製品ID。統合アプリIDではありません。メンバーの product\_id 値は [`apps get '<unified-app-id>'`](#command-apps-get) から取得できます。
* `--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）。

**例**

GXP27

***

<a id="keywords-tracked-trend"></a> <a id="command-keywords-tracked-trend"></a>

### af keywords tracked-trend

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

単一のアプリ+国コンボについて、追跡している1つのキーワードの順位が時間とともにどのように変化するかを追跡します。各ポイントは、順位と、前のポイントから何位移動したかを示します。

**オプション**

* `<keyword-id>` 必須 string. 追跡するキーワード。このアプリと国で追跡されている必要があります。その不透明なIDは [`keywords tracked-ranks`](#command-keywords-tracked-ranks) または [`keywords tracked`](#command-keywords-tracked) から取得します。
* `--product-id` 必須 integer. 1つのストアフロントの数値製品ID。統合アプリIDではありません。メンバーの product\_id 値は [`apps get '<unified-app-id>'`](#command-apps-get) から取得できます。
* `--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日間。

**例**

GXP28

***

<a id="keywords-suggestions"></a> <a id="command-keywords-suggestions"></a>

### af keywords suggestions

`af keywords suggestions <product-id> [flags]`

単一のアプリ+国コンボについて、ターゲットにすることを検討すべきキーワードのアイデアを発見します。アプリとの関連性でランク付けされ、競合アプリから引き出されたものも含まれます。それぞれに人気度、競争度、アプリの現在の順位が付属します。

**オプション**

* `<product-id>` 必須 integer. 1つのストアフロントの数値製品ID。統合アプリIDではありません。メンバーの product\_id 値は [`apps get '<unified-app-id>'`](#command-apps-get) から取得できます。
* `--country` 必須 string. ISO国コード（例：US、JP、GB）
* `--device-type` string. 順位を読み取るデバイス。省略するとストアのデフォルトを使用します。
* `--count` integer, デフォルト `10`. 返す結果の数。
* `--page` integer, デフォルト `1`. ページ番号。

**例**

GXP29

***

<a id="keywords-ranking-apps"></a> <a id="command-keywords-ranking-apps"></a>

### 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`. ページ番号。

**例**

GXP30

***

<a id="keywords-advertisers"></a> <a id="command-keywords-advertisers"></a>

### 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`. ページ番号。

**例**

GXP31

***

<a id="keywords-related"></a> <a id="command-keywords-related"></a>

### 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`. ページ番号。

**例**

GXP32

***

<a id="keywords-tracked"></a> <a id="command-keywords-tracked"></a>

### 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`. 各行に（製品、国）ごとの追跡詳細と同期状態を含めます。デフォルトではオフ。オンにすると、追跡されている（製品、国）のペアごとにネストされたブロックが追加されます。

**例**

GXP33

***

<a id="keywords-track"></a> <a id="command-keywords-track"></a>

### af keywords track

`af keywords track <keyword-term> [flags]`

キーワードをトラッキングして、アプリの時間ごとの順位を経時的に監視し、順位が変動したときに自動アラートを受け取ります。

**オプション**

* `<keyword-term>` 必須の文字列。トラッキングを開始するキーワード
* `--product-id` 必須の整数。キーワードをトラッキングするアプリのプロダクトID
* `--country` 必須の文字列。ISO国コード（例：US、JP、GB）

**例**

GXP34

***

<a id="keywords-untrack"></a> <a id="command-keywords-untrack"></a>

### af keywords untrack

`af keywords untrack <keyword-id>`

キーワードのトラッキングを停止します。

**オプション**

* `<keyword-id>` 必須の文字列。トラッキング中のキーワード行の識別子（[`keywords tracked`](#command-keywords-tracked) によって返されます）。キーワードのテキストではありません。

**例**

GXP35

***

<a id="apple-ads-organizations"></a> <a id="command-apple-ads-organizations"></a>

### af apple-ads organizations

`af apple-ads organizations [flags]`

キャンペーンを管理しているApple Adsの組織を、それぞれの通貨とタイムゾーンとともに一覧表示します。

**オプション**

* `--count` 整数、デフォルト `10`。返す結果の数。
* `--page` 整数、デフォルト `1`。ページ番号。

**例**

GXP36

***

<a id="apple-ads-campaigns"></a> <a id="command-apple-ads-campaigns"></a>

### af apple-ads campaigns

`af apple-ads campaigns [flags]`

Apple Adsのキャンペーンを、それぞれのステータス、予算、ターゲット国、スケジュールとともに一覧表示します。

**オプション**

* `--display-status` 文字列。特定のステータスのキャンペーンに絞り込みます。省略するとすべてのステータスが含まれます。
* `--name` 文字列。名前にこのテキストを含むキャンペーンに絞り込みます。
* `--countries` 文字列\[\]。これらのいずれかをターゲットにしているキャンペーンに絞り込みます。
* `--count` 整数、デフォルト `10`。返す結果の数。
* `--page` 整数、デフォルト `1`。ページ番号。

**例**

GXP37

***

<a id="apple-ads-ad-groups"></a> <a id="command-apple-ads-ad-groups"></a>

### af apple-ads ad-groups

`af apple-ads ad-groups [campaign-id] [flags]`

Apple Adsの広告グループを、それぞれのデフォルト入札額、CPA上限、価格モデル、スケジュールとともに一覧表示します。

**オプション**

* `[campaign-id]` 文字列。1つのキャンペーン内の広告グループに範囲を絞ります。
* `--display-status` 文字列。特定のステータスの広告グループに絞り込みます。省略するとすべてのステータスが含まれます。
* `--name` 文字列。名前にこの部分文字列を含む広告グループに絞り込みます。
* `--count` 整数、デフォルト `10`。返す結果の数。
* `--page` 整数、デフォルト `1`。ページ番号。

**例**

GXP38

***

<a id="apple-ads-keywords"></a> <a id="command-apple-ads-keywords"></a>

### af apple-ads keywords

`af apple-ads keywords <campaign-id> [flags]`

キャンペーンの入札キーワードを、各キーワードの期間中のパフォーマンス（インプレッション、タップ、インストール、支出、獲得単価）に加えて、マッチタイプ、入札額、ターゲティングまたは除外キーワードかどうかを一覧表示します。

**オプション**

* `<campaign-id>` 必須の文字列。入札キーワードを一覧表示するキャンペーン。
* `--ad-group-id` 文字列。1つの広告グループ内のキーワードに絞り込みます。
* `--status` 文字列。特定のステータスのキーワードに絞り込みます。省略するとすべてのステータスが含まれます。
* `--match-type` 文字列。1つのマッチタイプに絞り込みます。省略すると両方が含まれます。
* `--name` 文字列。テキストにこの部分文字列を含むキーワードに絞り込みます。
* `--sort` 文字列。パフォーマンス指標または入札額でキーワードを並べ替えます。省略すると新しい順になります。
* `--order` 文字列、デフォルト `desc`。並べ替えの方向。
* `--start` 文字列。開始日（YYYY-MM-DD）
* `--end` 文字列。終了日（YYYY-MM-DD、デフォルトは今日）
* `--count` 整数、デフォルト `10`。返す結果の数。
* `--page` 整数、デフォルト `1`。ページ番号。

**例**

GXP39

***

<a id="apple-ads-search-terms"></a> <a id="command-apple-ads-search-terms"></a>

### af apple-ads search-terms

`af apple-ads search-terms <campaign-id> [flags]`

キャンペーンの広告を表示させた実際のユーザー検索語を、それぞれの全期間のパフォーマンス（インプレッション、タップ、インストール、支出、獲得単価）とともに一覧表示します。これらを使用して、入札または除外する新しいキーワードを発見できます。

**オプション**

* `<campaign-id>` 必須の文字列。検索語を一覧表示するキャンペーン。
* `--count` 整数、デフォルト `10`。返す結果の数。
* `--page` 整数、デフォルト `1`。ページ番号。

**例**

GXP40

***

<a id="apple-ads-report"></a> <a id="command-apple-ads-report"></a>

### af apple-ads report

`af apple-ads report [flags]`

キャンペーンごとのApple Adsパフォーマンス（インプレッション、タップ、インストール、支出、獲得単価）に加えて、アカウント全体の合計を期間にわたってレポートします。

**オプション**

* `--campaign-ids` 文字列\[\]。レポートを特定のキャンペーンに限定します。
* `--start` 文字列。開始日（YYYY-MM-DD）
* `--end` 文字列。終了日（YYYY-MM-DD、デフォルトは今日）
* `--count` 整数、デフォルト `10`。返す結果の数。
* `--page` 整数、デフォルト `1`。ページ番号。

**例**

GXP41

***

<a id="apple-ads-top-keywords"></a> <a id="command-apple-ads-top-keywords"></a>

### af apple-ads top-keywords

`af apple-ads top-keywords <campaign-id> [flags]`

キャンペーンの上位パフォーマンスキーワードを、期間中のコンバージョン率、支出、インストール数でランク付けします。各リストは1つの指標で上位キーワードを保持します。

**オプション**

* `<campaign-id>` 必須の文字列。キーワードをランク付けするキャンペーン。
* `--top` 整数、デフォルト `5`。ランキングごとに返すキーワードの数（最大10）。
* `--start` 文字列。開始日（YYYY-MM-DD）
* `--end` 文字列。終了日（YYYY-MM-DD、デフォルトは今日）

**例**

GXP42

***

<a id="sdks-list"></a> <a id="command-sdks-list"></a>

### af sdks list

`af sdks list [flags]`

既知のすべてのSDKをID付きで一覧表示するか、検索して特定のSDKを見つけます。

**オプション**

* `--count` 整数、デフォルト `50`。返す結果の数。
* `--page` 整数、デフォルト `1`。ページ番号。
* `--q` 文字列。`name`、`description`、`tags` でフィルタリングします。
* `--sort` 文字列。並べ替えるフィールド。`q` が設定されている場合は関連性順、それ以外の場合はリスト順になります。省略すると関連性順になります。
* `--order` 文字列、デフォルト `desc`。並べ替えの方向。
* `--sdk-id` 文字列\[\]。これらのSDK IDのみを返します。
* `--include-inactive` ブール値、デフォルト `false`。非アクティブなSDKを含めます。まれです。ほとんどの呼び出し元はアクティブのみを必要とします。

**例**

GXP43

***

<a id="docs-get"></a> <a id="command-docs-get"></a>

### af docs get

`af docs get <slug>`

スラッグでリファレンスドキュメントまたはガイドを返します。

**オプション**

* `<slug>` 必須の文字列。返すリファレンス

**例**

GXP44

***

<a id="command-api"></a>

### af api

`af api <path> [flags]`

専用コマンドがないエンドポイントに対して生のAPIリクエストを行います。エンドポイント、パラメータ、レスポンスの形式は <https://docs.appfigures.com> に文書化されています。

**オプション**

* `<path>` 必須の文字列。APIパス（例：/users、/products）
* `--method` 文字列、デフォルト `GET`。HTTPメソッド（GET、POST、PUT、PATCH、DELETE、HEAD、OPTIONS のいずれか）
* `--body` 文字列。リクエストボディ（JSON文字列）

***

<a id="command-mcp"></a>

### af mcp

`af mcp`

Claude DesktopやCursorなどのMCPクライアントがAppfiguresツールを呼び出せるように、stdio上でMCPサーバーを実行します。

***

<a id="auth-login"></a> <a id="command-auth-login"></a>

### af auth login

`af auth login [flags]`

Appfiguresにサインインします

このCLIを承認するためのURLを表示します。それを開いてアクセスを承認し、承認後に表示されるコードを使用して `--code <code>` を付けて再実行します。代わりに `--interactive` を渡すと、ガイド付きブラウザフローでサインインできます。

無人での使用（CI、スクリプト）の場合は、代わりに環境変数APPFIGURES\_API\_KEYを設定してください。ブラウザフローは不要です。

**オプション**

* `--code` 文字列。OAuth同意ページからの認可コード。`af auth login` の2番目のステップ：コードを交換し、トークンを保存して終了します。
* `--interactive` ブール値。ガイド付きブラウザフローでサインインします。

***

<a id="auth-logout"></a> <a id="command-auth-logout"></a>

### af auth logout

`af auth logout`

保存された認証情報を削除します

***

<a id="auth-status"></a> <a id="command-auth-status"></a>

### af auth status

`af auth status`

認証とアカウントのステータスを表示します

<!-- END auto-generated API REFERENCE ENTRIES -->

<!-- prettier-ignore-end -->

## サポート

* 問題: [github.com/appfigures/cli/issues](https://github.com/appfigures/cli/issues)
* APIドキュメント: [docs.appfigures.com](https://docs.appfigures.com)

## コントリビューション

このパッケージはプライベートモノレポで開発され、ミラーとしてここに公開されています。バグを報告したり機能をリクエストするには、[issueを開いて](https://github.com/appfigures/cli/issues)ください。

また、AIネイティブな開発者も募集しています。AI App Intelligenceの未来を一緒に作りたい方は、[appfigures.com/careers](https://appfigures.com/careers) で応募してください。

## ライセンス

Apache 2.0