Tool reference — Data & Site

Search Console tools

Query and page performance, low-CTR pages, URL inspection, sitemaps and comparison with ads.

Tool names and descriptions are generated straight from the server code; the descriptions are the original English text the assistant sees.

Read tools7 tools

list_search_console_sites

Lezen1 credits

Verified Search Console properties the connected Google account can read, with permission level and the default property used when site_url is omitted.

This tool takes no parameters.

search_console_query

Lezen1 credits

Search Console performance report (clicks, impressions, ctr %, average position) for any date range by query, page, country, device, date or searchAppearance, with AND filters. compare_previous=true adds the previous equal period and per-row change; order_by=clicks_change with order=asc lists the biggest losers. Requires a connected Google account; otherwise returns connected=false.

Parameter	Type	Description
`site_url`Optional	string	Search Console property, e.g. https://example.com/ or sc-domain:example.com. Omit to use the connected default.
`start_date`Optional	string	YYYY-MM-DD
`end_date`Optional	string	YYYY-MM-DD
`days`Optional	integer (1–480)	window ending today when dates are omitted (default 28)
`dimensions`Optional	array<query \| page \| country \| device \| date \| searchAppearance>	default [query]
`filters`Optional	array<object>	AND-combined dimension filters (e.g. query notContains brand, page equals URL)
`exclude_terms`Optional	array<string>	brand terms to exclude from query (non-brand report)
`page`Optional	string	restrict to one page URL
`country`Optional	string	ISO 3166-1 alpha-3, e.g. TUR
`device`Optional	DESKTOP \| MOBILE \| TABLET	—
`search_type`Optional	web \| image \| video \| news \| discover \| googleNews	—
`row_limit`Optional	integer (1–5000)	—
`start_row`Optional	integer (0–…)	—
`compare_previous`Optional	boolean	also fetch the immediately preceding period of equal length and add previous/change per row
`order_by`Optional	clicks \| impressions \| ctr \| position \| clicks_change \| impressions_change \| ctr_change \| position_change	—
`order`Optional	asc \| desc	—

search_console_top_queries

Lezen1 credits

Top queries by clicks (or impressions/ctr/position) for the period; pass exclude_terms with brand words for a non-brand list.

Parameter	Type	Description
`site_url`Optional	string	Search Console property, e.g. https://example.com/ or sc-domain:example.com. Omit to use the connected default.
`start_date`Optional	string	YYYY-MM-DD
`end_date`Optional	string	YYYY-MM-DD
`days`Optional	integer (1–480)	window ending today when dates are omitted (default 28)
`filters`Optional	array<object>	AND-combined dimension filters (e.g. query notContains brand, page equals URL)
`exclude_terms`Optional	array<string>	brand terms to exclude from query (non-brand report)
`page`Optional	string	restrict to one page URL
`country`Optional	string	ISO 3166-1 alpha-3, e.g. TUR
`device`Optional	DESKTOP \| MOBILE \| TABLET	—
`limit`Optional	integer (1–1000)	—
`order_by`Optional	clicks \| impressions \| ctr \| position	—

search_console_low_ctr_pages

Lezen2 credits

Pages (or queries) with high impressions but low CTR — candidates for a title/meta description rewrite. Defaults: impressions ≥ 1000 and ctr < 2 %. Sorted by impressions.

Parameter	Type	Description
`site_url`Optional	string	Search Console property, e.g. https://example.com/ or sc-domain:example.com. Omit to use the connected default.
`start_date`Optional	string	YYYY-MM-DD
`end_date`Optional	string	YYYY-MM-DD
`days`Optional	integer (1–480)	window ending today when dates are omitted (default 28)
`filters`Optional	array<object>	AND-combined dimension filters (e.g. query notContains brand, page equals URL)
`exclude_terms`Optional	array<string>	brand terms to exclude from query (non-brand report)
`page`Optional	string	restrict to one page URL
`country`Optional	string	ISO 3166-1 alpha-3, e.g. TUR
`device`Optional	DESKTOP \| MOBILE \| TABLET	—
`dimension`Optional	page \| query	—
`min_impressions`Optional	number	—
`max_ctr`Optional	number	percent, default 2
`limit`Optional	integer (1–500)	—

inspect_url

Lezen1 credits

URL Inspection: indexed or not, coverage state, last crawl time, robots/indexing state, Google vs user canonical, mobile usability and rich result verdicts. Read only.

Parameter	Type	Description
`url`Required	string	full URL under the property
`site_url`Optional	string	Search Console property, e.g. https://example.com/ or sc-domain:example.com. Omit to use the connected default.

list_sitemaps

Lezen1 credits

Sitemaps submitted for the property with last submitted/downloaded time, pending flag, warning and error counts and content type counts.

Parameter	Type	Description
`site_url`Optional	string	Search Console property, e.g. https://example.com/ or sc-domain:example.com. Omit to use the connected default.

search_console_vs_ads

Lezen2 credits

Organic vs paid on the same terms: Search Console clicks/impressions/position per query next to Google Ads search-term impressions, clicks, spend and conversions for the last N days (default 28). If Google Ads is not connected the paid column is empty with a note.

Parameter	Type	Description
`site_url`Optional	string	Search Console property, e.g. https://example.com/ or sc-domain:example.com. Omit to use the connected default.
`days`Optional	integer (1–90)	—
`filters`Optional	array<object>	AND-combined dimension filters (e.g. query notContains brand, page equals URL)
`exclude_terms`Optional	array<string>	brand terms to exclude from query (non-brand report)
`page`Optional	string	restrict to one page URL
`country`Optional	string	ISO 3166-1 alpha-3, e.g. TUR
`device`Optional	DESKTOP \| MOBILE \| TABLET	—
`limit`Optional	integer (1–500)	—

Write tools2 tools

submit_sitemap

Schrijven2 credits

Submit (or resubmit) a sitemap to Search Console. Creates an approval item with a preview showing the property and sitemap URL; sent to Google only after approval and only with a connected account.

Parameter	Type	Description
`sitemap_url`Required	string	—
`site_url`Optional	string	Search Console property, e.g. https://example.com/ or sc-domain:example.com. Omit to use the connected default.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

delete_sitemap

SchrijvenIrreversible2 credits

Remove a sitemap from Search Console. Goes through preview and approval; applied only after the user approves.

Parameter	Type	Description
`sitemap_url`Required	string	—
`site_url`Optional	string	Search Console property, e.g. https://example.com/ or sc-domain:example.com. Omit to use the connected default.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.