google-play-details
Extract comprehensive Google Play app details, including title, ratings, installs, developer info, pricing, and features, to analyze app performance and market presence directly.
Instructions
Get detailed information about a Google Play app. Returns an object with:
title: App name
description: Full app description
descriptionHTML: Description with HTML formatting
summary: Short description
installs: Install count range
minInstalls: Minimum install count
maxInstalls: Maximum install count
score: Average rating (0-5)
scoreText: Rating display text
ratings: Total number of ratings
reviews: Total number of reviews
histogram: Rating distribution by star level
price: Price in local currency
free: Boolean indicating if app is free
currency: Price currency code
priceText: Formatted price string
offersIAP: Boolean indicating in-app purchases
IAPRange: Price range for in-app purchases
androidVersion: Minimum Android version required
androidVersionText: Formatted Android version text
developer: Developer name
developerId: Developer ID
developerEmail: Developer contact email
developerWebsite: Developer website URL
developerAddress: Developer physical address
genre: App category
genreId: Category ID
icon: Icon URL
headerImage: Feature graphic URL
screenshots: Array of screenshot URLs
contentRating: Content rating (e.g. 'Everyone')
contentRatingDescription: Content rating details
adSupported: Boolean indicating if app shows ads
released: Release date
updated: Last update date
version: Current version string
recentChanges: Latest version changes
preregister: Boolean indicating if app is in pre-registration
editorsChoice: Boolean indicating Editor's Choice status
features: Array of special features
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| appId | Yes | Google Play package name (e.g., 'com.google.android.apps.translate') | |
| country | No | Country code to check app availability (default: us) | us |
| lang | No | Language code for result text (default: en) | en |
Implementation Reference
- src/server.js:473-476 (handler)The handler function executes the tool logic by calling the external gplay.app() method with the provided appId, lang, and country parameters, then returns the details as a JSON string in a text content block.async ({ appId, lang, country }) => { const details = await gplay.app({ appId, lang, country }); return { content: [{ type: "text", text: JSON.stringify(details) }] }; }
- src/server.js:468-472 (schema)Zod schema defining the input parameters: appId (required string), lang (string, default 'en'), country (string, default 'us').{ appId: z.string().describe("Google Play package name (e.g., 'com.google.android.apps.translate')"), lang: z.string().default("en").describe("Language code for result text (default: en)"), country: z.string().default("us").describe("Country code to check app availability (default: us)") },
- src/server.js:426-477 (registration)The server.tool() registration call that defines the tool name, description, input schema, and handler function.server.tool("google-play-details", "Get detailed information about a Google Play app. Returns an object with:\n" + "- title: App name\n" + "- description: Full app description\n" + "- descriptionHTML: Description with HTML formatting\n" + "- summary: Short description\n" + "- installs: Install count range\n" + "- minInstalls: Minimum install count\n" + "- maxInstalls: Maximum install count\n" + "- score: Average rating (0-5)\n" + "- scoreText: Rating display text\n" + "- ratings: Total number of ratings\n" + "- reviews: Total number of reviews\n" + "- histogram: Rating distribution by star level\n" + "- price: Price in local currency\n" + "- free: Boolean indicating if app is free\n" + "- currency: Price currency code\n" + "- priceText: Formatted price string\n" + "- offersIAP: Boolean indicating in-app purchases\n" + "- IAPRange: Price range for in-app purchases\n" + "- androidVersion: Minimum Android version required\n" + "- androidVersionText: Formatted Android version text\n" + "- developer: Developer name\n" + "- developerId: Developer ID\n" + "- developerEmail: Developer contact email\n" + "- developerWebsite: Developer website URL\n" + "- developerAddress: Developer physical address\n" + "- genre: App category\n" + "- genreId: Category ID\n" + "- icon: Icon URL\n" + "- headerImage: Feature graphic URL\n" + "- screenshots: Array of screenshot URLs\n" + "- contentRating: Content rating (e.g. 'Everyone')\n" + "- contentRatingDescription: Content rating details\n" + "- adSupported: Boolean indicating if app shows ads\n" + "- released: Release date\n" + "- updated: Last update date\n" + "- version: Current version string\n" + "- recentChanges: Latest version changes\n" + "- preregister: Boolean indicating if app is in pre-registration\n" + "- editorsChoice: Boolean indicating Editor's Choice status\n" + "- features: Array of special features", { appId: z.string().describe("Google Play package name (e.g., 'com.google.android.apps.translate')"), lang: z.string().default("en").describe("Language code for result text (default: en)"), country: z.string().default("us").describe("Country code to check app availability (default: us)") }, async ({ appId, lang, country }) => { const details = await gplay.app({ appId, lang, country }); return { content: [{ type: "text", text: JSON.stringify(details) }] }; } );