gsc analyze search appearance trends
gsc_analyze_search_appearance_trendsAnalyze search appearance trends in Google Search Console to uncover which rich results drive clicks and impressions.
Instructions
Analyze structured data and rich-result trend signals via the Search Analytics searchAppearance dimension when GSC exposes it.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "gsc_analyze_search_appearance_trends"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| topN | No | Maximum number of highest-ranked results to return. | |
| limit | No | Maximum number of returned items or rows. The declared bounds and default apply; use pagination for additional results. | |
| sortBy | No | Metric or dimension used to rank the returned results. | impressionsDelta |
| siteUrl | No | Search Console property URL, e.g. https://example.com/ or sc-domain:example.com. Uses GSC_SITE_URL when omitted. | |
| datePreset | No | Named reporting period. Use the custom date range when you need exact start and end dates. | last28days |
| searchType | No | Search surface to report, such as web, image, video, news or Discover. Availability depends on the property. | web |
| includePages | No | When true, groups by searchAppearance + page for page-level rich result trends. | |
| minImpressions | No | Minimum reported impressions required for a row to enter the analysis. | |
| currentDateRange | No | Current period. Defaults to datePreset. | |
| previousDateRange | No | Previous period. Defaults to the immediately preceding period with the same length. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes | Original tool result: parsed JSON when the text is JSON, otherwise the text or multiple MCP content blocks. Provider fields depend on the selected query. |