Store Scraper MCP
Provides 10 tools for accessing iOS App Store data including app details, search, rankings, reviews, ratings, developer information, similar apps, privacy labels, version history, and search suggestions.
Provides 10 tools for accessing Google Play Store data including app details, search, rankings, reviews, developer information, similar apps, permissions, data safety information, categories, and search suggestions.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Store Scraper MCP search for fitness apps on Google Play"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 installConfiguration
Cursor IDE
Add the following to your Cursor MCP settings file:
Windows:
%APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.jsonmacOS/Linux:
~/.cursor/mcp.jsonConfiguration:
{
"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
app - Get detailed app information
search - Search for apps
list - Get app rankings (top free/paid/grossing)
reviews - Get app reviews with pagination
ratings - Get app ratings distribution
developer - Get all apps by a developer
similar - Get similar apps
privacy - Get privacy labels and data usage
versionHistory - Get app version history
suggest - Get search suggestions/autocomplete
Google Play (Android) - 10 tools
gp_app - Get detailed app information
gp_search - Search for apps
gp_list - Get app rankings
gp_reviews - Get app reviews with pagination
gp_developer - Get all apps by a developer
gp_similar - Get similar apps
gp_permissions - Get app permissions
gp_datasafety - Get data safety information
gp_categories - Get list of available categories
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 StoreGet details of Duolingo using bundleId com.duolingo.DuolingoMobileShow me the top 20 free apps in the United StatesGoogle Play:
Search for fitness apps on Google PlayGet 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 trackIdappId(string, optional): Bundle IDcountry(string, optional): Two-letter country code (default: "us")
search
Search for apps in the App Store.
Parameters:
term(string, required): Search termcountry(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")
gp_search
Search for apps on Google Play.
Parameters:
term(string, required): Search termcountry(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 IDlang(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:
nullfor individual objects[]for arraysDescriptive 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 fileLicense
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 toolsappC
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_searchC
[Google Play] Search for apps
Inputs: term (required), country, lang, num.
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.
searchC
Search for apps in the App Store
Inputs: term (required), country, lang, num, +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
Scored across 20 tools
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.
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.
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.
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
Related MCP Connectors
App intelligence across Google Play and the App Store: details, reviews, and search in one API.
Live App Store and Google Play data: app details, reviews, search, top charts for 175+ storefronts.
App Store and Google Play reviews, ratings, sentiment and developer replies as agent tools.
Manage App Store and Google Play apps: listings, screenshots, builds, releases, reviews, metrics.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides live App Store rankings, charts, app details, reviews, and search across 55 countries, enabling AI assistants to query app store data.17 npm1MIT
- AlicenseNot gradedqualityDmaintenanceEnables searching the App Store, retrieving app details, discovering trending apps, and accessing screenshots and release information via Apple's public APIs.8 npm4MIT
- AlicenseNot gradedqualityDmaintenanceProvides live App Store and Google Play data as MCP tools, enabling search, app details, reviews, charts, estimates, and more through natural language.1MIT
- AlicenseNot gradedqualityBmaintenanceEnables 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 npmMIT