# ASOLens

> ASOLens is a free MCP server for marketing and seo. Check App Store keyword ranks and competitors from your own machine, with sourced numbers. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, macOS, Windows, Linux
- **Website:** https://asolens.danielhan.dev
- **MCP Registry name:** dev.danielhan.asolens/mcp
- **Categories:** marketing and SEO, analytics and data
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

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

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/asolens
