Mine app pain points
mine_app_pain_pointsTHE core tool: fetch recent reviews of any iOS/Android app, keep the negative ones, and cluster them into ranked pain points (title, sharePercent, severity 1-5, verbatim evidence quotes). Ideal for competitive research and product discovery. Cached 7 days (instant on repeat); a COLD server-side analysis takes 30-120s. If the result has "mode":"agent", it contains prepared negative reviews and "instructions" — do the clustering yourself and present it to the user. Not available for Steam (mine the game's mobile counterpart instead).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"appId": "<appId>"
},
"name": "mine_app_pain_points"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| appId | Yes | App Store / Google Play / Steam / WordPress.org / Chrome Web Store URL, iOS / Mac App Store numeric id (e.g. 324684580), Android package (e.g. com.spotify.music), Steam appid (e.g. 730), WordPress plugin slug (e.g. woocommerce) or Chrome extension id — get ids from search_apps | |
| model | No | premium refinement model (paid keys only). Omit for the free default. | |
| store | No | optional — inferred from appId (App Store URL or 5-12 digit id → ios, Play URL / package → android, Steam URL or 1-4 digit appid → steam); iOS and Mac App Store share the same URL shape, so pass "macos" explicitly for Mac apps. steam: details/search only for now — mining/reviews return steam_reviews_unavailable | |
| analyze | No | who clusters on a cold run: "server" = our model; "agent" = you get the prepared negative reviews + instructions and cluster them with your own model; "auto" (default) = server, switching to agent when the server-side allowance is used up | |
| country | No | ISO country code, default "us" | |
| reviews | No | reviews to analyze, default 300 (other values round up to these tiers; Apple rate limiting can occasionally cap depth below the target) | |
| maxRating | No | ratings <= this count as negative, default 3 |