google-play-suggest
Retrieve up to 5 Google Play search suggestions for a specific term, language, and country to identify trending keywords and optimize app discovery strategies.
Instructions
Get search suggestions from Google Play. Returns an array of suggested search terms (up to 5). Sample response: ['panda pop', 'panda', 'panda games', 'panda run', 'panda pop for free']
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| country | No | Country code to get suggestions from (default: us) | us |
| lang | No | Language code for suggestions (default: en) | en |
| term | Yes | Search term to get suggestions for (e.g., 'panda') |
Implementation Reference
- src/server.js:595-599 (handler)Handler function that executes the core logic of the 'google-play-suggest' tool by calling gplay.suggest with provided parameters and returning the JSON-stringified result in MCP format.async ({ term, lang, country }) => { const suggestions = await gplay.suggest({ term, lang, country }); // API returns array of strings directly return { content: [{ type: "text", text: JSON.stringify(suggestions) }] }; }
- src/server.js:590-594 (schema)Zod schema defining the input parameters for the 'google-play-suggest' tool: term (required string), lang and country (strings with defaults).{ term: z.string().describe("Search term to get suggestions for (e.g., 'panda')"), lang: z.string().default("en").describe("Language code for suggestions (default: en)"), country: z.string().default("us").describe("Country code to get suggestions from (default: us)") },
- src/server.js:587-600 (registration)Registration of the 'google-play-suggest' tool using server.tool, including description, schema, and inline handler.server.tool("google-play-suggest", "Get search suggestions from Google Play. Returns an array of suggested search terms (up to 5).\n" + "Sample response: ['panda pop', 'panda', 'panda games', 'panda run', 'panda pop for free']", { term: z.string().describe("Search term to get suggestions for (e.g., 'panda')"), lang: z.string().default("en").describe("Language code for suggestions (default: en)"), country: z.string().default("us").describe("Country code to get suggestions from (default: us)") }, async ({ term, lang, country }) => { const suggestions = await gplay.suggest({ term, lang, country }); // API returns array of strings directly return { content: [{ type: "text", text: JSON.stringify(suggestions) }] }; } );