google-play-suggest
Retrieve Google Play search suggestions to identify trending keywords and improve app discoverability for market research.
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 |
|---|---|---|---|
| term | Yes | Search term to get suggestions for (e.g., 'panda') | |
| lang | No | Language code for suggestions (default: en) | en |
| country | No | Country code to get suggestions from (default: us) | us |
Implementation Reference
- src/server.js:595-599 (handler)Handler function that fetches search suggestions using gplay.suggest and returns them as a JSON string in the MCP response 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 input schema defining parameters: term (string, required), lang (string, default 'en'), country (string, default 'us').{ 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)Full server.tool registration call that defines the tool name, description, input schema, and inline handler function.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) }] }; } );