# @appfigures/cli 中文文档

规范地址：https://npmcn.com/package/%40appfigures/cli/

版本：4\.0\.0
npm 元数据更新时间：2026-10-09T15:59:37.179Z
中文译文更新时间：2026-11-06T20:11:42.420Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40appfigures/cli
原文对照：https://npmcn.com/package/%40appfigures/cli/?lang=original
项目主页：https://github.com/appfigures/cli#readme
源码仓库：https://github.com/appfigures/cli

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：1.3 MB，7 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：1 个
- 首次发布：2026-04-12T17:21:05.113Z
- 最新版本发布：2026-10-09T15:59:35.924Z
- 近 30 天下载量：2396（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：24（近 12 个月 24 个）

## 中文简介

Appgits CLI — 查询应用程序的度量衡、评论和存储终端数据

## 安装

```sh
npm install @appfigures/cli
```

也可以使用：`pnpm add @appfigures/cli`、`yarn add @appfigures/cli`、`bun add @appfigures/cli`

## README

# @ appigits/ cli (英语)

[![npm version](https://img.shields.io/npm/v/@appfigures/cli)](https://www.npmjs.com/package/@appfigures/cli) [![MCP server](https://img.shields.io/badge/MCP-server-blue)](https://modelcontextprotocol.io/)

Appgits CLI ——查询 App 度量衡,评论,并存储您终端的数据.

现在试试,不用安装 :

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

## QQ 使用 Appigits AI 的四种方法

将Appfigits带入你的代理中,不管它是建起来的——作为它调用的工具,它写的代码,一个CLI,或者超过MCP. 无论你挑哪一个,你都可以做同样的事情,得到同样的JSON回来.

-   🛠️ **代理工具** ——你的经纪人在Appgapts运行时称它为工具. AI SDK, OpenAI, LangChain. (原始内容存档于2018-09-21) (英语) [添加工具](https://github.com/appfigures/agent-toolkit#tools-for-your-agent-framework)
-   📦 **客户** – 您的代理写出代码, 用于查询 Appfigure 并获得打入后的数据 。 → [使用客户端](https://github.com/appfigures/agent-toolkit#the-client-for-code-your-agent-writes)
-   🖥️ **国 际** ——从终端或沙盒运行 Appigits. → [`@appfigures/cli`](https://npmcn.com/package/%40appfigures/cli/#readme-quick-start)
-   🔌 **MCP 磁共振** ——连接 Appigits 到克洛德, ChatGPT, 或 Cursor [连接主机服务器](https://npmcn.com/package/%40appfigures/cli/#readme-mcp-server)

## 安装

```sh
npm install -g @appfigures/cli
```

需要节点.js 22+. 工作与pnpm和纱线.

## 快开始

```sh
appfigures auth login
appfigures --help
```

也可用 `af` 别名.

## 认证

-   **自己登记.** `af auth login --interactive` 在引导流中打开浏览器;批准并粘贴回代码.
-   **或者让你的经纪人指导你.** 默认, `af auth login` 打印授权 URL —— 打开、批准和完成 `af auth login --code <code>` 使用显示的代码。 一个特工可以推动这一端结束. 用于未处理的用途, 设置 `APPFIGURES_API_KEY` 相反: 在 [appigits.com/开发者/钥匙](https://appfigures.com/developers/keys) 通过单击 **创建新客户端**,则 **创建个人访问托肯**。 。 。 .

任何登录都会保存令牌给您的OS证书管理器(macOS Keychain,Windows证书管理器,Linux Secret Service). 见 [环境](https://npmcn.com/package/%40appfigures/cli/#readme-environment) 页:1 `APPFIGURES_API_KEY` 还有其他的功能.

## MCP 服务器

应用程序运行主机 [示范背景协议](https://modelcontextprotocol.io/) 服务器在 `https://mcp.appfigures.com/mcp`。将其添加到任何支持远程服务器的MCP客户端中,并在客户端询问时与您的 Appfits 账户签名. 没有什么可以安装的,也没有可以管理的迹象.

**克劳德代码.** 添加一个命令, 然后运行 `/mcp` 以 :

```sh
claude mcp add --transport http appfigures https://mcp.appfigures.com/mcp
```

**克洛德 (网络和桌面).** 添加 URL 作为自定义连接符 。 见 [添加目录中没有的连接符](https://claude.com/docs/connectors/custom/add-unlisted)。 。 。 .

**恰克格普特(英语:ChatGPT).** 将 URL 添加为 OAuth 的自定义 MCP 服务器 。 见 [连接配置到 ChatGPT](https://help.appfigures.com/en/article/connecting-appfigures-into-chatgpt-mdu20l/)。 。 。 .

**其他客户.** 添加一个具有相同URL的远程(Streamable HTTP)服务器. 看看你客户的MCP文档.

主机服务器与API和CLI共享公共数据访问和信用. 关于申请限额和信贷费用,见 [配置 API、 CLI 和 MCP: 访问、限制和公共数据](https://help.appfigures.com/en/article/appfigures-api-cli-and-mcp-access-limits-and-public-data-1seiibo/)。 。 。 .

用于认证的脚本和无头代理 `APPFIGURES_API_KEY`运行 `af` 直接命令,或使用 [`@appfigures/agent-toolkit`](https://www.npmjs.com/package/@appfigures/agent-toolkit) 从代码.

### `af mcp` (折旧)

`af mcp` 运行与本地 stdio 服务器相同的工具 。 已堕取出后会取出下大出. 现有的设置一直工作到那时,但不会获得新的MCP功能. 移动到上面的主机服务器 .

## 图标

### 应用程序

找到应用程序并查查他们的身份 其他命令则使用应用程序标识这些返回.

| 命令 | 说明 |
| --- | --- |
| [`af apps search`](https://npmcn.com/package/%40appfigures/cli/#readme-command-apps-search) | 按名称或出版商查找应用软件. 每个统一应用程序返回一行。 默认返回 Apple 和 Google 列表; 通过 `--all-stores` 包括其他商店。 要通过估计值过滤应用程序( 如上个月下载了 > 100k的应用程序) [`explorer list-products`](https://npmcn.com/package/%40appfigures/cli/#readme-command-explorer-list-products)用于按时间、国家或库存额分列的估计数 [`metrics query`](https://npmcn.com/package/%40appfigures/cli/#readme-command-metrics-query) 包含数据集估计数。 销售或估计. |
| [`af apps get`](https://npmcn.com/package/%40appfigures/cli/#readme-command-apps-get) | 获得一个app的纪录:基本的元数据(名称,开发者等),如果用户跟踪,他们可以访问哪些数据. 通过一个店面的产品ID;所有店面一起统一应用ID. |
| [`af apps tracked`](https://npmcn.com/package/%40appfigures/cli/#readme-command-apps-tracked) | 列出您的 Appgits 账户轨迹 . |
| [`af apps breakdown`](https://npmcn.com/package/%40appfigures/cli/#readme-command-apps-breakdown) | 按数据组(如销售量,使用量,排名,评论量,关键词),存储前置,货币化模型,和源(你的对被跟踪的竞争者)计算出你的有跟踪的应用,外加总和最早的发布日期. |

### 浏览器

搜索与分析全应用程序目录:苹果、谷歌游戏、亚马逊等主要商店的上百万个产品.

| 命令 | 说明 |
| --- | --- |
| [`af explorer list‑products`](https://npmcn.com/package/%40appfigures/cli/#readme-command-explorer-list-products) | 为一个或许多应用程序读取目录字段 。 引用字段 `query` 或者说 `sort` 自动返回; 通过 `--extra-fields` 为了更多。 使用 `["match","product_id",<id>]` 用于一个单一的应用程序,或者合并用于人口查询的过滤器(例如使用Firebase的iOS应用程序和1M+美国收入). 120+字段横跨排名、评级、下载和收入估计、SDK、人口统计等等;查询语法和字段列表 [`docs get catalog_playbook`](https://npmcn.com/package/%40appfigures/cli/#readme-command-docs-get)。 。 。 . |
| [`af explorer aggregate‑products`](https://npmcn.com/package/%40appfigures/cli/#readme-command-explorer-aggregate-products) | 在苹果、Google Play、Amazon及其他主要商店的数百万产品全目录中, 使用与 [`explorer list-products`](https://npmcn.com/package/%40appfigures/cli/#readme-command-explorer-list-products);返回总量,而不是产品记录。 用于市场规模、基准和部门分析. |
| [`af explorer describe‑fields`](https://npmcn.com/package/%40appfigures/cli/#readme-command-explorer-describe-fields) | 列出目录字段和当前用户的每个访问级别 。 以关键字搜索查找字段 。 同一个字段集 [`explorer list-products`](https://npmcn.com/package/%40appfigures/cli/#readme-command-explorer-list-products) 财务报告和审定财务报表 [`explorer aggregate-products`](https://npmcn.com/package/%40appfigures/cli/#readme-command-explorer-aggregate-products) 接受 . |

### 计量

查询跨维度的数字数据集.

| 命令 | 说明 |
| --- | --- |
| [`af metrics query`](https://npmcn.com/package/%40appfigures/cli/#readme-command-metrics-query) | 查询一个或多个应用程序的任何数字数据集 。 可选分组最多可分出两个维度,返回后作为被嵌入的分区树,而不是应用记录. 可按国家、设备类型和日期范围独立过滤. `filterAppsBy*` 选项缩小应用程序集(通过ID, storefront, source, 或类型);没有选项,则查询覆盖每个应用程序的账户音轨. |
| [`af metrics describe‑datasets`](https://npmcn.com/package/%40appfigures/cli/#readme-command-metrics-describe-datasets) | 列出每个数字数据集 [`metrics query`](https://npmcn.com/package/%40appfigures/cli/#readme-command-metrics-query) 接受,每个数据集一行带有其值类型,是否仅限于自己的应用程序. |

### 存储

App商店的存在:上市内容,类别排行,上图,并有特色地布置.

| 命令 | 说明 |
| --- | --- |
| [`af store app‑ranks`](https://npmcn.com/package/%40appfigures/cli/#readme-command-store-app-ranks) | 追踪一国或多国应用程序的排名历史,设备类型,类别子类型,以及类别,作为时间序列位置并带有日复一日的三角洲. |
| [`af store top‑charts`](https://npmcn.com/package/%40appfigures/cli/#readme-command-store-top-charts) | 在给定的国家和类别分类图中列出顶端应用程序,并列出当前位置和日常三角洲. |
| [`af store categories`](https://npmcn.com/package/%40appfigures/cli/#readme-command-store-categories) | 列出每个存储类别及其ID。 所需数字类ID [`store app-ranks --category-ids`](https://npmcn.com/package/%40appfigures/cli/#readme-command-store-app-ranks) 财务报告和审定财务报表 [`store top-charts --category-id`](https://npmcn.com/package/%40appfigures/cli/#readme-command-store-top-charts) 这里有. |
| [`af store featured`](https://npmcn.com/package/%40appfigures/cli/#readme-command-store-featured) | 应用程序或商店前期产品的专栏和编辑位置。 只请求摘要统计的0行. |
| [`af store app‑listing`](https://npmcn.com/package/%40appfigures/cli/#readme-command-store-app-listing) | 读取一个商店前端的完整商店列表:本地化文本(名称,字幕,描述,发行注释)外加截图,视频,分类,货币化,支持设备,国家可用性,价格,收视率,文件大小,以及年龄评级. 取一个数字产品ID(一次一个商店前门;一个统一的应用程序每个商店前门有一个产品). 每个请求一个地方. |

### 观众

应用程序的用户是谁,他们还使用什么. 覆盖了估计的年龄和性别,加上观众与其他应用程序的重叠.

| 命令 | 说明 |
| --- | --- |
| [`af audience demographics`](https://npmcn.com/package/%40appfigures/cli/#readme-command-audience-demographics) | 阅读一个应用的受众人口统计:估计年龄和性别的分解. |
| [`af audience cross‑usage`](https://npmcn.com/package/%40appfigures/cli/#readme-command-audience-cross-usage) | 查找应用程序用户也使用的应用程序 . |

### 审查

搜索,总结,并回复iOS和Google Play应用商店的评论.

| 命令 | 说明 |
| --- | --- |
| [`af reviews list`](https://npmcn.com/package/%40appfigures/cli/#readme-command-reviews-list) | 阅读一个或多个应用程序的个别评论. 返回审查文本、星标、国家、应用程序版本以及您的回复。 按恒星评级,日期范围,国家,版本,响应状态,以及跟踪关系可过滤. |
| [`af reviews breakdown`](https://npmcn.com/package/%40appfigures/cli/#readme-command-reviews-breakdown) | 一个或数个应用软件的汇总审查按尺寸计算。 返回每维值一个计数,加上一组对应的全局总数. |
| [`af reviews reply`](https://npmcn.com/package/%40appfigures/cli/#readme-command-reviews-reply) | 发送或撤回特定审查的开发者回复. 过 `content` 调出; 通过 `delete: true` 撤回先前的回复. |

### 关键词

关键字能见度,分级跟踪,以及跨越有机搜索(App Store,Google Play)和苹果Ads的发现.

| 命令 | 说明 |
| --- | --- |
| [`af keywords organic`](https://npmcn.com/package/%40appfigures/cli/#readme-command-keywords-organic) | 请检查access-date=中的日期值 (帮助) 有机关键词 一个或多个应用名列前茅 位置 受欢迎度 竞争力. |
| [`af keywords paid`](https://npmcn.com/package/%40appfigures/cli/#readme-command-keywords-paid) | 列出付费关键字 一个或多个应用程序运行广告, 并带有印象共享和有机排序 . |
| [`af keywords tracked‑ranks`](https://npmcn.com/package/%40appfigures/cli/#readme-command-keywords-tracked-ranks) | 查看您所有履带关键词在单个app+country组合中的排名, 每个关键词的当前位置, 自上次改变以来的移动, 起始位置, 受欢迎度, 以及竞争力 . |
| [`af keywords tracked‑trend`](https://npmcn.com/package/%40appfigures/cli/#readme-command-keywords-tracked-trend) | 追踪单个app+country组合中一个关键词的分级如何随时间变化. 每一点都给出了从前作起它所移动的级别和多少位置. |
| [`af keywords suggestions`](https://npmcn.com/package/%40appfigures/cli/#readme-command-keywords-suggestions) | 发现关键词想法,以考虑锁定一个单一的app+country 组合,按照与该应用程序的关联性排序,并包括一些取自与您竞争的应用程序. 每个都伴随着它的受欢迎度,竞争力,以及应用的当前级别. |
| [`af keywords ranking‑apps`](https://npmcn.com/package/%40appfigures/cli/#readme-command-keywords-ranking-apps) | 列出应用程序在有机搜索中特定关键词的排名,并加上关键词本身的受欢迎度和竞争力分数. |
| [`af keywords advertisers`](https://npmcn.com/package/%40appfigures/cli/#readme-command-keywords-advertisers) | 列出特定关键字的应用广告,并列出每个广告商的印象分享,有机排名,以及他们投标的时间. |
| [`af keywords related`](https://npmcn.com/package/%40appfigures/cli/#readme-command-keywords-related) | 查找与ASO研究的种子名词相關的关键词. 用于寻找具有类似受众的更受欢迎或竞争力更弱的替代品. |
| [`af keywords tracked`](https://npmcn.com/package/%40appfigures/cli/#readme-command-keywords-tracked) | 列出带有不透明身份的跟踪关键词. |
| [`af keywords track`](https://npmcn.com/package/%40appfigures/cli/#readme-command-keywords-track) | 追踪一个关键词,以监视您的应用程序的小时级别,并当其位置移动时获得自动警报. |
| [`af keywords untrack`](https://npmcn.com/package/%40appfigures/cli/#readme-command-keywords-untrack) | 停止跟踪关键字 . |

### 苹果广告

管理您的 Apple Ads 活动, 广告组, 关键词和性能 .

| 命令 | 说明 |
| --- | --- |
| [`af apple‑ads organizations`](https://npmcn.com/package/%40appfigures/cli/#readme-command-apple-ads-organizations) | 列出您管理的 Apple Ads 组织, 以及每个人的货币和时区. |
| [`af apple‑ads campaigns`](https://npmcn.com/package/%40appfigures/cli/#readme-command-apple-ads-campaigns) | 列出您的 Apple Ads 活动, 包括每个人的状态、预算、目标国家以及时间表. |
| [`af apple‑ads ad‑groups`](https://npmcn.com/package/%40appfigures/cli/#readme-command-apple-ads-ad-groups) | 列出苹果 广告组 每人的默认出价,CPA上限,定价模式,和时间表. |
| [`af apple‑ads keywords`](https://npmcn.com/package/%40appfigures/cli/#readme-command-apple-ads-keywords) | 列出一个运动的竞价关键词,并列出每个关键词的性能(印象,相接,安装,花费,成本-每个安装)在一个日期范围内,加上它的匹配类型,出价,以及它是否是目标或负词. |
| [`af apple‑ads search‑terms`](https://npmcn.com/package/%40appfigures/cli/#readme-command-apple-ads-search-terms) | 列出触发竞选广告的实际用户搜索名词,每个名词都有其全时性能(印象,自带,安装,花用,成本-每站). 使用这些来发现新的关键词进行竞标或排除. |
| [`af apple‑ads report`](https://npmcn.com/package/%40appfigures/cli/#readme-command-apple-ads-report) | 报告苹果 在每个活动上标注性能(印象,自带,安装,花费,每个安装成本),外加一个全账户总计,在日期范围内. |
| [`af apple‑ads top‑keywords`](https://npmcn.com/package/%40appfigures/cli/#readme-command-apple-ads-top-keywords) | 通过转换率对竞选的顶级关键词进行排名,花费,并在一个日期范围内安装. 每个列表在一公尺上都持有顶级关键字. |

### 垫子

看看我们追踪的SDK.

| 命令 | 说明 |
| --- | --- |
| [`af sdks list`](https://npmcn.com/package/%40appfigures/cli/#readme-command-sdks-list) | 列出所有已知的 SDK 及其 ID, 或搜索以找到一个特定 . |

### 文档

具体行动和共同任务的参考文件和指南.

| 命令 | 说明 |
| --- | --- |
| [`af docs get`](https://npmcn.com/package/%40appfigures/cli/#readme-command-docs-get) | 以弹片返回参考医生或导师. |

### API 密码

| 命令 | 说明 |
| --- | --- |
| [`af api`](https://npmcn.com/package/%40appfigures/cli/#readme-command-api) | 制作一个没有专用命令的端点的原始 API 请求. 端点、参数和反应形状记录在 [页:1](https://docs.appfigures.com/)。 。 。 . |

### MCP 磁共振

| 命令 | 说明 |
| --- | --- |
| [`af mcp`](https://npmcn.com/package/%40appfigures/cli/#readme-command-mcp) | (已过期) 运行一个本地的 MCP 服务器在 stdio 之上 。 使用主机的 Appmagits MCP 服务器 : [https://mcp.appigits.com/mcp 页面存档备份,存于互联网档案馆](https://mcp.appfigures.com/mcp) |

### 认证

| 命令 | 说明 |
| --- | --- |
| [`af auth login`](https://npmcn.com/package/%40appfigures/cli/#readme-command-auth-login) | 签名到配置 |
| [`af auth logout`](https://npmcn.com/package/%40appfigures/cli/#readme-command-auth-logout) | 删除已存储的证书 |
| [`af auth status`](https://npmcn.com/package/%40appfigures/cli/#readme-command-auth-status) | 显示认证和账户状态 |

运行 `af <command> --help` 用于论证、旗帜和实例.

## 环境

| 变量 | 目的 |
| --- | --- |
| `APPFIGURES_API_KEY` | API 密钥; 跳过交互式认证 |
| `AF_VERBOSE` | 将 HTTP 日志为 stderr (与 `-v`(中文(简体) ) |
| `NO_COLOR` | 禁用 ANSI 颜色 |
| `NO_UPDATE_NOTIFIER` | 跳过 npm 注册更新检查 |
| `CI` | 也跳过更新检查( 任意 CI 系统) |

## API 参考

每个命令都有完整的参数和旗帜列表. 一行概览见 [图标](https://npmcn.com/package/%40appfigures/cli/#readme-commands) 见上文.

**全球旗帜.** 所有命令接受 :

-   `-v, --verbose` ——日志 HTTP 请求 stderr. 也通过 `AF_VERBOSE=1`。 。 。 .
-   `-V, --version` ——打印CLI版本并退出.
-   `-h, --help` 显示当前命令的用法 .

**输出格式.** 每个命令在 stdout 上发出一个 JSON 值—— 管道到 `jq` 用于过滤。 信息信息,提示, 和更新通知到 Stderr ,所以管道保持干净.

### af 应用程序搜索

`af apps search <q> [flags]`

按名称或出版商查找应用软件. 每个统一应用程序返回一行。 默认返回 Apple 和 Google 列表; 通过 `--all-stores` 包括其他商店。 要通过估计值过滤应用程序( 如上个月下载了 > 100k的应用程序) [`explorer list-products`](https://npmcn.com/package/%40appfigures/cli/#readme-command-explorer-list-products)用于按时间、国家或库存额分列的估计数 [`metrics query`](https://npmcn.com/package/%40appfigures/cli/#readme-command-metrics-query) 包含数据集估计数。 销售或估计.

**选项**

-   `<q>` 需要字符串。 搜索查询(应用名称或发布者).
-   `--all-stores` 布尔, 默认值 `false`. 包含苹果和谷歌以外的商店前端:亚马逊,Windows,Steam,Roku,LG TV,三星TV等.
-   `--count` 整数, 默认 `10`。返回的结果数量.
-   `--page` 整数, 默认 `1`。页码.

**实例**

```sh
# 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 应用程序获得

`af apps get <app-id> [flags]`

获得一个app的纪录:基本的元数据(名称,开发者等),如果用户跟踪,他们可以访问哪些数据. 通过一个店面的产品ID;所有店面一起统一应用ID.

**选项**

-   `<app-id>` 需要的整数或字符串。 该应用程序的统一应用ID或产品ID.
-   `--all-stores` 布尔, 默认值 `false`. 对于一个统一的app ID:包括跨所有商店前端(Amazon,Steam,Windows,Roku等)的成员产品. 当假的, `member_products` 仅限有应用智能覆盖(iOS + Google Play)的存储面. 产品ID被忽略.

**实例**

```sh
# 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 跟踪应用程序

`af apps tracked [flags]`

列出您的 Appgits 账户轨迹 .

**选项**

-   `--count` 整数, 默认 `10`。返回的结果数量.
-   `--page` 整数, 默认 `1`。页码.
-   `--q` 绳子。 要过滤的 App 名称 .
-   `--filter-apps-by-id` (整数或弦) \[. 只包括特定应用软件的数据,通过产品ID或统一应用ID. 以其他为准 `filterAppsBy*` 设置时键。 Storefront, source, 或type filters 更适合应用集.
-   `--filter-apps-by-storefront` 字符串\[\]. 将账户的跟踪应用缩小到这些店面上的那些(如:苹果:ios,google play).
-   `--filter-apps-by-source` 字符串\[\]. 通过跟踪关系来缩小账户的跟踪应用.
-   `--filter-apps-by-type` 字符串\[\]. 将账户的跟踪应用 缩小到这些类型的产品.

**实例**

```sh
# 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 应用程序分解

`af apps breakdown [flags]`

按数据组(如销售量,使用量,排名,评论量,关键词),存储前置,货币化模型,和源(你的对被跟踪的竞争者)计算出你的有跟踪的应用,外加总和最早的发布日期.

**选项**

-   `--filter-apps-by-id` (整数或弦) \[. 只包括特定应用软件的数据,通过产品ID或统一应用ID. 以其他为准 `filterAppsBy*` 设置时键。 Storefront, source, 或type filters 更适合应用集.
-   `--filter-apps-by-storefront` 字符串\[\]. 将账户的跟踪应用缩小到这些店面上的那些(如:苹果:ios,google play).
-   `--filter-apps-by-source` 字符串\[\]. 通过跟踪关系来缩小账户的跟踪应用.
-   `--filter-apps-by-type` 字符串\[\]. 将账户的跟踪应用 缩小到这些类型的产品.

**实例**

```sh
# Check what data the whole account has.
af apps breakdown

# Limit to apps you own or that were shared with you.
af apps breakdown --filter-apps-by-source=own,shared

# Limit to your iOS apps.
af apps breakdown --filter-apps-by-storefront=apple:ios
```

* * *

### af 探险家列表产品

`af explorer list-products [flags]`

为一个或许多应用程序读取目录字段 。 引用字段 `query` 或者说 `sort` 自动返回; 通过 `--extra-fields` 为了更多。 使用 `["match","product_id",<id>]` 用于一个单一的应用程序,或者合并用于人口查询的过滤器(例如使用Firebase的iOS应用程序和1M+美国收入). 120+字段横跨排名、评级、下载和收入估计、SDK、人口统计等等;查询语法和字段列表 [`docs get catalog_playbook`](https://npmcn.com/package/%40appfigures/cli/#readme-command-docs-get)。 。 。 .

**选项**

-   `--query` 数组, 默认值 `[]`。以 JSON 数组格式进行探索查询,以选择匹配的目录产品。 活动产品默认值 。 包含不活动 : \[“ match” “ mactive” , \[“ or”, true, false\]\]\]。 完整字段列表和查询语法在以下文件中记录: [`docs get catalog_playbook`](https://npmcn.com/package/%40appfigures/cli/#readme-command-docs-get)。 。 。 .
-   `--extra-fields` 字符串\[\]. 包含在您的 `query` 或者说 `sort` 已经引用。 查找字段路径( 以及您可以读取的路径) [`explorer describe-fields`](https://npmcn.com/package/%40appfigures/cli/#readme-command-explorer-describe-fields)。 。 。 .
-   `--sort` 绳子。 探索者字段名称 。 完整字段清单载于 [`docs get catalog_playbook`](https://npmcn.com/package/%40appfigures/cli/#readme-command-docs-get)。 。 。 .
-   `--order` 字符串, 默认 `desc`排序方向.
-   `--count` 整数, 默认 `10`。返回的结果数量.
-   `--page` 整数, 默认 `1`。页码.
-   `--allow-unscoped-nested` 布尔, 默认值 `false`. 故意进行广泛查询的逃生舱。 绕过默认块于通常会膨胀结果的无镜巢上上游.

**实例**

```sh
# 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 探险家总产品

`af explorer aggregate-products <fields> [flags]`

在苹果、Google Play、Amazon及其他主要商店的数百万产品全目录中, 使用与 [`explorer list-products`](https://npmcn.com/package/%40appfigures/cli/#readme-command-explorer-list-products);返回总量,而不是产品记录。 用于市场规模、基准和部门分析.

**选项**

-   `<fields>` 需要字符串\[\]。 Field+聚合对(例如. `all_rating/stats`, (中文(简体) ), `storefronts/terms`合计数: `stats`, (中文(简体) ), `terms`, (中文(简体) ), `histogram`, (中文(简体) ), `date_histogram`, (中文(简体) ), `cardinality`。完整字段清单在 [`docs get catalog_playbook`](https://npmcn.com/package/%40appfigures/cli/#readme-command-docs-get)。 。 。 .
-   `--query` 数组, 默认值 `[]`。以 JSON 数组格式进行探索查询,以选择匹配的目录产品。 活动产品默认值 。 包含不活动 : \[“ match” “ mactive” , \[“ or”, true, false\]\]\]。 完整字段列表和查询语法在以下文件中记录: [`docs get catalog_playbook`](https://npmcn.com/package/%40appfigures/cli/#readme-command-docs-get)。 。 。 .
-   `--allow-unscoped-nested` 布尔, 默认值 `false`. 故意进行广泛查询的逃生舱。 绕过默认块于通常会膨胀结果的无镜巢上上游.
-   `--terms-count` 整数, 默认 `20`返回最大桶数 `terms` 汇总。 其他聚合类型忽略了它.
-   `--date-histogram-interval` 绳子。 每个小桶颗粒度 `date_histogram` 汇总。 其他聚合类型忽略了它.

**实例**

```sh
# 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 探险家描述域

`af explorer describe-fields [flags]`

列出目录字段和当前用户的每个访问级别 。 以关键字搜索查找字段 。 同一个字段集 [`explorer list-products`](https://npmcn.com/package/%40appfigures/cli/#readme-command-explorer-list-products) 财务报告和审定财务报表 [`explorer aggregate-products`](https://npmcn.com/package/%40appfigures/cli/#readme-command-explorer-aggregate-products) 接受 .

**选项**

-   `--count` 整数, 默认 `50`。返回的结果数量.
-   `--page` 整数, 默认 `1`。页码.
-   `--q` 绳子。 过滤器由 `path`, (中文(简体) ), `title`, (中文(简体) ), `description`, (中文(简体) ), `type`。 。 。 .

**实例**

```sh
# 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 度量衡查询

`af metrics query <dataset> [flags]`

查询一个或多个应用程序的任何数字数据集 。 可选分组最多可分出两个维度,返回后作为被嵌入的分区树,而不是应用记录. 可按国家、设备类型和日期范围独立过滤. `filterAppsBy*` 选项缩小应用程序集(通过ID, storefront, source, 或类型);没有选项,则查询覆盖每个应用程序的账户音轨.

**选项**

-   `<dataset>` 需要字符串。 要查询的数据集( 如销售量 。 complex downloads) 。 见 [`metrics describe-datasets`](https://npmcn.com/package/%40appfigures/cli/#readme-command-metrics-describe-datasets) 用于完整列表,以及哪些数据集是私有数据(仅可观察到您拥有的或共享的应用程序).
-   `--group-by` 字符串\[\]. 组的尺寸 Max 2: 第1个槽成为外实体类型,第二个是内相系列. 每个维相乘结果大小.
-   `--granularity` 绳子。 按日期分组时的时间颗粒性
-   `--count` 整数。 行盖. 与 `--group-by`,以数值表示的外部实体类型的上 N (在按日期分组时最早 N)。 无 `--group-by`,单页预览.
-   `--countries` 字符串\[\]. 过滤到一个或多个 ISO 国家代码( 如 US, JP, GB)
-   `--device-type` 绳子。 设备类型
-   `--all-time` 布尔, 默认值 `false`进入整个历史 没有这个旗帜( 没有) `start`编号 :`end`),查询默认为最近30天。 相互独占 `start` 财务报告和审定财务报表 `end`。 。 。 .
-   `--filter-apps-by-id` (整数或弦) \[. 只包括特定应用软件的数据,通过产品ID或统一应用ID. 以其他为准 `filterAppsBy*` 设置时键。 Storefront, source, 或type filters 更适合应用集.
-   `--filter-apps-by-storefront` 字符串\[\]. 将账户的跟踪应用缩小到这些店面上的那些(如:苹果:ios,google play).
-   `--filter-apps-by-source` 字符串\[\]. 通过跟踪关系来缩小账户的跟踪应用.
-   `--filter-apps-by-type` 字符串\[\]. 将账户的跟踪应用 缩小到这些类型的产品.
-   `--start` 绳子。 开始日期( YYYY- MM- DD)
-   `--end` 绳子。 结束日期( YYYY- MM- DD, 默认为今天)

**实例**

```sh
# 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 度量衡描述数据集

`af metrics describe-datasets [flags]`

列出每个数字数据集 [`metrics query`](https://npmcn.com/package/%40appfigures/cli/#readme-command-metrics-query) 接受,每个数据集一行带有其值类型,是否仅限于自己的应用程序.

**选项**

-   `--count` 整数, 默认 `50`。返回的结果数量.
-   `--page` 整数, 默认 `1`。页码.
-   `--q` 绳子。 过滤器由 `dataset`, (中文(简体) ), `value_type`, (中文(简体) ), `label`, (中文(简体) ), `description`。 。 。 .

**实例**

```sh
# 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 存储应用

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

追踪一国或多国应用程序的排名历史,设备类型,类别子类型,以及类别,作为时间序列位置并带有日复一日的三角洲.

**选项**

-   `<app-ids>` 需要(整数或字符串)\[。 App标识符(统一应用ID或产品ID)
-   `--countries` 字符串\[\]. 国家代码查询. 对每个有级别覆盖的国家来说都是默认的.
-   `--granularity` 字符串, 默认 `hourly`. 采样率。 小时给出最新数据; 通过 `--granularity=daily` 用于压缩多日历史.
-   `--device-types` 字符串\[\],默认 `["handheld"]`。将包含哪些设备类型;在自己的图表中,每个设备的排名。 添加更多内容以扩大响应范围.
-   `--subtypes` 字符串\[\],默认 `["free","paid"]`中,将包含哪些类别子类型;在自己的图表中,每个级别。 添加更多内容以扩大响应范围.
-   `--category-ids` 整数\[\]. 过滤特定类别ID的响应行; 全部省略 。 类别ID来自 [`store categories`](https://npmcn.com/package/%40appfigures/cli/#readme-command-store-categories)。 。 。 .
-   `--start` 绳子。 开始日期( YYYY- MM- DD)
-   `--end` 绳子。 结束日期( YYYY- MM- DD, 默认为今天)
-   `--count` 整数, 默认 `10`。返回的结果数量.
-   `--page` 整数, 默认 `1`。页码.

**实例**

```sh
# 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 存储上图

`af store top-charts [flags]`

在给定的国家和类别分类图中列出顶端应用程序,并列出当前位置和日常三角洲.

**选项**

-   `--country` 需要字符串。 ISO 国家代码(例如美国,JP,GB)
-   `--category-id` 需要的整数。 类别ID来自 [`store categories`](https://npmcn.com/package/%40appfigures/cli/#readme-command-store-categories)。 。 。 .
-   `--subtype` 字符串, 默认 `free`. 类别子类型(类别内的图表变体).
-   `--date` 绳子。 快照日期(YYY-MM-DD,默认为当前).
-   `--count` 整数, 默认 `10`。返回的结果数量.
-   `--page` 整数, 默认 `1`。页码.

**实例**

```sh
# 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 存储类别

`af store categories [flags]`

列出每个存储类别及其ID。 所需数字类ID [`store app-ranks --category-ids`](https://npmcn.com/package/%40appfigures/cli/#readme-command-store-app-ranks) 财务报告和审定财务报表 [`store top-charts --category-id`](https://npmcn.com/package/%40appfigures/cli/#readme-command-store-top-charts) 这里有.

**选项**

-   `--count` 整数, 默认 `50`。返回的结果数量.
-   `--page` 整数, 默认 `1`。页码.
-   `--q` 绳子。 过滤器由 `name`。 。 。 .
-   `--sort` 绳子。 田地来排序。 何时按相关性排序 `q` 设置,否则列表顺序.
-   `--order` 字符串, 默认 `desc`排序方向.
-   `--category-id` 整数\[\]. 只返回这些类别ID.
-   `--parent-id` 整数。 仅包括此父类的子类(由 id 来打倒).
-   `--storefront` 字符串\[\]. 仅包括这些商店前端的类别(如:. `apple:ios`, (中文(简体) ), `google_play`) (中文(简体) ).
-   `--device-type` 字符串\[\]. 只包括这些设备类型的类别(例如. `handheld`, (中文(简体) ), `tablet`) (中文(简体) ).
-   `--all` 布尔, 默认值 `false`,包括非排名的商店(roku,vizio等). 这些有类别,但没有等级数据.

**实例**

```sh
# 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 存储功能

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

应用程序或商店前期产品的专栏和编辑位置。 只请求摘要统计的0行.

**选项**

-   `<app-id>` 需要的整数或字符串。 该应用程序的统一应用ID或产品ID.
-   `--countries` 字符串\[\]. 拟包括的国家。 仅询问美国,或通过多个来比较市场。 包括每个国家,设定 `--all-countries` 换句话说.
-   `--all-countries` 布尔, 默认值 `false`包括每个国家。 无法结合 `--countries`。 。 。 .
-   `--include-rank-trend` 布尔, 默认值 `false`。包括每个职位的每个间隔级别.
-   `--sort` 字符串, 默认 `relevance`按相关性或日期排序位置.
-   `--order` 字符串, 默认 `desc`排序方向.
-   `--start` 绳子。 开始日期( YYYY- MM- DD)
-   `--end` 绳子。 结束日期(YYY-MM-DD,默认为今天). 间谍最多31天.
-   `--count` 整数, 默认 `10`。返回的结果数量.
-   `--page` 整数, 默认 `1`。页码.

**实例**

```sh
# 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 存储应用程序列表

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

读取一个商店前端的完整商店列表:本地化文本(名称,字幕,描述,发行注释)外加截图,视频,分类,货币化,支持设备,国家可用性,价格,收视率,文件大小,以及年龄评级. 取一个数字产品ID(一次一个商店前门;一个统一的应用程序每个商店前门有一个产品). 每个请求一个地方.

**选项**

-   `<product-id>` 需要的整数。 一个店面的数字产品ID。 不是统一的应用ID。 成员产值 id值来自 [`apps get '<unified-app-id>'`](https://npmcn.com/package/%40appfigures/cli/#readme-command-apps-get)。 。 。 .
-   `--language` 绳子。 地语(如en, ja,zh-Hans),用于名称,字幕,描述,放出注释和截图. 默认为 en; 当请求的地址没有元数据时, 返回到第一个可用的地址 。 反应与决心的语言一致.
-   `--device-type` 字符串, 默认 `handheld`. 与苹果应用相关. 为iPhone特定元数据选择手持设备,为iPad选择平板电脑,为Mac选择桌面等.

**实例**

```sh
# 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 受众人口统计

`af audience demographics <app-id>`

阅读一个应用的受众人口统计:估计年龄和性别的分解.

**选项**

-   `<app-id>` 需要的整数或字符串。 该应用程序的统一应用ID或产品ID.

**实例**

```sh
# 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 观众交叉使用

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

查找应用程序用户也使用的应用程序 .

**选项**

-   `<app-id>` 需要的整数或字符串。 该应用程序的统一应用ID或产品ID.
-   `--count` 整数, 默认 `10`。返回的结果数量.
-   `--page` 整数, 默认 `1`。页码.

**实例**

```sh
# 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 审查清单

`af reviews list [flags]`

阅读一个或多个应用程序的个别评论. 返回审查文本、星标、国家、应用程序版本以及您的回复。 按恒星评级,日期范围,国家,版本,响应状态,以及跟踪关系可过滤.

**选项**

-   `--stars` 编号\[\]。 按恒星评分过滤.
-   `--versions` 字符串\[\]. 通过应用版本过滤. 传多相以合.
-   `--countries` 字符串\[\]. 过滤到一个或多个ISO国家代码(如美国,JP,GB).
-   `--q` 绳子。 搜索审查标题和正文. 传出多个关键字以匹配任意一个 。 对大小写不敏感;与其他过滤器结合.
-   `--response-status` 绳子。 通过是否响应过滤 。 同意包括所有评论.
-   `--sort` 绳子。 按审查日期或星等排序.
-   `--order` 字符串, 默认 `desc`排序方向.
-   `--filter-apps-by-id` (整数或弦) \[. 只包括特定应用软件的数据,通过产品ID或统一应用ID. 以其他为准 `filterAppsBy*` 设置时键。 Storefront, source, 或type filters 更适合应用集.
-   `--filter-apps-by-storefront` 字符串\[\]. 将账户的跟踪应用缩小到这些店面上的那些(如:苹果:ios,google play).
-   `--filter-apps-by-source` 字符串\[\]. 通过跟踪关系来缩小账户的跟踪应用.
-   `--filter-apps-by-type` 字符串\[\]. 将账户的跟踪应用 缩小到这些类型的产品.
-   `--start` 绳子。 开始日期( YYYY- MM- DD)
-   `--end` 绳子。 结束日期( YYYY- MM- DD, 默认为今天)
-   `--count` 整数, 默认 `10`。返回的结果数量.
-   `--page` 整数, 默认 `1`号码是1 -500.

**实例**

```sh
# 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

# Find your 1-2 star reviews without a response.
af reviews list --filter-apps-by-source=own --stars=1,2 --response-status=without_response
```

* * *

### af 审查细目

`af reviews breakdown [flags]`

一个或数个应用软件的汇总审查按尺寸计算。 返回每维值一个计数,加上一组对应的全局总数.

**选项**

-   `--stars` 编号\[\]。 按恒星评分过滤.
-   `--versions` 字符串\[\]. 通过应用版本过滤. 传多相以合.
-   `--countries` 字符串\[\]. 过滤到一个或多个ISO国家代码(如美国,JP,GB).
-   `--q` 绳子。 搜索审查标题和正文. 传出多个关键字以匹配任意一个 。 对大小写不敏感;与其他过滤器结合.
-   `--response-status` 绳子。 通过是否响应过滤 。 同意包括所有评论.
-   `--filter-apps-by-id` (整数或弦) \[. 只包括特定应用软件的数据,通过产品ID或统一应用ID. 以其他为准 `filterAppsBy*` 设置时键。 Storefront, source, 或type filters 更适合应用集.
-   `--filter-apps-by-storefront` 字符串\[\]. 将账户的跟踪应用缩小到这些店面上的那些(如:苹果:ios,google play).
-   `--filter-apps-by-source` 字符串\[\]. 通过跟踪关系来缩小账户的跟踪应用.
-   `--filter-apps-by-type` 字符串\[\]. 将账户的跟踪应用 缩小到这些类型的产品.
-   `--start` 绳子。 开始日期( YYYY- MM- DD)
-   `--end` 绳子。 结束日期( YYYY- MM- DD, 默认为今天)
-   `--by` 字符串\[\]. 限制这些维度的响应; 省略返回全部 .
-   `--top` 整数, 默认 `20`。每个维度返回的最大值;其余值在 `__other__`。 。 。 .

**实例**

```sh
# 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 审查答复

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

发送或撤回特定审查的开发者回复. 过 `content` 调出; 通过 `delete: true` 撤回先前的回复.

**选项**

-   `<review-id>` 需要字符串。 进行审查以采取行动。 使用 `review_id` 从 [`reviews list`](https://npmcn.com/package/%40appfigures/cli/#readme-command-reviews-list)。 。 。 .
-   `--content` 绳子。 开发者想要发布的响应文本 .
-   `--delete` 布尔。 撤回先前就这次审查作出的答复。 相互独占 `content`。 。 。 .

**实例**

```sh
# 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 有机关键词

`af keywords organic [flags]`

请检查access-date=中的日期值 (帮助) 有机关键词 一个或多个应用名列前茅 位置 受欢迎度 竞争力.

**选项**

-   `--product-ids` 整数\[\]. 产品标识符(数字,各一库).
-   `--countries` 需要字符串\[\]。 一个或多个ISO国家代码(例如美国,JP,GB). 传几回去比较市场.
-   `--device-type` 绳子。 设备类型
-   `--count` 整数, 默认 `10`. 返回的结果数量(分10分).
-   `--page` 整数, 默认 `1`。页码.

**实例**

```sh
# 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 已支付的关键字

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

列出付费关键字 一个或多个应用程序运行广告, 并带有印象共享和有机排序 .

**选项**

-   `<product-ids>` 需要的整数。 产品标识符(数字,各一库).
-   `--days` 整数, 默认 `180`数天的回顾期 常见值:7,14,30,90,180,365.
-   `--countries` 需要字符串\[\]。 一个或多个ISO国家代码(例如美国,JP,GB). 传几回去比较市场.
-   `--device-types` 字符串\[\]. 按设备类型过滤 。 默认为手持设备 .
-   `--count` 整数, 默认 `10`. 返回的结果数量(分10分).
-   `--page` 整数, 默认 `1`。页码.

**实例**

```sh
# 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 关键词跟踪排名

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

查看您所有履带关键词在单个app+country组合中的排名, 每个关键词的当前位置, 自上次改变以来的移动, 起始位置, 受欢迎度, 以及竞争力 .

**选项**

-   `<product-id>` 需要的整数。 一个店面的数字产品ID。 不是统一的应用ID。 成员产值 id值来自 [`apps get '<unified-app-id>'`](https://npmcn.com/package/%40appfigures/cli/#readme-command-apps-get)。 。 。 .
-   `--country` 需要字符串。 ISO 国家代码(例如美国,JP,GB)
-   `--device-type` 绳子。 读取顺序的设备 。 关闭使用商店默认值 .
-   `--count` 整数, 默认 `10`. 返回的结果数量(分10分).
-   `--page` 整数, 默认 `1`。页码.
-   `--sort` 绳子。 现场命令结果由.
-   `--order` 字符串, 默认 `desc`排序方向.
-   `--start` 绳子。 窗口启动(YYY-MM-DD). 关闭最近7天的射程;起跑日期的军衔为起跑位置基线.
-   `--end` 绳子。 窗口结束(YYY-MM-DD,默认为今天). 间谍最多31天.
-   `--keyword-term` 绳子。 只包括含有此文本的有轨关键词.
-   `--min-position` 整数。 最佳军衔包括(1=上等).
-   `--max-position` 整数。 最差的军衔.
-   `--min-popularity` 整数。 最低的受欢迎程度包括(0-100).
-   `--max-popularity` 整数。 最受欢迎的包括(0-100).
-   `--min-competitiveness` 整数。 竞争力最低,包括(0-100).
-   `--max-competitiveness` 整数。 包括的竞争力最高(0-100).

**实例**

```sh
# 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 跟踪趋势的关键词

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

追踪单个app+country组合中一个关键词的分级如何随时间变化. 每一点都给出了从前作起它所移动的级别和多少位置.

**选项**

-   `<keyword-id>` 需要字符串。 关键词要追踪。 必须追踪这个应用程序和国家;其不透明的ID来自 [`keywords tracked-ranks`](https://npmcn.com/package/%40appfigures/cli/#readme-command-keywords-tracked-ranks) 或者说 [`keywords tracked`](https://npmcn.com/package/%40appfigures/cli/#readme-command-keywords-tracked)。 。 。 .
-   `--product-id` 需要的整数。 一个店面的数字产品ID。 不是统一的应用ID。 成员产值 id值来自 [`apps get '<unified-app-id>'`](https://npmcn.com/package/%40appfigures/cli/#readme-command-apps-get)。 。 。 .
-   `--country` 需要字符串。 ISO 国家代码(例如美国,JP,GB)
-   `--device-type` 绳子。 读取顺序的设备 。 关闭使用商店默认值 .
-   `--granularity` 字符串, 默认 `daily`. 采样率.
-   `--start` 绳子。 窗口启动(YYY-MM-DD). 过去7天的射程.
-   `--end` 绳子。 窗口结束(YYY-MM-DD,默认为今天). 每小时颗粒量最多14天,每天31天.

**实例**

```sh
# 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 关键词建议

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

发现关键词想法,以考虑锁定一个单一的app+country 组合,按照与该应用程序的关联性排序,并包括一些取自与您竞争的应用程序. 每个都伴随着它的受欢迎度,竞争力,以及应用的当前级别.

**选项**

-   `<product-id>` 需要的整数。 一个店面的数字产品ID。 不是统一的应用ID。 成员产值 id值来自 [`apps get '<unified-app-id>'`](https://npmcn.com/package/%40appfigures/cli/#readme-command-apps-get)。 。 。 .
-   `--country` 需要字符串。 ISO 国家代码(例如美国,JP,GB)
-   `--device-type` 绳子。 读取顺序的设备 。 关闭使用商店默认值 .
-   `--count` 整数, 默认 `10`。返回的结果数量.
-   `--page` 整数, 默认 `1`。页码.

**实例**

```sh
# 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 关键词排序应用程序

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

列出应用程序在有机搜索中特定关键词的排名,并加上关键词本身的受欢迎度和竞争力分数.

**选项**

-   `<keyword-term>` 需要字符串。 举起手来.
-   `--country` 需要字符串。 ISO 国家代码(例如美国,JP,GB)
-   `--storefront` 需要字符串。 App商店平台(如:苹果:ios,google play,amazon appstore,蒸汽,窗口10,苹果:mac,苹果:tv,苹果:imesage,或另一个被支持的商店前端).
-   `--device-type` 绳子。 设备类型
-   `--count` 整数, 默认 `10`。返回的结果数量.
-   `--page` 整数, 默认 `1`。页码.

**实例**

```sh
# 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 关键词广告商

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

列出特定关键字的应用广告,并列出每个广告商的印象分享,有机排名,以及他们投标的时间.

**选项**

-   `<keyword-term>` 需要字符串。 寻找广告商的关键词
-   `--days` 整数, 默认 `180`数天的回顾期 常见值:7,14,30,90,180,365.
-   `--country` 需要字符串。 ISO 国家代码(例如美国,JP,GB)
-   `--device-type` 绳子。 设备类型
-   `--count` 整数, 默认 `10`。返回的结果数量.
-   `--page` 整数, 默认 `1`。页码.

**实例**

```sh
# 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 关键词

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

查找与ASO研究的种子名词相關的关键词. 用于寻找具有类似受众的更受欢迎或竞争力更弱的替代品.

**选项**

-   `<keyword-term>` 需要字符串。 有种子关键字可以找到相关的名词.
-   `--country` 需要字符串。 ISO 国家代码(例如美国,JP,GB)
-   `--storefront` 需要字符串。 App商店平台(如:苹果:ios,google play,amazon appstore,蒸汽,窗口10,苹果:mac,苹果:tv,苹果:imesage,或另一个被支持的商店前端).
-   `--device-type` 绳子。 设备类型
-   `--count` 整数, 默认 `10`。返回的结果数量.
-   `--page` 整数, 默认 `1`。页码.

**实例**

```sh
# 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 跟踪关键字

`af keywords tracked [flags]`

列出带有不透明身份的跟踪关键词.

**选项**

-   `--count` 整数, 默认 `10`。返回的结果数量.
-   `--page` 整数, 默认 `1`。页码.
-   `--q` 绳子。 过滤器由 `keyword_term`。 。 。 .
-   `--sort` 绳子。 田地来排序。 何时按相关性排序 `q` 设置,否则列表顺序.
-   `--order` 字符串, 默认 `desc`排序方向.
-   `--include-relationships` 布尔, 默认值 `false`。包含每个行(产品、国家)的跟踪细节和同步状态。 默认关闭; 每对有轨电车( 产品, 国家) 添加一个嵌入区块 .

**实例**

```sh
# 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 关键字跟踪

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

追踪一个关键词,以监视您的应用程序的小时级别,并当其位置移动时获得自动警报.

**选项**

-   `<keyword-term>` 需要字符串。 开始跟踪的关键字
-   `--product-id` 需要的整数。 用于跟踪关键字的应用程序产品ID
-   `--country` 需要字符串。 ISO 国家代码(例如美国,JP,GB)

**实例**

```sh
# 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 关键字未跟踪

`af keywords untrack <keyword-id>`

停止跟踪关键字 .

**选项**

-   `<keyword-id>` 需要字符串。 跟踪关键字行的标识符(由 [`keywords tracked`](https://npmcn.com/package/%40appfigures/cli/#readme-command-keywords-tracked)) (中文(简体) ). 不是关键词文本.

**实例**

```sh
# Stop tracking a keyword.
af keywords untrack a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6
```

* * *

### af 苹果组织

`af apple-ads organizations [flags]`

列出您管理的 Apple Ads 组织, 以及每个人的货币和时区.

**选项**

-   `--count` 整数, 默认 `10`。返回的结果数量.
-   `--page` 整数, 默认 `1`。页码.

**实例**

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

* * *

### 苹果宣传运动

`af apple-ads campaigns [flags]`

列出您的 Apple Ads 活动, 包括每个人的状态、预算、目标国家以及时间表.

**选项**

-   `--display-status` 绳子。 过滤到一个状态的运动 。 包括所有状态.
-   `--name` 绳子。 过滤到名称包含此文本的活动 .
-   `--countries` 字符串\[\]. 过滤针对其中任何一个国家的活动.
-   `--count` 整数, 默认 `10`。返回的结果数量.
-   `--page` 整数, 默认 `1`。页码.

**实例**

```sh
# 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-ads 广告组

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

列出苹果 广告组 每人的默认出价,CPA上限,定价模式,和时间表.

**选项**

-   `[campaign-id]` 绳子。 在一个运动中,广告团体的范围.
-   `--display-status` 绳子。 过滤到一个状态的广告组 。 包括所有状态.
-   `--name` 绳子。 过滤到名称包含此子字符串的广告组 .
-   `--count` 整数, 默认 `10`。返回的结果数量.
-   `--page` 整数, 默认 `1`。页码.

**实例**

```sh
# 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 关键词

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

列出一个运动的竞价关键词,并列出每个关键词的性能(印象,相接,安装,花费,成本-每个安装)在一个日期范围内,加上它的匹配类型,出价,以及它是否是目标或负词.

**选项**

-   `<campaign-id>` 需要字符串。 竞技队的竞技关键词.
-   `--ad-group-id` 绳子。 过滤到一个广告组中的关键字 .
-   `--status` 绳子。 过滤到一个状态的关键字 。 包括所有状态.
-   `--match-type` 绳子。 过滤到一个匹配类型 。 把两者都包括在内.
-   `--name` 绳子。 过滤到其文本包含此子字符串的关键字 .
-   `--sort` 绳子。 按性能指标或出价顺序排列关键词. 先说最新消息.
-   `--order` 字符串, 默认 `desc`。 。

## 常见问题

### @appfigures/cli 是什么？

Appgits CLI — 查询应用程序的度量衡、评论和存储终端数据

### 如何安装 @appfigures/cli？

在项目目录运行 npm install @appfigures/cli，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 af、appfigures，可以用 npx af 直接运行。

### @appfigures/cli 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/appfigures\_\_cli 是否存在。

### @appfigures/cli 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @appfigures/cli 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @appfigures/cli 可以商用吗？

@appfigures/cli 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @appfigures/cli 的下载量有多少？

根据 npm 官方下载统计，@appfigures/cli 在 2026/10/07 – 2026/11/05 这 30 天内被下载 2,396 次，日均约 80 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @appfigures/cli 还在维护吗？

最新版本 4\.0\.0 发布于 2026/10/09（29 天前）；至今共发布 24 个版本，其中过去 12 个月发布了 24 个；首次发布于 2026/04/13。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。