Skip to content
MCP server

ASOLens

Check App Store keyword ranks and competitors from your own machine, with sourced numbers

Runs locallyStatus and history
Pricing
Free
Platforms
CLI, macOS, Windows
Runs
Locally
Version
0.4.1
Listing updated
1 day ago

About ASOLens

ASOLens is a free MCP server for marketing and seo. It runs locally on your machine and is started by your AI client.

ASOLens runs locally over stdio and reads Apple's public App Store endpoints, keeping its history in a local SQLite file. It reports where an app ranks for a keyword in any of 17 storefronts and, importantly, how many apps it was ranked against, since a top-10 spot in a search returning seven apps means little. It also checks what a keyword means to searchers, because one word can cover unrelated audiences.

Every figure is labelled observed (with source and time), modelled (with its inputs) or unavailable (with the reason). It does not estimate downloads or revenue, and it flags weak answers such as keywords it could not test. With your own App Store Connect key it can read your listing to show which keywords in your field pull weight; a paid DataForSEO login adds US search volume. It never writes to your listing.

With no credentials it sends no telemetry. It needs Node.js 22.13 or newer. Hosted daily rank tracking is not open yet and is run only for the author's own apps.

Install

Run in a terminal

claude mcp add mcp --env DATAFORSEO_PASSWORD='<DATAFORSEO_PASSWORD>' -- npx -y @asolens/mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@asolens/mcp"
      ],
      "env": {
        "DATAFORSEO_PASSWORD": "<DATAFORSEO_PASSWORD>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@asolens/mcp"
      ],
      "env": {
        "DATAFORSEO_PASSWORD": "<DATAFORSEO_PASSWORD>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@asolens/mcp"
      ],
      "env": {
        "DATAFORSEO_PASSWORD": "<DATAFORSEO_PASSWORD>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@asolens/mcp"
      ],
      "env": {
        "DATAFORSEO_PASSWORD": "<DATAFORSEO_PASSWORD>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@asolens/mcp"
      ],
      "env": {
        "DATAFORSEO_PASSWORD": "<DATAFORSEO_PASSWORD>"
      }
    }
  }
}

Configuration

  • ASC_API_ISSUER_IDOptional. App Store Connect API issuer id; with ASC_API_KEY_ID, lets ASOLens read your own listing.
  • ASC_API_KEY_IDOptional. App Store Connect API key id. The .p8 key is read from ~/.appstoreconnect/private_keys/AuthKey_<keyId>.p8.
  • ASC_API_PRIVATE_KEY_PATHOptional. Path to the App Store Connect .p8 key, if it is not in the default location.
  • DATAFORSEO_LOGINOptional and paid. DataForSEO API login, for keyword search volume (US storefront only).
  • DATAFORSEO_PASSWORDOptional and paid. DataForSEO API password (not the website password).

What it does

Rank with context
Shows rank together with how many apps were ranked.
Keyword meaning check
Looks at what searchers mean by a keyword before you commit.
Labelled data
Numbers are observed, modelled or unavailable, with sources.
Before-and-after snapshots
Compare metadata changes after you ship them.
Local and read-only
Runs on your machine and never edits your listing.

Good for

  • Check where an app ranks for a keyword across storefronts
  • Find weak competitors and what their users complain about
  • Test whether a metadata change improved ranking
  • Find dead-weight words in an app's keyword field

Pricing

Free

Free; optional DataForSEO keyword volume is a paid third-party add-on

Prices change. Check asolens.danielhan.dev before you buy.

ASOLens FAQ

Does it need an ASOLens account?

No. It is free and runs locally.

Which credentials are optional?

App Store Connect keys to read your own listing, and DataForSEO for paid US keyword volume.

Does it estimate downloads?

No. The site says nobody outside Apple knows those figures.

What are the requirements?

Node.js 22.13 or newer.

Is ASOLens free?

Yes. ASOLens is free to use.

How do I add ASOLens to Claude Code?

Run this command in your terminal: claude mcp add mcp --env DATAFORSEO_PASSWORD='<DATAFORSEO_PASSWORD>' -- npx -y @asolens/mcp

What are the best alternatives to ASOLens?

The closest alternatives to ASOLens are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and Calven.

Alternatives to ASOLens

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  4. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  5. Calven

    MCP server

    Product marketing context from Calven delivered into Claude, ChatGPT and other AI tools

    Not checked yet
    • Remote
    • Free trial
    • 3 GitHub stars
    • Marketing and SEO
  6. CompanyData

    MCP server

    Search and enrich company records from official registers via the CompanyData API

    • 3 tools
    • Remote
    • Paid
    • 3 GitHub stars
    • Analytics and data