Skip to main content
Glama
LucasMonteiro1

mcp-store-scraper

README.md
# mcp-store-scraper

MCP server that exposes Google Play and Apple App Store scraping as tools.

## Usage

Add to your MCP client config (e.g. `~/.kiro/settings/mcp.json`):

```json
{
  "mcpServers": {
    "store-scraper": {
      "command": "npx",
      "args": ["-y", "mcp-store-scraper"],
      "disabled": false,
      "autoApprove": [
        "gplay_app", "gplay_search", "gplay_reviews", "gplay_similar",
        "appstore_app", "appstore_search", "appstore_reviews", "appstore_similar"
      ]
    }
  }
}
```

## Tools

### Google Play

| Tool | Description |
|---|---|
| `gplay_app` | Get app details by package name |
| `gplay_search` | Search apps |
| `gplay_reviews` | Get app reviews |
| `gplay_similar` | Get similar apps |

### App Store

| Tool | Description |
|---|---|
| `appstore_app` | Get app details by bundle ID or numeric ID |
| `appstore_search` | Search apps |
| `appstore_reviews` | Get app reviews |
| `appstore_similar` | Get similar apps |

## Credits

This package is powered by two great open source libraries:

- **[google-play-scraper](https://github.com/facundoolano/google-play-scraper)** by [@facundoolano](https://github.com/facundoolano) — scrapes app data from the Google Play Store
- **[app-store-scraper](https://github.com/facundoolano/app-store-scraper)** by [@facundoolano](https://github.com/facundoolano) — scrapes app data from the Apple App Store

TDQS

B3.4/5.0

Scored across 8 tools

Disambiguation5/5

Each tool targets a distinct store and action, with clear prefixes (gplay_ vs appstore_) and specific purposes (search, app details, similar, reviews). There is no overlap or ambiguity between tools.

Naming Consistency4/5

The naming follows a consistent prefix-plus-suffix pattern (store name + action). However, the suffixes are not all verbs (e.g., 'app' and 'reviews' are nouns), so it deviates slightly from a strict verb_noun convention.

Tool Count5/5

With 8 tools total, split evenly between two app stores, the count is well-scoped for a store scraping purpose. Each tool serves a distinct function without redundancy.

Completeness4/5

The set covers core search, details, similar, and reviews for both major app stores. Minor gaps like top charts or category browsing are absent, but the essential scraping workflows are well covered.

Maintenance

ActivityInactive
ResponsivenessNo issues