mcpField
A
app-review-mining

app-review-mining

github.com/crawlora-orgMarketing & growth141 installsUpdated 2d ago
Repository

About app-review-mining

app-review-mining is a skill for retrieving App Store and Google Play app details, reviews, ratings, rankings, and similar-app data through the Crawlora API. It is intended for review analysis and app-store optimization research, with normalized JSON data from both stores.

Key features

  1. 01App details and rating summaries
  2. 02Paginated reviews with text, score, and date
  3. 03Category and store rankings
  4. 04Lists of similar apps
  5. 05Search for app identifiers

Use cases

  1. 01Analyzing review sentiment and recurring themes
  2. 02Comparing the same app across both stores
  3. 03Tracking an app’s category ranking
  4. 04Researching competing and similar apps

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/crawlora-org/crawlora-skills --skill app-review-mining

After installing, type/app-review-miningin Claude Code to confirm it loaded.

Bundled filesreference/endpoints.mdscripts/crawlora.sh

Details

From the project README

App review mining & ASO

Pull App Store (iOS) and Google Play (Android) app details, reviews, ratings, rankings, and similar-app lists as normalized JSON from the Crawlora API.

When to use this skill

  • "What are the reviews / ratings for ?"
  • "How is ranked?" / "top apps in ."
  • "Find apps similar to " / competitive ASO research.
  • "Pull this app's details / privacy / version history."
  • Building an app-review sentiment or competitor-tracking pipeline.

Setup (one-time)

  • Get a free Crawlora API key (2,000 credits/mo, no card) at https://crawlora.net.
  • Set CRAWLORA_API_KEY in the environment before running the helper.
  • The helper reads CRAWLORA_API_KEY from the environment and sends requests to https://api.crawlora.net/api/v1. Missing/invalid key → 401.

How it works

Choose the store (both have parallel endpoints), then the job:

  1. Find the app — /appstore/search?term=... or /googleplay/search?q=... to resolve the app id / bundle id.
  2. Details — /appstore/app, /googleplay/app for metadata, rating summary, description, and developer.
  3. Reviews — /appstore/reviews, /googleplay/reviews (paginate) for the review text, score, and date to mine sentiment and themes.
  4. Rankings — /appstore/list, /googleplay/list for store charts by category.
  5. Competitors — /appstore/similar, /googleplay/similar for similar apps.

Full endpoint list, methods, and params: reference/endpoints.md.

Calling the API

# Find an app, then pull its reviews (GET, key=value params):
scripts/crawlora.sh /appstore/search term="notion" | jq '.'
scripts/crawlora.sh /appstore/reviews id=1232780281 country=us | jq '.data'

scripts/crawlora.sh /googleplay/search term="notion" | jq '.'
scripts/crawlora.sh /googleplay/reviews app_id="notion.id" | jq '.'

Use scripts/crawlora.sh for all requests; it keeps the API key out of command-line arguments.

Endpoint reference

See reference/endpoints.md for every App Store and Google Play endpoint this skill uses (method, path, params, description).

Examples

  • Review sentiment: resolve the app id via search → /appstore/reviews (paginate) → classify each review's sentiment and summarize top complaints/praise.
  • Cross-store compare: pull /appstore/app and /googleplay/app for the same product to compare ratings and review volume across platforms.
  • Category ranking watch: /googleplay/list for a category to track where an app sits in the charts over time.

Notes & limits

  • Credits / pay-on-success: billed only on 2xx; free tier 2,000 credits/mo. Key at https://crawlora.net.
  • Public data only — public store pages; respect Apple's and Google's terms.
  • Security: key lives in CRAWLORA_API_KEY only — never hardcode, query-param, or commit it.
  • Reviews are paginated and locale-specific — pass country/page to widen coverage.

Comments

Markdown supported