Bir AI istemcisinin Appfigures hesaplarından ve uygulama kataloğundan uygulama analitiği, mağaza sıralamaları, incelemeler, anahtar kelimeler ve pazar istihbaratı sorgulamasını sağlar.
Ayrıca bilinen adı appfigures/cli, cli, @appfigures/cli
- Yıldızlar
- 21
- Araçlar
- —
- İndirmeler, 30 gün
- 2.268
- En son sürüm
- 4.0.0
- Son commit
- 9 Eki 2026
- Lisans
- Apache-2.0
Appfigures MCP nedir?
Appfigures bir MCP sunucusudur. Bir AI istemcisinin Appfigures hesaplarından ve uygulama kataloğundan uygulama analitiği, mağaza sıralamaları, incelemeler, anahtar kelimeler ve pazar istihbaratı sorgulamasını sağlar.
Özet, projenin README dosyasından oluşturuldu
Appfigures MCP sunucusu hakkında
Uygulama geliştiricileri ve pazar araştırmacıları, mobil uygulama analitiği, mağaza sıralamaları ve pazar istihbaratını doğrudan AI istemcileri üzerinden sorgulayabilirler. Barındırılan Appfigures MCP server'a bağlanarak kullanıcılar, yerel yazılım kurmaya gerek kalmadan Apple, Google Play ve Amazon verilerine erişebilirler. Bağlantı, kimlik doğrulama için bir Appfigures hesabı kullanılarak Claude veya ChatGPT gibi istemcilere uzak bir URL eklenerek kurulur.
Bu entegrasyon, milyonlarca ürün ve 120'den fazla veri alanı içeren devasa bir uygulama kataloğuna erişim sağlar. Kullanıcılar; indirme ve gelir tahminleri, hedef kitle demografisi ve anahtar kelime görünürlüğü gibi spesifik bilgileri geri çağırabilirler. Sunucu; katalog analizi için explorer, sayısal veri setleri için metrics ve mağaza geri bildirimlerini yönetmek için reviews dahil olmak üzere çeşitli özelleşmiş araçları destekler. Hem halka açık veri keşfine hem de kullanıcının belirli Appfigures hesabında takip edilen uygulamalar için özel veri erişimine olanak tanır.
Neler yapabilirsiniz
- 1Pazar trendlerini analiz edinAI istemcinizden belirli bir uygulama kategorisindeki indirme ve gelir tahminlerini bir araya getirmesini isteyin.
- 2Anahtar kelime performansını izleyinBir uygulamanın hangi organik anahtar kelimelerde sıralama aldığına ve bu kelimelerin güncel popülerliğine dair bir rapor talep edin.
- 3Uygulama mağazası incelemelerini yönetinBir AI agent'tan son kullanıcı geri bildirimlerini özetlemesini veya yıldız puanına göre filtrelenmiş incelemeleri listelemesini isteyin.
- 4Hedef kitle demografisini araştırınBir uygulamanın kullanıcı kitlesinin tahmini yaş ve cinsiyet dağılımını sorgulayın.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
Appfigures MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleAppfigures MCP'yi Claude Code içine yükleyin
$ claude mcp add --env 'APPFIGURES_API_KEY=<YOUR_APPFIGURES_API_KEY>' cli -- npx -y @appfigures/cliAppfigures MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"cli": {
"command": "npx",
"args": [
"-y",
"@appfigures/cli"
],
"env": {
"APPFIGURES_API_KEY": "<YOUR_APPFIGURES_API_KEY>"
}
}
}
}Appfigures MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"cli": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@appfigures/cli"
],
"env": {
"APPFIGURES_API_KEY": "<YOUR_APPFIGURES_API_KEY>"
}
}
}
}Appfigures MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"cli","type":"stdio","command":"npx","args":["-y","@appfigures/cli"],"env":{"APPFIGURES_API_KEY":"<YOUR_APPFIGURES_API_KEY>"}}'Appfigures MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"cli": {
"command": "npx",
"args": [
"-y",
"@appfigures/cli"
],
"env": {
"APPFIGURES_API_KEY": "<YOUR_APPFIGURES_API_KEY>"
}
}
}
}Appfigures MCP'yi Codex içine yükleyin
$ codex mcp add cli --env 'APPFIGURES_API_KEY=<YOUR_APPFIGURES_API_KEY>' -- npx -y @appfigures/cliAppfigures MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.cli] command = "npx" args = ["-y", "@appfigures/cli"] [mcp_servers.cli.env] APPFIGURES_API_KEY = "<YOUR_APPFIGURES_API_KEY>"
Appfigures MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user -e 'APPFIGURES_API_KEY=<YOUR_APPFIGURES_API_KEY>' cli npx -- -y @appfigures/cliAppfigures MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"cli": {
"command": "npx",
"args": [
"-y",
"@appfigures/cli"
],
"env": {
"APPFIGURES_API_KEY": "<YOUR_APPFIGURES_API_KEY>"
}
}
}
}Yapılandırma
APPFIGURES_API_KEYGizliAppfigures personal access token. Optional; omit it to sign in with `af auth login` instead. Read more at https://help.appfigures.com/en/article/1chf6wf
| Ad | Açıklama | Sunucu |
|---|---|---|
| APPFIGURES_API_KEY | Appfigures personal access token. Optional; omit it to sign in with `af auth login` instead. Read more at https://help.appfigures.com/en/article/1chf6wf | Gizli |
Otomatik kontroller
Çalıştırıldı 13 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirGeçti
- Açık kaynak lisansı (OSI)Geçti
- Son bir yıl içinde commit veya sürüm mevcutGeçti
- Paket adı popüler bir pakete yakın değilGeçti
- Uzak uç nokta HTTPS kullanıyorGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Modele yönelik gizli talimat yokGeçti
- Pakette veya bağımlılıklarında kritik uyarı yokGeçti
@appfigures/cli
The Appfigures CLI — query app metrics, reviews, and store data from your terminal.
Try it now without installing:
npx @appfigures/cli auth login
npx @appfigures/cli apps search "youtube"
✨ Four ways to use the power of Appfigures AI
Bring Appfigures into your agent however it's built — as tools it calls, code it writes, a CLI, or over MCP. Whichever you pick, you can do the same things and get the same JSON back.
- 🛠️ Agent tools — your agent calls Appfigures as tools while it runs. AI SDK, OpenAI, LangChain. → Add the tools
- 📦 The client — your agent writes code that queries Appfigures and gets typed data back. → Use the client
- 🖥️ CLI — run Appfigures from a terminal or a sandbox. →
@appfigures/cli - 🔌 MCP — connect Appfigures to Claude, ChatGPT, or Cursor. → Connect the hosted server
Install
npm install -g @appfigures/cli
Requires Node.js 22+. Works with pnpm and yarn too.
Quick start
appfigures auth login
appfigures --help
Also available as af alias.
Authentication
- Log in yourself.
af auth login --interactiveopens your browser in a guided flow; approve and paste the code back. - Or let your agent guide you. By default,
af auth loginprints an authorization URL — open it, approve, and finish withaf auth login --code <code>using the code shown. An agent can drive this end to end. For unattended use, setAPPFIGURES_API_KEYinstead: create a token at appfigures.com/developers/keys by clicking Create a New Client, then Create Personal Access Token.
Either login saves the token to your OS credential manager (macOS Keychain, Windows Credential Manager, Linux Secret Service). See Environment for APPFIGURES_API_KEY and other overrides.
MCP server
Appfigures runs a hosted Model Context Protocol server at https://mcp.appfigures.com/mcp. Add it to any MCP client that supports remote servers and sign in with your Appfigures account when the client asks. There's nothing to install and no token to manage.
Claude Code. Add it with one command, then run /mcp to sign in:
claude mcp add --transport http appfigures https://mcp.appfigures.com/mcp
Claude (web and desktop). Add the URL as a custom connector. See Add a connector that isn't in the directory.
ChatGPT. Add the URL as a custom MCP server with OAuth. See Connecting Appfigures to ChatGPT.
Other clients. Add a remote (Streamable HTTP) server with the same URL. See your client's MCP documentation for where.
The hosted server shares Public Data access and credits with the API and CLI. For request limits and credit costs, see Appfigures API, CLI, and MCP: Access, Limits, and Public Data.
For scripts and headless agents that authenticate with APPFIGURES_API_KEY, run the af commands directly, or use @appfigures/agent-toolkit from code.
af mcp (deprecated)
af mcp runs the same tools as a local stdio server. It's deprecated and will be removed in the next major release. Existing setups keep working until then, but it won't get new MCP features. Move to the hosted server above.
Commands
Apps
Find apps and look up their identity. Other commands take the app IDs these return.
| Command | Description |
|---|---|
| af apps search | Find apps by name or publisher. Returns one row per unified app. Default returns Apple and Google listings; pass --all-stores to include other storefronts. To filter apps by estimate values (e.g. apps with >100k downloads last month) use explorer list-products. For estimates broken down by time, country, or storefront, use metrics query with datasets estimates.sales or estimates.revenue. |
| af apps get | Get an app's record: basic metadata (name, developer, etc) and, if the user tracks it, what data they can access. Pass a product ID for one storefront; unified app ID for all storefronts together. |
| af apps tracked | List the apps your Appfigures account tracks. |
| af apps breakdown | Count your tracked apps by data group (e.g. sales, usage, ranks, reviews, keywords), storefront, monetization model, and source (yours vs tracked competitors), plus the total and earliest release date. |
Explorer
Search and analyze the full app catalog: millions of products across Apple, Google Play, Amazon, and other major stores, with 120+ fields spanning identity, storefront and country availability, categories, ratings, release dates, chart ranks, download and revenue estimates, SDK presence, demographics, and related apps.
| Command | Description |
|---|---|
| af explorer list‑products | Read catalog fields for one app or many. Fields referenced by query or sort come back automatically; pass --extra-fields for more. Use ["match","product_id",<id>] for a single app, or combine filters for population queries (e.g. iOS apps using Firebase with $1M+ US revenue). The 120+ fields span ranks, ratings, download and revenue estimates, SDKs, demographics, and more; query grammar and field list in docs get catalog_playbook. |
| af explorer aggregate‑products | Aggregate across the full catalog of millions of products across Apple, Google Play, Amazon, and other major stores: counts, averages, min/max, and histograms over any set of matching products. Uses the same query grammar as explorer list-products; returns aggregates, not product records. For market sizing, benchmarking, and segment analysis. |
| af explorer describe‑fields | List the catalog fields and the current user's access level for each. Search by keyword to find fields. Same field set explorer list-products and explorer aggregate-products accept. |
Metrics
Query numeric datasets across dimensions.
| Command | Description |
|---|---|
| af metrics query | Query any numeric dataset for one or more apps. Optionally grouped by up to two dimensions, returned as a nested partition tree, not app records. Independently filterable by country, device type, and date range. filterAppsBy* options narrow the app set (by ID, storefront, source, or type); without one, a query covers every app the account tracks. |
| af metrics describe‑datasets | List every numeric dataset metrics query accepts, one row per dataset with its value type and whether it's limited to your own apps. |
Store
App store presence: listing content, category ranks, top charts, and featured placements.
| Command | Description |
|---|---|
| af store app‑ranks | Trace rank history for one or more apps across countries, device types, category subtypes, and categories, as time-series positions with day-over-day deltas. |
| af store top‑charts | List the top apps in a category chart for a given country and category, with current positions and day-over-day deltas. |
| af store categories | List every store category with its ID. Numeric category IDs required by store app-ranks --category-ids and store top-charts --category-id are available here. |
| af store featured | List featured and editorial placements for an app or storefront product. Request 0 rows for summary stats only. |
| af store app‑listing | Read the full store listing for one storefront: localized text (name, subtitle, description, release notes) plus screenshots, video, categories, monetization, supported devices, country availability, price, ratings, file size, and age rating. Takes a numeric product ID (one storefront at a time; a unified app has one product per storefront). One locale per request. |
Audience
Who an app's users are and what else they use. Covers estimated age and gender, plus audience overlap with other apps.
| Command | Description |
|---|---|
| af audience demographics | Read an app's audience demographics: the estimated age and gender breakdown. |
| af audience cross‑usage | Find the apps that an app's users also use. |
Reviews
Search, summarize, and reply to iOS and Google Play app store reviews.
| Command | Description |
|---|---|
| af reviews list | Read individual reviews for one or more apps. Returns review text, star rating, country, app version, and your response. Filterable by star rating, date range, country, version, response status, and tracking relationship. |
| af reviews breakdown | Aggregate review counts for one or more apps, bucketed by dimension. Returns one count per dimension value, plus a global total across the matched set. |
| af reviews reply | Post or withdraw a developer response on a specific review. Pass content to post; pass delete: true to withdraw a previously-posted response. |
Keywords
Keyword visibility, rank tracking, and discovery across organic search (App Store, Google Play) and Apple Ads.
| Command | Description |
|---|---|
| af keywords organic | Check the organic keywords one or more apps rank for, with position, popularity, and competitiveness. |
| af keywords paid | List the paid keywords one or more apps run ads on, with impression share and organic rank. |
| af keywords tracked‑ranks | View where all your tracked keywords rank for a single app+country combo, with each keyword's current position, movement since it last changed, starting position, popularity, and competitiveness. |
| af keywords tracked‑trend | Trace how one tracked keyword's rank changes over time for a single app+country combo. Each point gives the rank and how many positions it moved since the one before. |
| af keywords suggestions | Discover keyword ideas to consider targeting for a single app+country combo, ranked by relevance to the app and including some drawn from apps you compete with. Each comes with its popularity, competitiveness, and the app's current rank. |
| af keywords ranking‑apps | List the apps ranking for a specific keyword in organic search, plus the keyword's own popularity and competitiveness scores. |
| af keywords advertisers | List the apps advertising on a specific keyword, with each advertiser's impression share, organic rank, and how long they've been bidding. |
| af keywords related | Find keywords related to a seed term for ASO research. Useful for finding alternatives with a similar audience that are more popular or less competitive. |
| af keywords tracked | List tracked keywords with their opaque IDs. |
| af keywords track | Track a keyword to monitor your app's hourly rank for it over time and get automatic alerts when its position moves. |
| af keywords untrack | Stop tracking a keyword. |
Apple Ads
Manage your Apple Ads campaigns, ad groups, keywords, and performance.
| Command | Description |
|---|---|
| af apple‑ads organizations | List the Apple Ads organizations you manage campaigns in, with each one's currency and timezone. |
| af apple‑ads campaigns | List your Apple Ads campaigns with each one's status, budget, targeted countries, and schedule. |
| af apple‑ads ad‑groups | List Apple Ads ad groups with each one's default bid, CPA cap, pricing model, and schedule. |
| af apple‑ads keywords | List a campaign's bid keywords with each keyword's performance (impressions, taps, installs, spend, cost-per-install) over a date range, plus its match type, bid, and whether it's a targeting or negative term. |
| af apple‑ads search‑terms | List the actual user search terms that triggered a campaign's ads, each with its all-time performance (impressions, taps, installs, spend, cost-per-install). Use these to discover new keywords to bid on or exclude. |
| af apple‑ads report | Report Apple Ads performance per campaign (impressions, taps, installs, spend, cost-per-install), plus an account-wide total, over a date range. |
| af apple‑ads top‑keywords | Rank a campaign's top-performing keywords by conversion rate, spend, and installs over a date range. Each list holds the top keywords on one metric. |
Sdks
Look up the SDKs we track.
| Command | Description |
|---|---|
| af sdks list | List every known SDK with its id, or search to find a specific one. |
Docs
Reference docs and guides for specific actions and common tasks.
| Command | Description |
|---|---|
| af docs get | Return a reference doc or guide by slug. |
API
| Command | Description |
|---|---|
| af api | Make a raw API request for endpoints without a dedicated command. Endpoints, parameters, and response shapes are documented at https://docs.appfigures.com. |
MCP
| Command | Description |
|---|---|
| af mcp | (Deprecated) Run a local MCP server over stdio. Use the hosted Appfigures MCP server instead: https://mcp.appfigures.com/mcp |
Auth
| Command | Description |
|---|---|
| af auth login | Sign in to Appfigures |
| af auth logout | Remove stored credentials |
| af auth status | Show authentication and account status |
Run af <command> --help for arguments, flags, and examples.
Environment
| Variable | Purpose |
|---|---|
APPFIGURES_API_KEY |
API key; skips interactive auth |
AF_VERBOSE |
Log HTTP to stderr (same as -v) |
NO_COLOR |
Disable ANSI color |
NO_UPDATE_NOTIFIER |
Skip the npm-registry update check |
CI |
Also skips the update check (any CI system) |
API Reference
Every command with its full argument and flag list. For the one-line overview, see Commands above.
Global flags. All commands accept:
-v, --verbose— Log HTTP requests to stderr. Also set viaAF_VERBOSE=1.-V, --version— Print the CLI version and exit.-h, --help— Show usage for the current command.
Output format. Every command emits a single JSON value on stdout — pipe to jq for filtering. Informational messages, hints, and update notices go to stderr so pipelines stay clean.
af apps search
af apps search <q> [flags]
Find apps by name or publisher. Returns one row per unified app. Default returns Apple and Google listings; pass --all-stores to include other storefronts. To filter apps by estimate values (e.g. apps with >100k downloads last month) use explorer list-products. For estimates broken down by time, country, or storefront, use metrics query with datasets estimates.sales or estimates.revenue.
Options
<q>required string. Search query (app name or publisher).--all-storesboolean, defaultfalse. Include storefronts beyond Apple and Google: Amazon, Windows, Steam, Roku, LG TV, Samsung TV, and others.--countinteger, default10. Number of results to return.--pageinteger, default1. Page number.
Examples
# 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 get
af apps get <app-id> [flags]
Get an app's record: basic metadata (name, developer, etc) and, if the user tracks it, what data they can access. Pass a product ID for one storefront; unified app ID for all storefronts together.
Options
<app-id>required integer or string. The app's unified app ID or product ID.--all-storesboolean, defaultfalse. For a unified app ID: include member products across all storefronts (Amazon, Steam, Windows, Roku, etc.). When false,member_productsis restricted to storefronts with app-intelligence coverage (iOS + Google Play). Ignored for product IDs.
Examples
# 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 apps tracked
af apps tracked [flags]
List the apps your Appfigures account tracks.
Options
--countinteger, default10. Number of results to return.--pageinteger, default1. Page number.--qstring. App name to filter by.--filter-apps-by-id(integer or string)[]. Only include data about specific apps, by product ID or unified app ID. Takes precedence over the otherfilterAppsBy*keys when set. Storefront, source, or type filters are better for app sets that can be described by those criteria.--filter-apps-by-storefrontstring[]. Narrow the account's tracked apps to those on these storefronts (e.g. apple:ios, google_play).--filter-apps-by-sourcestring[]. Narrow the account's tracked apps by tracking relationship.--filter-apps-by-typestring[]. Narrow the account's tracked apps to products of these types.
Examples
# 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 breakdown
af apps breakdown [flags]
Count your tracked apps by data group (e.g. sales, usage, ranks, reviews, keywords), storefront, monetization model, and source (yours vs tracked competitors), plus the total and earliest release date.
Options
--filter-apps-by-id(integer or string)[]. Only include data about specific apps, by product ID or unified app ID. Takes precedence over the otherfilterAppsBy*keys when set. Storefront, source, or type filters are better for app sets that can be described by those criteria.--filter-apps-by-storefrontstring[]. Narrow the account's tracked apps to those on these storefronts (e.g. apple:ios, google_play).--filter-apps-by-sourcestring[]. Narrow the account's tracked apps by tracking relationship.--filter-apps-by-typestring[]. Narrow the account's tracked apps to products of these types.
Examples
# 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
Appfigures MCP soruları
Appfigures MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add --env 'APPFIGURES_API_KEY=<YOUR_APPFIGURES_API_KEY>' cli -- npx -y @appfigures/cli komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
Appfigures MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
Appfigures MCP server için nasıl kimlik doğrulaması yapabilirim?
MCP istemcisi sorduğunda bir OAuth akışı kullanarak Appfigures hesabınızla giriş yapın. README dosyasında, barındırılan sunucu için kurulacak bir şey olmadığı ve yönetilecek bir token bulunmadığı belirtilmektedir.
Appfigures MCP server üzerinden neleri sorgulayabilirim?
Uygulama arayabilir, metrik veri setlerini sorgulayabilir, mağaza sıralamalarını ve en iyiler listelerini kontrol edebilir, incelemeleri okuyabilir, anahtar kelimeleri inceleyebilir ve hedef kitle demografisi ile çapraz kullanım verilerini görüntüleyebilirsiniz.
Appfigures'ın otomasyon için bir API key seçeneği var mı?
Evet, izlenemeyen kullanımlar ve headless agent'lar için, geliştirici anahtarları sayfasında kişisel erişim token'ı olarak oluşturulan APPFIGURES_API_KEY değerini ayarlayabilirsiniz.
Yerel `af mcp` stdio server hala destekleniyor mu?
Bu özellik kullanımdan kaldırıldı ve bir sonraki ana sürümde kaldırılacaktır; kullanıcıların barındırılan sunucuya geçmesi önerilir.