Skip to main content
Glama
Store Scraper MCP

Store Scraper MCP

by MiguelAlvRed

Store Scraper MCP

A Model Context Protocol (MCP) server for accessing App Store and Google Play Store data. Provides 20 tools to query application information, reviews, ratings, rankings, and more from both iOS and Android app stores.

Features

  • ✅ 20 MCP Tools - Complete access to App Store and Google Play data

  • ✅ Dual Store Support - iOS (App Store) and Android (Google Play)

  • ✅ No External Dependencies - Self-contained scraping implementation

  • ✅ Robust Error Handling - Automatic retry and timeout management

  • ✅ Normalized Data - Consistent structured JSON responses

  • ✅ Cursor IDE Integration - Ready to use with Cursor

Related MCP server: appstore-mcp

Installation

npm install

Configuration

Cursor IDE

Add the following to your Cursor MCP settings file:

Windows:

%APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

macOS/Linux:

~/.cursor/mcp.json

Configuration:

{
  "mcpServers": {
    "store-scraper": {
      "command": "node",
      "args": ["/absolute/path/to/store-scraper-mcp/src/server.js"],
      "cwd": "/absolute/path/to/store-scraper-mcp"
    }
  }
}

See examples/cursor-mcp.json for a complete example.

Replace /absolute/path/to/store-scraper-mcp with your actual project path.

Restart Cursor completely after configuration.

Available Tools

App Store (iOS) - 10 tools

  1. app - Get detailed app information

  2. search - Search for apps

  3. list - Get app rankings (top free/paid/grossing)

  4. reviews - Get app reviews with pagination

  5. ratings - Get app ratings distribution

  6. developer - Get all apps by a developer

  7. similar - Get similar apps

  8. privacy - Get privacy labels and data usage

  9. versionHistory - Get app version history

  10. suggest - Get search suggestions/autocomplete

Google Play (Android) - 10 tools

  1. gp_app - Get detailed app information

  2. gp_search - Search for apps

  3. gp_list - Get app rankings

  4. gp_reviews - Get app reviews with pagination

  5. gp_developer - Get all apps by a developer

  6. gp_similar - Get similar apps

  7. gp_permissions - Get app permissions

  8. gp_datasafety - Get data safety information

  9. gp_categories - Get list of available categories

  10. gp_suggest - Get search suggestions/autocomplete

Usage Examples

In Cursor

Once configured, you can use prompts like:

App Store:

Search for fitness apps in the App Store
Get details of Duolingo using bundleId com.duolingo.DuolingoMobile
Show me the top 20 free apps in the United States

Google Play:

Search for fitness apps on Google Play
Get details of Duolingo on Google Play (appId: com.duolingo)
Show me all permissions of WhatsApp on Google Play (appId: com.whatsapp)
Get data safety information for TikTok (appId: com.zhiliaoapp.musically)

API Reference

App Store Tools

app

Get detailed information about an app.

Parameters:

  • id (number, optional): iTunes trackId

  • appId (string, optional): Bundle ID

  • country (string, optional): Two-letter country code (default: "us")

Search for apps in the App Store.

Parameters:

  • term (string, required): Search term

  • country (string, optional): Two-letter country code (default: "us")

  • lang (string, optional): Language code (default: "en")

  • num (number, optional): Number of results (default: 50, max: 200)

  • page (number, optional): Page number (default: 1)

list

Get app rankings.

Parameters:

  • chart (string, optional): Chart type - "topfreeapplications", "toppaidapplications", or "topgrossingapplications" (default: "topfreeapplications")

  • country (string, optional): Two-letter country code (default: "us")

  • genre (string, optional): Genre ID or "all" (default: "all")

  • limit (number, optional): Number of results (default: 200)

Google Play Tools

gp_app

Get detailed information about an app.

Parameters:

  • appId (string, required): Google Play app ID (e.g., "com.duolingo")

  • lang (string, optional): Language code (default: "en")

  • country (string, optional): Two-letter country code (default: "us")

Search for apps on Google Play.

Parameters:

  • term (string, required): Search term

  • country (string, optional): Two-letter country code (default: "us")

  • lang (string, optional): Language code (default: "en")

  • num (number, optional): Number of results (default: 250)

gp_permissions

Get app permissions.

Parameters:

  • appId (string, required): Google Play app ID

  • lang (string, optional): Language code (default: "en")

  • country (string, optional): Two-letter country code (default: "us")

  • short (boolean, optional): If true, return only permission names (default: false)

Requirements

  • Node.js >= 18.0.0

  • npm or yarn

Limitations

App Store

  • Similar apps parsing is limited (HTML parsing required)

  • Ratings histogram details not available from public API (only average and count)

  • Privacy data only available for US App Store apps

Google Play

  • HTML scraping required, may be fragile to structure changes

  • Some data may not be available depending on app structure

  • Rate limiting may apply with excessive requests

Error Handling

The server handles errors robustly:

  • Automatic retry: 3 attempts with exponential backoff

  • Timeouts: 30 seconds default

  • HTTP errors: Proper status code handling

  • Parsing: Validation and graceful handling of missing data

If functionality is unavailable or fails, returns:

  • null for individual objects

  • [] for arrays

  • Descriptive error messages

Project Structure

store-scraper-mcp/
├── src/
│   ├── server.js                    # MCP server entry point
│   ├── httpClient.js                # HTTP client with retry logic
│   ├── endpoints/
│   │   ├── appStore.js              # App Store URL builders
│   │   └── googlePlay.js            # Google Play URL builders
│   └── parsers/
│       ├── appStore/                # App Store parsers
│       │   ├── app.js
│       │   ├── list.js
│       │   ├── reviews.js
│       │   ├── search.js
│       │   ├── ratings.js
│       │   ├── privacy.js
│       │   ├── similar.js
│       │   ├── versionHistory.js
│       │   └── suggest.js
│       └── googlePlay/              # Google Play parsers
│           ├── app.js
│           ├── categories.js
│           ├── datasafety.js
│           ├── list.js
│           ├── permissions.js
│           ├── reviews.js
│           ├── search.js
│           ├── similar.js
│           └── suggest.js
├── examples/
│   └── cursor-mcp.json              # Example Cursor configuration
├── .editorconfig                    # Editor configuration
├── .gitattributes                   # Git attributes
├── .gitignore                       # Git ignore rules
├── CHANGELOG.md                     # Changelog
├── LICENSE                          # MIT License
├── package.json                     # Project configuration
└── README.md                        # This file

License

MIT

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Disclaimer

This project is for educational and research purposes. Please respect the terms of service of App Store and Google Play when using this tool.

Available Tools

20 tools
appC

Get detailed information about an app by ID or bundleId

Inputs: id, appId, country.

developerC

Get all apps by a developer

Inputs: devId (required), country, lang.

gp_appB

[Google Play] Get detailed information about an app

Inputs: appId (required), lang, country.

gp_categoriesB

[Google Play] Get list of available categories

Inputs: no named parameters.

gp_datasafetyC

[Google Play] Get app data safety information

Inputs: appId (required), lang.

gp_developerC

[Google Play] Get all apps by a developer

Inputs: devId (required), country, lang, num.

gp_listC

[Google Play] Get app rankings (top free, paid, grossing)

Inputs: collection, category, country, lang, +1 more.

gp_permissionsC

[Google Play] Get app permissions

Inputs: appId (required), lang, country, short.

gp_reviewsC

[Google Play] Get app reviews with pagination

Inputs: appId (required), country, lang, page, +1 more.

gp_similarC

[Google Play] Get apps similar to the specified app

Inputs: appId (required), lang, country.

gp_suggestC

[Google Play] Get search suggestions/autocomplete

Inputs: term (required), country, lang.

listC

Get app rankings (top free, paid, or grossing)

Inputs: chart, country, genre, limit.

privacyC

Get app privacy labels and data usage information

Inputs: id (required).

ratingsC

Get app ratings distribution

Inputs: id, appId, country.

reviewsC

Get app reviews with pagination

Inputs: id, appId, country, page, +1 more.

similarC

Get apps similar to the specified app

Inputs: id, appId, country.

suggestC

Get search suggestions/autocomplete for a search term

Inputs: term (required), country.

versionHistoryC

Get app version history with release notes

Inputs: id (required), country.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.9/5.0

    Scored across 20 tools

    Disambiguation2/5

    There is significant overlap between App Store and Google Play tools with unclear boundaries. For example, 'list' and 'gp_list' both get app rankings, 'developer' and 'gp_developer' both get apps by developer, and 'reviews' and 'gp_reviews' both get reviews with pagination. This creates ambiguity about when to use which tool, especially since the descriptions don't clarify the differences beyond platform indication.

    Naming Consistency3/5

    The naming is mixed but readable. Most tools use snake_case (e.g., 'gp_categories', 'versionHistory'), but there's inconsistency with 'versionHistory' using camelCase. The 'gp_' prefix for Google Play tools provides some structure, but the App Store tools lack a corresponding prefix, creating a naming asymmetry that reduces overall consistency.

    Tool Count3/5

    With 20 tools, the count is borderline high for a store scraper server. While covering two platforms (App Store and Google Play) justifies more tools, the duplication between platforms suggests the count could be optimized. It feels heavy but not extreme, as the domain scope is reasonably broad.

    Completeness4/5

    The tool set provides good coverage for app store scraping, including search, rankings, reviews, developer info, and metadata like privacy and permissions. Minor gaps exist, such as no explicit update or delete operations (which may not be needed for scraping), but agents can work around this. The surface supports core workflows for both platforms effectively.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides live App Store rankings, charts, app details, reviews, and search across 55 countries, enabling AI assistants to query app store data.
      17 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables searching the App Store, retrieving app details, discovering trending apps, and accessing screenshots and release information via Apple's public APIs.
      8 npm
      4
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides live App Store and Google Play data as MCP tools, enabling search, app details, reviews, charts, estimates, and more through natural language.
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables retrieval of App Store and Google Play reviews, ratings summaries, and ASO keyword rankings for any app using its store ID or package name.
      81 npm
      MIT