Skip to main content
Glama

google_play

Destructive

当用户需要查询 Google Play 应用、游戏或商店搜索结果,获取应用列表、详情或与 Google Play 内容相关的数据时触发。

Input Schema

NameRequiredDescriptionDefault
qYes该参数定义您要在 Google Play 应用商店中搜索的查询内容。调用方必须提供非空值,不使用默认值。
glNo该参数定义 Google Play 搜索要使用的国家/地区。它是一个两位数的国家/地区代码,例如 us(默认)代表美国,uk 代表英国,fr 代表法国。us
hlNo该参数定义 Google 职位搜索要使用的语言。它是一个两位数的语言代码,例如 en 代表英语,es 代表西班牙语,fr 代表法语。
ageNo该参数定义年龄段子类别。age 仅在 apps_category=FAMILY(儿童应用)时使用。可用值包括 AGE_RANGE1、AGE_RANGE2、AGE_RANGE3。
jsonNo该参数定义采集结果的输出格式。可选择 JSON、HTML(支持下载)格式,默认为 JSON;1 返回 JSON,2 返回 JSON+HTML,3 返回 HTML,4 返回 Light JSON。1
chartNo该参数用于显示热门排行榜。最多可返回 50 条结果。它不应与 section_page_token、see_more_token 和 next_page_token 参数一起使用。
no_cacheNo默认情况下,5 分钟内缓存相同参数的搜索结果。将 no_cache 设为 true 可跳过缓存,设为 false(默认)则使用缓存结果。缓存搜索免费,且不计入搜索统计。false
store_deviceNo该参数定义用于排序结果的设备。此参数不能与 apps_category 或 q 参数一起使用。可用值包括 phone、tablet、tv、chromebook、watch、car。
apps_categoryNo该参数定义应用商店类别。
see_more_tokenNo该参数定义用于从各个版块检索分页结果的“查看更多”令牌。它通常在下一页结果中找到。它不应与 section_page_token、next_page_token 和 chart 参数一起使用。
next_page_tokenNo该参数定义下一页令牌。它用于检索下一页结果。它不应与 section_page_token、see_more_token 和 chart 参数一起使用。
section_page_tokenNo该参数定义用于从各个版块检索分页结果的版块页面令牌。它不应与 next_page_token、see_more_token 和 chart 参数一起使用。

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

C2.9/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description frames the tool purely as a read/retrieval operation ('查询', '获取' lists and details), yet the annotations declare readOnlyHint=false and destructiveHint=true. This is a direct conflict between the described behavior and the declared behavior, with no explanation of what is actually mutated.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single front-loaded sentence with no filler, cleanly sized. It is concise, though brevity here comes partly from under-specification rather than disciplined editing.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 12-parameter scraping tool with no output schema and a contradictory destructive annotation, one sentence is far too thin. Nothing explains the pagination-token family, the chart/section mutual exclusions, the JSON/HTML output modes, or the destructiveHint flag an agent would need to reconcile.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% and the 12 parameters are all richly documented in the schema itself. The description adds no parameter-level meaning (no mention of q, gl, hl, tokens, chart, or output format), so the baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a clear verb and resource: querying Google Play apps, games, and store search results to obtain lists, details, or related data. However, it draws no boundary against the closely named siblings google_play_store_information and google_play_store_reviews, so an agent cannot tell from the description alone which of the three to pick.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The 'trigger when the user needs to...' phrasing gives an implied usage context but never states when NOT to use it or which sibling handles app details/reviews instead. The mutual-exclusion rules among chart/token params exist only in the schema, not as guidance here.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources