Appfigures CLI: mobile app data
Appfigures CLI
The official Appfigures CLI and MCP: an agent pulls metrics, ranks, reviews and keywords from app stores
- 21 ★ on the repository
- Last commit
- Apache-2.0
Extended access
Why this level
- The `reviews reply` command posts developer replies to store reviews
- The Appfigures token opens account data on sales and Apple Ads campaigns
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/appfigures-cliDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The `reviews reply` command posts developer replies to store reviews
- The Appfigures token opens account data on sales and Apple Ads campaigns
This is third-party code. Review the repository files before installing.
What it does
Appfigures is a mobile app analytics service. The @appfigures/cli package brings its data to the terminal with the `appfigures` and `af` commands, and every command prints one JSON value that is easy to hand to an agent or to `jq`. Commands come in groups. `apps` searches apps and lists the ones you track. `explorer` works across a catalog of millions of apps from Apple, Google Play, Amazon and other stores with more than 120 fields. `metrics` computes numeric datasets by country and date. `store` shows rank history, category top charts, editorial placements and the listing. `reviews` reads reviews and posts developer replies. `keywords` tracks keyword ranks, and `apple-ads` breaks down Apple Ads campaigns. The same abilities come from the hosted MCP server at https://mcp.appfigures.com/mcp: sign in with an Appfigures account and nothing needs installing.
Who it is for. Mobile app owners and marketers who want to work through reviews, ASO and the market together with an agent.
Good fit when
- A release shipped and you need fresh low-rated reviews for that app version
- For ASO you want low-competition keywords and a look at who ranks for them
- Before entering a niche you need competitors' downloads and revenue estimates by country
- Apple Ads campaigns need breaking down by search term and cost per install
Not a fit when
- You only need the App Store Connect console for builds and TestFlight, which separate tools cover
- You have no Appfigures account and track no apps: your own sales and usage data is unavailable without it
- You want automatic replies to every review: `reviews reply` posts under the developer's name, so check the text
- Your Node.js is below version 22, which the package does not support
Example request
Show the one- and two-star reviews on my app from the last week and group them by complaint.Limitations
You need Node.js 22 or newer and an Appfigures account. Sign-in goes through a browser and the token is stored in the system credential store; scripts can use the `APPFIGURES_API_KEY` variable.
Public data spends credits and limits of the account, shared across the API, CLI and MCP.
The `af mcp` command for a local MCP server is deprecated and will be removed in the next major release. The README recommends the hosted server.
Run `af <command> --help` for each command's arguments and flags.
How to disable. Remove the package with npm uninstall -g @appfigures/cli and erase the token with af auth logout. Remove the MCP server with claude mcp remove appfigures.
FAQ
How do I install the Appfigures CLI?
Run npm install -g @appfigures/cli and sign in with appfigures auth login. To try it without installing use npx @appfigures/cli auth login. Node.js 22 or newer is required.
How do I connect MCP to Claude Code?
Run claude mcp add --transport http appfigures https://mcp.appfigures.com/mcp, then /mcp inside Claude Code and sign in to Appfigures. Nothing needs installing.
How do I authorize an agent without a browser?
af auth login prints a link where you approve access, and the agent finishes with af auth login --code. For unattended work set APPFIGURES_API_KEY.
What happens to af mcp?
It runs a local MCP server but is deprecated. New MCP features ship only in the hosted server.
What is the output format?
Every command prints one JSON value to stdout, with hints and notices on stderr, so output can go straight into jq.
Discussion
No questions or reviews yet.
Related
CLI toolsAsoBeast MCP server: an agent reads App Store and Google Play keyword ranks, competitors and the ASO queue of your instance.
Humblytics MCP gives an agent live site analytics, funnels and A/B tests plus 12 marketing skills for finding conversion problems.
One MCP server for ad accounts, analytics and CRM: Google Ads, Meta Ads, GA4, TikTok Ads and LinkedIn Ads
A dependency-free, mostly read-only MCP server for Metrika, Webmaster, Direct and Wordstat, with the token kept in Keychain
An MCP server, CLI and Pydantic models for the Yandex Metrika API: reports, counters, goals, filters, segments, logs and offline conversion uploads
MCP server for Google Ads: analyze campaigns, metrics and keywords with GAQL queries right in the chat with an agent
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Appfigures CLI: mobile app data (this card) | yes | 21 | ||
| App Store Connect MCP | no | API key | 5 | works with your own App Store Connect account, without market estimates for other apps |
| AsoBeast MCP Server | yes | API key | 142 | an MCP server from another ASO service with its own dataset |
README in short
The README presents four ways to bring Appfigures to an agent: tools for frameworks, a client library, the CLI and MCP. It then covers installation, sign-in, the hosted MCP server, tables of all commands by group and a detailed reference for each with examples.