Skip to content
Get MCP AdsGet MCP Ads, home
View as Markdown

gsc_analyze_search_appearance_trends

Analyze structured data and rich-result trend signals via the Search Analytics searchAppearance dimension when GSC exposes it.

Analyze structured data and rich-result trend signals via the Search Analytics searchAppearance dimension when GSC exposes it.

Kind
Read
Discovery
Reachable through search_tools and run_tool
Account parameter
siteUrl
Endpoint
https://mcp.getmcpads.com/search-console/mcp

ParametersLink to this section

NameTypeRequiredNotes
siteUrlstringOptionalSearch Console property URL, e.g. https://example.com/ or sc-domain:example.com. Uses GSC_SITE_URL when omitted.
searchTypestringOptionalSearch surface to report, such as web, image, video, news or Discover. Availability depends on the property. One of: web, image, video, news, discover, googleNews. Default: "web".
datePresetstringOptionalNamed reporting period. Use the custom date range when you need exact start and end dates. One of: today, yesterday, last7days, last28days, last3months, last6months, last12months, last16months. Default: "last28days".
currentDateRangeobjectOptionalCurrent period. Defaults to datePreset.
previousDateRangeobjectOptionalPrevious period. Defaults to the immediately preceding period with the same length.
includePagesbooleanOptionalWhen true, groups by searchAppearance + page for page-level rich result trends. Default: false.
limitintegerOptionalMaximum number of returned items or rows. The declared bounds and default apply; use pagination for additional results. Default: 5000.
topNintegerOptionalMaximum number of highest-ranked results to return. Default: 50.
minImpressionsintegerOptionalMinimum reported impressions required for a row to enter the analysis. Default: 0.
sortBystringOptionalMetric or dimension used to rank the returned results. One of: currentClicks, currentImpressions, clicksDelta, impressionsDelta, positionDelta. Default: "impressionsDelta".

Calling itLink to this section

jsonThrough run_tool, since it is not announced
{
  "name": "run_tool",
  "arguments": {
    "name": "gsc_analyze_search_appearance_trends",
    "args": {}
  }
}
Esc

Type to search