Skip to main content
Glama

google_local

Destructive

当用户需要查询 Google 本地搜索结果、附近商家、地点列表、本地服务或基于位置的本地结果时触发。

Input Schema

NameRequiredDescriptionDefault
qYes定义想要搜索的查询内容。调用方必须提供非空值,不使用默认值。
glNo定义 Google 搜索要使用的国家/地区。它是一个两位数的国家/地区代码。例如 us 代表美国,uk 代表英国,fr 代表法国。
hlNo定义 Google 职位搜索要使用的语言。它是一个两位数的语言代码。例如 en 代表英语,es 代表西班牙语,fr 代表法语。
tbsNo定义常规查询字段中无法实现的高级搜索参数。
jsonNo定义采集结果的输出格式。1 返回 JSON 格式数据,2 返回 JSON+HTML 格式数据,3 返回 HTML 格式数据,4 返回 Light JSON。默认值为 1。1
uuleNo希望用于搜索的 Google 编码位置。uule 和 location 参数不能同时使用。
startNo定义结果偏移量。它跳过指定数量的结果,用于分页。该值取决于返回的结果数量,可以是 10 或 20。例如,移动端返回 10 条结果时,start 应为 10、20、30。
ludocidNo定义地点的 Google CID(客户标识符)。
locationNo定义搜索发起的地理位置。如果有多个位置与请求的位置匹配,将选择最受欢迎的一个。
no_cacheNo默认情况下,5 分钟内缓存相同参数的搜索结果。设为 true 可跳过缓存,设为 false(默认)则使用缓存结果。缓存搜索免费,且不计入搜索统计。false
google_domainNo定义要使用的 Google 域名。默认为 google.com。google.com

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

B3.3/5.0
Behavior1/5

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

The description characterizes the tool as a query/search operation, implying a read-only action, while the annotations declare readOnlyHint=false and destructiveHint=true. This is a direct contradiction, so the score is 1 and the contradiction is flagged.

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

Conciseness5/5

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

The description is a single, front-loaded sentence that states the trigger condition and scope without any waste. It is appropriately sized for a trigger statement.

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

Completeness3/5

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

Given 11 parameters and no output schema, the description is minimal and relies entirely on the schema for invocation details. It provides enough to select the tool but does not cover return values or other behavioral aspects, making it just adequate.

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%, so the baseline is 3. The description adds no parameter-level meaning beyond what the schema already provides, so it does not exceed the baseline.

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?

The description specifies a clear verb (查询) and resource (Google 本地搜索结果, 附近商家, 地点列表, 本地服务, 基于位置的本地结果). It does not differentiate from closely related siblings such as google_maps or google_map_details, so it falls short of a 5.

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

Usage Guidelines4/5

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

It provides explicit trigger conditions: '当用户需要查询...时触发' and lists several scenarios. However, it offers no when-not guidance or named alternatives, so it is not a full 5.

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