Skip to main content
Glama

구글 키워드 검색

google_search
Read-only

Google keyword search: return web search results (link, title, snippet) for a keyword. 특정 키워드의 구글 검색 결과(링크·제목·요약)를 조회합니다. page 로 결과 페이지를 넘겨 가며 조회할 수 있습니다. [호출당 7포인트]

Input Schema

NameRequiredDescriptionDefault
pageNo검색 결과 조회 페이지 (기본값 1)
keywordYes검색할 키워드

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A3.7/5.0
Behavior4/5

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

Beyond the readOnlyHint/openWorldHint annotations, the description discloses a concrete cost of 7 points per call and explains how results are paged. That is real operational context an agent cannot get from the annotations or schema. It stops short of stating per-page result counts or any pagination ceiling.

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?

Front-loaded with purpose and return fields, and every sentence adds something (return shape, paging, cost). The English/Korean duplication is slightly redundant for an agent but aids the service's bilingual audience.

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

Completeness4/5

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

With no output schema, the description usefully names the returned fields (link, title, snippet), plus pagination and cost. Missing only secondary details such as results per page or how deep paging is supported for a two-parameter open-world search tool.

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 coverage is 100%, with both `keyword` and `page` documented inline, so the schema carries the parameter burden. The description only adds the notion of stepping through pages, which the schema's 'page (default 1)' already implies.

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 specific verb and resource ('Google keyword search') and enumerates the return shape (link, title, snippet), which lets an agent distinguish it as general web search from the image/news/shopping/lens search siblings. It never names those siblings explicitly, so differentiation is by inference rather than stated.

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?

Usage is implied by the word 'web' against siblings like google_news_search or google_image_search, and paging via `page` is described. However, there is no explicit statement of when to choose this over the other Google search tools, nor any exclusion or prerequisite.

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.