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 tools8 tools
list_search_console_sites
קריאה1 creditsVerified Search Console properties the connected Google account can read, with permission level and the default property used when site_url is omitted; properties added but not yet verified are listed separately under unverified.
This tool takes no parameters.
search_console_query
קריאה1 creditsSearch 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_urlOptional | string | Search Console property, e.g. https://example.com/ or sc-domain:example.com. Omit to use the connected default. |
start_dateOptional | string | YYYY-MM-DD |
end_dateOptional | string | YYYY-MM-DD |
daysOptional | integer (1–480) | window ending today when dates are omitted (default 28) |
dimensionsOptional | array<query | page | country | device | date | searchAppearance> | default [query] |
filtersOptional | array<object> | AND-combined dimension filters (e.g. query notContains brand, page equals URL) |
exclude_termsOptional | array<string> | brand terms to exclude from query (non-brand report) |
pageOptional | string | restrict to one page URL |
countryOptional | string | ISO 3166-1 alpha-3, e.g. TUR |
deviceOptional | DESKTOP | MOBILE | TABLET | — |
search_typeOptional | web | image | video | news | discover | googleNews | — |
row_limitOptional | integer (1–5000) | — |
start_rowOptional | integer (0–…) | — |
compare_previousOptional | boolean | also fetch the immediately preceding period of equal length and add previous/change per row |
order_byOptional | clicks | impressions | ctr | position | clicks_change | impressions_change | ctr_change | position_change | — |
orderOptional | asc | desc | — |
search_console_top_queries
קריאה1 creditsTop 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_urlOptional | string | Search Console property, e.g. https://example.com/ or sc-domain:example.com. Omit to use the connected default. |
start_dateOptional | string | YYYY-MM-DD |
end_dateOptional | string | YYYY-MM-DD |
daysOptional | integer (1–480) | window ending today when dates are omitted (default 28) |
filtersOptional | array<object> | AND-combined dimension filters (e.g. query notContains brand, page equals URL) |
exclude_termsOptional | array<string> | brand terms to exclude from query (non-brand report) |
pageOptional | string | restrict to one page URL |
countryOptional | string | ISO 3166-1 alpha-3, e.g. TUR |
deviceOptional | DESKTOP | MOBILE | TABLET | — |
limitOptional | integer (1–1000) | — |
order_byOptional | clicks | impressions | ctr | position | — |
search_console_low_ctr_pages
קריאה2 creditsPages (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_urlOptional | string | Search Console property, e.g. https://example.com/ or sc-domain:example.com. Omit to use the connected default. |
start_dateOptional | string | YYYY-MM-DD |
end_dateOptional | string | YYYY-MM-DD |
daysOptional | integer (1–480) | window ending today when dates are omitted (default 28) |
filtersOptional | array<object> | AND-combined dimension filters (e.g. query notContains brand, page equals URL) |
exclude_termsOptional | array<string> | brand terms to exclude from query (non-brand report) |
pageOptional | string | restrict to one page URL |
countryOptional | string | ISO 3166-1 alpha-3, e.g. TUR |
deviceOptional | DESKTOP | MOBILE | TABLET | — |
dimensionOptional | page | query | — |
min_impressionsOptional | number | — |
max_ctrOptional | number | percent, default 2 |
limitOptional | integer (1–500) | — |
inspect_url
קריאה1 creditsURL 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 |
|---|---|---|
urlRequired | string | full URL under the property |
site_urlOptional | string | Search Console property, e.g. https://example.com/ or sc-domain:example.com. Omit to use the connected default. |
list_sitemaps
קריאה1 creditsSitemaps submitted for the property with last submitted/downloaded time, pending flag, warning and error counts and content type counts.
| Parameter | Type | Description |
|---|---|---|
site_urlOptional | string | Search Console property, e.g. https://example.com/ or sc-domain:example.com. Omit to use the connected default. |
gsc_inspect_urls
קריאה2 creditsBatch URL Inspection: index verdict, coverage, last crawl, Google canonical and mobile verdict for many URLs in one call, with a summary (indexed / not indexed / never crawled; recrawled since a date). Each URL is inspected separately; one failure does not stop the rest. Read only.
| Parameter | Type | Description |
|---|---|---|
urlsRequired | array<string> | full URLs under the property |
site_urlOptional | string | Search Console property, e.g. https://example.com/ or sc-domain:example.com. Omit to use the connected default. |
limitOptional | integer (1–50) | how many of urls to inspect (default 20) |
crawled_sinceOptional | string | YYYY-MM-DD; flags which URLs Google recrawled on/after this date |
search_console_vs_ads
קריאה2 creditsOrganic 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_urlOptional | string | Search Console property, e.g. https://example.com/ or sc-domain:example.com. Omit to use the connected default. |
daysOptional | integer (1–90) | — |
filtersOptional | array<object> | AND-combined dimension filters (e.g. query notContains brand, page equals URL) |
exclude_termsOptional | array<string> | brand terms to exclude from query (non-brand report) |
pageOptional | string | restrict to one page URL |
countryOptional | string | ISO 3166-1 alpha-3, e.g. TUR |
deviceOptional | DESKTOP | MOBILE | TABLET | — |
limitOptional | integer (1–500) | — |
Write tools5 tools
submit_sitemap
כתיבה2 creditsSubmit (or resubmit) a sitemap to Search Console. Applied directly when the user asks (the result shows the preview showing the property and sitemap URL); sent to Google only with a connected account.
| Parameter | Type | Description |
|---|---|---|
sitemap_urlRequired | string | — |
site_urlOptional | 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
כתיבהIrreversible2 creditsRemove a sitemap from Search Console. Applied directly when the user asks; the result shows the preview.
| Parameter | Type | Description |
|---|---|---|
sitemap_urlRequired | string | — |
site_urlOptional | 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.
gsc_add_site
כתיבה2 creditsAdd a website as a Search Console property. Added directly when the user asks; the property is added unverified and ownership still has to be verified in Search Console (DNS or HTML) before any data shows.
| Parameter | Type | Description |
|---|---|---|
site_urlRequired | string | https://example.com/ (URL prefix) or sc-domain:example.com |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
connect_search_console
כתיבה0 creditsStart connecting Google Search Console: returns a one-time authorisation link the user opens (same flow as connect_account). Nothing is connected until the user signs in.
This tool takes no parameters.
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
select_google_resource
כתיבה0 creditsChoose which single Google resource the account works on by default: a Search Console property, GA4 property, Business Profile location, YouTube channel or Tag Manager container. Without resource it lists the options. The choice is validated against the live account and used whenever a tool is called without an explicit resource.
| Parameter | Type | Description |
|---|---|---|
serviceRequired | search_console | ga4 | business_profile | youtube | tag_manager | — |
resourceOptional | string | id or name from the options; omit to list options and the current choice; 'none' clears it |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.