AppSkyline MCP

跟踪iOS、macOS、Google Play和Microsoft Store上的应用商店关键词排名、排名历史、列表元数据、互动、评论及竞争对手。

访问 appskyline.com

文档

AppSkyline for developers

Drive your app store rank tracking from your own code: a REST API with scoped keys and per-key rate limits over the apps and search terms you track across the iOS App Store, Google Play and the Microsoft Store, plus signed webhooks when something changes.

API keys

Get a key and authenticate

The AppSkyline REST API lets your own backend work with what the dashboard shows: the apps your organization tracks, the search terms tracked for each of them across the iOS App Store, Google Play and the Microsoft Store, and the store engagement rows behind the stats pages.

Open the AppSkyline dashboard and create an API key under API keys. The secret is shown once, when the key is created, and never again — store it somewhere safe. A key belongs to a single organization, so the organization is implied by the key and never has to be sent.

Authenticate every request with HTTP Basic auth carrying only the key secret, base64-encoded, in the Authorization header.

# The Authorization header is HTTP Basic auth carrying only the key secret,
# with no username and no colon.
Authorization: Basic $(printf %s YOUR_API_KEY_SECRET | base64)

Every endpoint lives under https://api.appskyline.com. Requests made with a key are rate limited per key; going over the limit returns 429.

Quick start

Your first three calls

List your tracked apps, start tracking a new search term for one of them, then read the terms tracked for that app.

# List the apps your organization tracks
curl https://api.appskyline.com/api/apps \
  -H "Authorization: Basic $(printf %s YOUR_API_KEY_SECRET | base64)"

# Track a new search term for one of them. country is a two-letter ISO code and
# language a two-letter ISO code; the pair is the storefront the term is
# ranked in.
curl -X POST https://api.appskyline.com/api/keywords \
  -H "Authorization: Basic $(printf %s YOUR_API_KEY_SECRET | base64)" \
  -H "Content-Type: application/json" \
  -d '{
    "appId": "APP_ID",
    "searchTerms": "dental practice software",
    "country": "us",
    "language": "en"
  }'

# Read back the terms tracked for that app
curl "https://api.appskyline.com/api/keywords?appId=APP_ID&limit=50" \
  -H "Authorization: Basic $(printf %s YOUR_API_KEY_SECRET | base64)"

Browse the full API reference — every endpoint with its parameters, request body, responses and required scope.

CLI

Command-line interface

The same apps, keywords and rankings are available from your terminal through the appskyline CLI. Install it globally with npm, or run it ad hoc with npx.

Authentication is one command: appskyline login opens your browser to sign in to your AppSkyline account and stores a session for later commands — no API key to paste.

# Install once, globally
npm install -g appskyline
# or run it ad hoc without installing
npx appskyline --help

# Log in — opens your browser to sign in and stores a session
appskyline login

# List the apps your organization tracks
appskyline apps list

# Where does your app rank right now for a term?
appskyline rank APP_ID --store ios-app-store --term "dental practice software" --country US

# Live top-10 results for a term on a store
appskyline search ios-app-store --term "dental practice software" --country US

# Search volume, CPC and difficulty for keyword ideas
appskyline keywords overview --country US --terms "dental software,dentist app"

The CLI is open source at github.com/appskyline/cli and published as appskyline on npm. Run any command with --help to see its options.

Claude connector

Use AppSkyline from Claude

Connect AppSkyline to Claude to ask about the apps your organization tracks, the search terms you monitor and their current store rankings. The connector uses your AppSkyline account, so Claude can only access the organization you authorize.

In Claude, open Settings, choose Connectors, then add a custom connector with the URL below. Claude sends you to AppSkyline to sign in and approve access. After connecting, ask a natural-language question such as “What is our current rank for restaurant POS on the iOS App Store in the United States?”

# In Claude: Settings > Connectors > Add custom connector
# Connector URL
https://mcp.appskyline.com/mcp

# Then sign in to your AppSkyline account when Claude asks you to connect.
# Example prompt: "Show the current App Store rank for one of my apps."

The connector has separate read and write tools. Claude identifies changes before performing them, while rank lookups can render a compact inline result with the app, store, country, keyword and current position.

You need an AppSkyline account with access to at least one tracked app. To remove access later, disconnect AppSkyline in Claude or revoke the connection from your AppSkyline account.

Other MCP clients

Use AppSkyline from any MCP client

AppSkyline speaks the Model Context Protocol over streamable HTTP, so it works with any client that supports remote MCP servers — not only Claude. There is nothing to install and no API key to paste: point the client at the URL below and sign in to AppSkyline when it asks.

# Any MCP client that supports remote servers uses the same URL:
https://mcp.appskyline.com/mcp

# Codex CLI
codex mcp add appskyline --url https://mcp.appskyline.com/mcp
codex mcp login appskyline

# VS Code
code --add-mcp '{"name":"appskyline","type":"http","url":"https://mcp.appskyline.com/mcp"}'

# Cursor, Windsurf and other editors: add to their MCP config file
{
  "mcpServers": {
    "appskyline": {
      "type": "http",
      "url": "https://mcp.appskyline.com/mcp"
    }
  }
}

# Clients that only support local (stdio) servers can bridge:
npx mcp-remote https://mcp.appskyline.com/mcp

Authentication uses OAuth 2.0 with dynamic client registration and PKCE, which means clients register themselves — you never copy a client id or secret. Clients that only support local servers can bridge to the remote endpoint with mcp-remote.

AppSkyline signs in through the same authorization server as our other products, so the approval screen may list scopes for products beyond AppSkyline. Access is pinned to the product you connected: a token issued for AppSkyline is only accepted by AppSkyline, and you can revoke it at any time from your account.

Agent Skills

Teach your coding agent AppSkyline

AppSkyline ships Agent Skills — guides following the agentskills.io standard that teach coding agents how to run ASO research with the appskyline CLI and the MCP connector, instead of guessing at commands and tools.

# Install the AppSkyline skills into your coding agent
npx skills add appskyline/skills

One command installs the skills into Claude Code, Cursor, Codex, Gemini CLI and any other agent that follows the Skills standard. The CLI also bundles the same guides, version-matched to the commands it ships: appskyline skills get <name> prints one on demand.

The skills are open source at github.com/appskyline/skills. Claude users can also install the AppSkyline Claude plugin, which bundles the connector together with the skills: github.com/appskyline/claude-plugin.

Scopes

Least privilege by default

Each key carries a list of scopes, so an integration that only needs to read your rankings never gets the ability to change what is tracked. New keys start read-only; widen them explicitly in the dashboard. A request whose key is missing the scope an endpoint requires is refused with 403.

  • apps:readList the apps of your organization and read one by id.
  • apps:writeCreate and update apps.
  • keywords:readList tracked search terms and read one by id.
  • keywords:writeCreate, update and delete tracked search terms.
  • stats:readRead store engagement rows for your apps.

Webhooks

Signed webhooks

Add a webhook subscription to your organization and AppSkyline POSTs the events you picked to your server as they happen.

  • app.createdAn app was added to tracking.
  • app.updatedAn app was edited.
  • keyword.createdA search term started being tracked for an app.
  • keyword.updatedA tracked search term was edited.
  • keyword.deletedA tracked search term was removed.
POST https://your-server.com/appskyline-webhook
X-Appskyline-Event: keyword.created
X-Appskyline-Signature: t=1719000000,v1=<hmac-sha256 hex>
Content-Type: application/json

{
  "event": "keyword.created",
  "timestamp": 1719000000,
  "data": { "...": "..." }
}

Verify the signature

Every delivery carries an X-Appskyline-Signature header of the form t=timestamp,v1=signature, where the signature is an HMAC-SHA256 of timestamp.body keyed by the subscription secret shown to you once when the subscription was created. Recompute it over the raw body and compare before trusting the payload.

import crypto from 'node:crypto'

// body must be the RAW request body, byte for byte
function verify(header, body, secret) {
  const [t, v1] = (header || '').split(',').map(part => part.split('=')[1])
  if (!t || !v1) return false

  const expected = crypto
    .createHmac('sha256', secret)
    .update(`${t}.${body}`)
    .digest('hex')

  // timingSafeEqual throws on a length mismatch, so a malformed signature
  // has to be rejected before the comparison rather than by it.
  if (v1.length !== expected.length) return false

  return crypto.timingSafeEqual(Buffer.from(v1), Buffer.from(expected))
}

Delivery is one best-effort attempt with a five second timeout and no retries, so respond 2xx quickly and do the work asynchronously. An endpoint that fails twenty times in a row is disabled automatically and has to be re-enabled in the dashboard.

Start building

Language

EnglishEspañolDeutschPortuguêsFrançaisItalianoไทยNederlandsελληνικάBahasa IndonesiaPolskiTürkçe

Resources

StatusBlogDocsPricingAlternativesBuyer guidesPrivacy PolicyTerms of ServiceDevelopersAPI reference

Contact us

[email protected]

Copyright @ AppSkyline 2023 - 2026