Open-source, self-hosted App Store & Google Play intelligence — with a 32-tool MCP server for Claude Code.
Live Demo · Docs · MCP Server · Changelog
Pick one — either way you're up in ~60 seconds.
Option A · One-line install (uses install.sh)
curl -sSL https://appstore.cat/install.sh | shOption B · Manual (when you want to read every step)
git clone https://github.com/appstorecat/appstorecat.git
cd appstorecat
cp .env.development.example .env
make setup
make devThen open http://localhost:7461.
Requires Docker, git, make, curl. Tested on macOS & Linux. Detailed walkthrough → installation guide.
Give Claude Code direct access to your tracked app data.
claude mcp add appstorecat \
-e APPSTORECAT_API_URL=http://localhost:7460/api/v1 \
-e APPSTORECAT_API_TOKEN=<your-token> \
-- npx -y @appstorecat/mcpCreate the API token from the web UI: Settings → API Tokens → Create.
Then ask Claude:
What changed on ChatGPT's App Store listing this week? Top 3 trending free iOS apps in the US? Compare keyword density between Threads and Instagram.
32 tools (28 read · 4 write — track/untrack apps and add/remove competitors), Swagger-strict, chain-first. Full reference → docs/en/services/mcp.md.
| Discovery | Search both stores, browse trending charts, import publisher catalogs · docs |
| Competitor tracking | Side-by-side competitor monitoring · docs |
| Change detection | Per-locale diffs of title, screenshots, version, price · docs |
| Trending charts | Daily snapshots of top free / paid / grossing · docs |
| App rankings | Per-app pivot across countries × collections × categories · docs |
| Store listings | Multi-locale listings + per-country availability · docs |
| Ratings | Per-country rating history with star breakdown · docs |
| Keyword density | 1/2/3-gram, 50-language stop-words, 5-app comparison · docs |
| Publisher discovery | Search, browse, bulk-import entire catalogs · docs |
| MCP server | 32 tools (28 read + 4 write) for Claude Code, Cursor, Continue · docs |
make test # Full Pest suite (Feature, Unit, Connectors, Jobs, Regression)
make test EXTRA_ARGS="--filter=AppSyncer" # Filter by name~400 tests covering controllers, jobs, connectors, and known-bug regressions. The suite must stay green on every push.
Web :7461 ──▶ Server API :7460 ──▶ scraper-ios :7462
│ ──▶ scraper-android :7463
▼
MySQL :7464 + Redis :7465
| Service | Stack |
|---|---|
server/ |
Laravel 13, PHP 8.4, Sanctum, L5-Swagger |
web/ |
React 19, Vite, TypeScript, shadcn/ui, Tailwind v4 |
scraper-ios/ |
Fastify 5, Node.js, app-store-scraper |
scraper-android/ |
FastAPI, Python, gplay-scraper |
mcp/ |
MCP SDK, TypeScript (npm: @appstorecat/mcp) |
Deep dive → docs/en/architecture/overview.md.
- Getting started — installation · install script · configuration · quick start
- Architecture — overview · data model · data collection · queue system · connectors · sync pipeline
- Services — server · web · scraper-ios · scraper-android · MCP
- API — endpoints · authentication · scraper APIs
- Deployment — Docker · production · troubleshooting
- Reference — environment variables · Makefile commands · App Store countries
See CONTRIBUTING.md. Architecture rules for code contributions live in .arc/.
See SECURITY.md for responsible disclosure.
MIT — your code, your data, your servers.