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