Skip to main content
Glama
Crawlora-org

Crawlora MCP

Official

google_trends_trending_detail

Retrieve detailed Google Trends data for one trending term, including interest over time, regional interest, top/rising queries, and related topics.

Instructions

Google Trends trending term detail. Returns the Explore detail widgets for a single trending term, including interest over time, regional interest, top/rising related queries, and related topics when Google returns them.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
requestYesTrending detail request

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changedv1.17.5
    • addedInput schema / properties / request / properties
      Added value: +{
      +  "category": {
      +    "type": "integer"
      +  },
      +  "geo": {
      +    "enum": [
      +      "WORLDWIDE",
      +      "AF",
      +      "AX",
      +      "AL",
      +      "DZ",
      +      "AS",
      +      "AD",
      +      "AO",
      +      "AI",
      +      "AQ",
      +      "AG",
      +      "AR",
      +      "AM",
      +      "AW",
      +      "AU",
      +      "AT",
      +      "AZ",
      +      "BS",
      +      "BH",
      +      "BD",
      +      "BB",
      +      "BY",
      +      "BE",
      +      "BZ",
      +      "BJ",
      +      "BM",
      +      "BT",
      +      "BO",
      +      "BA",
      +      "BW",
      +      "BV",
      +      "BR",
      +      "IO",
      +      "VG",
      +      "BN",
      +      "BG",
      +      "BF",
      +      "BI",
      +      "KH",
      +      "CM",
      +      "CV",
      +      "CA",
      +      "BQ",
      +      "KY",
      +      "CF",
      +      "TD",
      +      "CL",
      +      "CN",
      +      "CX",
      +      "CC",
      +      "CO",
      +      "KM",
      +      "CG",
      +      "CD",
      +      "CK",
      +      "CR",
      +      "CI",
      +      "HR",
      +      "CU",
      +      "CW",
      +      "CY",
      +      "CZ",
      +      "DK",
      +      "DJ",
      +      "DM",
      +      "DO",
      +      "EC",
      +      "EG",
      +      "SV",
      +      "GQ",
      +      "ER",
      +      "EE",
      +      "SZ",
      +      "ET",
      +      "FK",
      +      "FO",
      +      "FJ",
      +      "FI",
      +      "FR",
      +      "GF",
      +      "PF",
      +      "TF",
      +      "GA",
      +      "GM",
      +      "GE",
      +      "DE",
      +      "GH",
      +      "GI",
      +      "GR",
      +      "GL",
      +      "GD",
      +      "GP",
      +      "GU",
      +      "GT",
      +      "GG",
      +      "GN",
      +      "GW",
      +      "GY",
      +      "HT",
      +      "HM",
      +      "HN",
      +      "HK",
      +      "HU",
      +      "IS",
      +      "IN",
      +      "ID",
      +      "IR",
      +      "IQ",
      +      "IE",
      +      "IM",
      +      "IL",
      +      "IT",
      +      "JM",
      +      "JP",
      +      "JE",
      +      "JO",
      +      "KZ",
      +      "KE",
      +      "KI",
      +      "XK",
      +      "KW",
      +      "KG",
      +      "LA",
      +      "LV",
      +      "LB",
      +      "LS",
      +      "LR",
      +      "LY",
      +      "LI",
      +      "LT",
      +      "LU",
      +      "MO",
      +      "MG",
      +      "MW",
      +      "MY",
      +      "MV",
      +      "ML",
      +      "MT",
      +      "MH",
      +      "MQ",
      +      "MR",
      +      "MU",
      +      "YT",
      +      "MX",
      +      "FM",
      +      "MD",
      +      "MC",
      +      "MN",
      +      "ME",
      +      "MS",
      +      "MA",
      +      "MZ",
      +      "MM",
      +      "NA",
      +      "NR",
      +      "NP",
      +      "NL",
      +      "NC",
      +      "NZ",
      +      "NI",
      +      "NE",
      +      "NG",
      +      "NU",
      +      "NF",
      +      "KP",
      +      "MK",
      +      "MP",
      +      "NO",
      +      "OM",
      +      "PK",
      +      "PW",
      +      "PS",
      +      "PA",
      +      "PG",
      +      "PY",
      +      "PE",
      +      "PH",
      +      "PN",
      +      "PL",
      +      "PT",
      +      "PR",
      +      "QA",
      +      "RE",
      +      "RO",
      +      "RU",
      +      "RW",
      +      "WS",
      +      "SM",
      +      "ST",
      +      "SA",
      +      "SN",
      +      "RS",
      +      "SC",
      +      "SL",
      +      "SG",
      +      "SX",
      +      "SK",
      +      "SI",
      +      "SB",
      +      "SO",
      +      "ZA",
      +      "GS",
      +      "KR",
      +      "SS",
      +      "ES",
      +      "LK",
      +      "BL",
      +      "SH",
      +      "KN",
      +      "LC",
      +      "MF",
      +      "PM",
      +      "VC",
      +      "SD",
      +      "SR",
      +      "SJ",
      +      "SE",
      +      "CH",
      +      "SY",
      +      "TW",
      +      "TJ",
      +      "TZ",
      +      "TH",
      +      "TL",
      +      "TG",
      +      "TK",
      +      "TO",
      +      "TT",
      +      "TN",
      +      "TR",
      +      "TM",
      +      "TC",
      +      "TV",
      +      "UM",
      +      "VI",
      +      "UG",
      +      "UA",
      +      "AE",
      +      "GB",
      +      "US",
      +      "UY",
      +      "UZ",
      +      "VU",
      +      "VA",
      +      "VE",
      +      "VN",
      +      "WF",
      +      "EH",
      +      "YE",
      +      "ZM",
      +      "ZW"
      +    ],
      +    "type": "string"
      +  },
      +  "hl": {
      +    "type": "string"
      +  },
      +  "property": {
      +    "type": "string"
      +  },
      +  "query": {
      +    "type": "string"
      +  },
      +  "time_range": {
      +    "enum": [
      +      "now 1-H",
      +      "now 4-H",
      +      "now 1-d",
      +      "now 7-d",
      +      "today 1-m",
      +      "today 3-m",
      +      "today 12-m",
      +      "today 5-y",
      +      "all"
      +    ],
      +    "type": "string"
      +  },
      +  "type": {
      +    "enum": [
      +      "web",
      +      "image",
      +      "news",
      +      "youtube",
      +      "shopping"
      +    ],
      +    "type": "string"
      +  },
      +  "tz": {
      +    "type": "integer"
      +  }
      +}
  2. First observedv1.0.0

TDQS

B3.3/5.0
Behavior3/5

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

With no annotations, the description must carry behavioral disclosure. It does note that related topics are returned 'when Google returns them', acknowledging variability in output. However, it does not mention error handling, rate limits, authentication, or what happens if the term is not trending. The limited behavioral note is useful but insufficient for a tool without any annotation coverage.

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 two concise sentences with no redundant phrasing. It front-loads the core purpose ('Google Trends trending term detail') and then lists the return components. Every sentence earns its place, making it efficient and easy to parse.

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 tool with a nested request object containing eight fields, the description fails to convey how to construct a valid request. It does not specify which fields are needed, their roles, or any defaults. Additionally, there is no output schema, so the description should have provided more detail on the return structure, but it only lists component names. The tool is not fully usable based on the description alone.

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

Parameters2/5

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

The description does not explain any of the request fields (hl, tz, geo, type, query, category, property, time_range). Though the schema provides enums for some fields, their meanings are left to inference. For example, the description mentions 'single trending term' but never states that this corresponds to the 'query' field. The schema itself only describes the request object as 'Trending detail request', adding no semantic value.

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

Purpose5/5

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

The description clearly states it returns Explore detail widgets for a single trending term, and enumerates the components: interest over time, regional interest, top/rising related queries, and related topics. This is specific and distinguishes it from generic explore tools. It gives a concrete resource and expected output, making the tool's purpose unambiguous.

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

Usage Guidelines2/5

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

The description provides no guidance on when to use this tool versus alternative Google Trends tools like google_trends_explore or google_trends_trending. It does not mention prerequisites (e.g., that the term must be a trending term) or exclusions. An agent receives no help in choosing between this and its siblings.

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

Deploy Server

Other Tools