Google Search Console

Overview

Google Search Console is a free Google tool that lets you monitor, maintain, and debug your site’s presence in search results. It provides data on clicks, impressions, average position, and indexing issues. With the SquadOS integration, your agents can query search analytics, inspect URLs, manage sitemaps, and monitor registered properties in Search Console in an automated way.

• Official website: https://search.google.com/search-console/
• Composio documentation: docs.composio.dev/toolkits/google_search_console

Authentication

This tool uses OAuth 2.0 (OAUTH2) to connect. Access is granted directly through your Google account — no need to generate API keys manually.

You will need the following fields:

Field	Required	Description
Google Account	Yes	Google account with access to Google Search Console. Consent is granted via OAuth flow on the Composio page.

How to connect in SquadOS

1. Go to Tools in the side menu (/admin/tools).
2. Open the Available tab and search for Google Search Console.
3. Click the card to open the details modal and hit Connect.
4. You’re taken to the secure connection page hosted by Composio, where you authorize access to your Google account.
5. Once done, you’re sent back to SquadOS with the account connected and the tool available to your agents. (Connection-flow details in Organization Tools.)

Available actions

Add Site

GOOGLE_SEARCH_CONSOLE_ADD_SITE

Adds a site to the set of the user’s sites in Google Search Console. This action registers a new property (site) in Google Search Console for the authenticated user. After adding the site, you will need to verify ownership through one of the available verification methods. The site URL must be properly formatted as either a URL-prefix property (with protocol) or a domain property (with sc-domain prefix).

Input parameters

Name	Type	Required	Description
site_url	string	Yes	The site URL to add to Google Search Console. For URL-prefix properties, use the full URL with protocol (e.g., https://www.example.com/). For domain properties, use the sc-domain format (e.g., sc-domain:example.com). The site will need to be verified after being added.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

Delete Site

GOOGLE_SEARCH_CONSOLE_DELETE_SITE

Removes a site from the user’s Google Search Console sites. This action permanently removes a site property from the authenticated user’s Search Console account. The site URL must be URL-encoded. Use this when you need to unregister a site from tracking in Search Console.

Input parameters

Name	Type	Required	Description
site_url	string	Yes	The site URL to remove from Google Search Console. For URL-prefix properties, use the full URL with protocol (e.g., http://www.example.com/). For domain properties, use the sc-domain format (e.g., sc-domain:example.com). The site must be currently registered in Search Console for the authenticated user.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

Get Site

GOOGLE_SEARCH_CONSOLE_GET_SITE

Retrieves information about a specific Search Console site. Use when you need to get site details including permission level for a specific property.

Input parameters

Name	Type	Required	Description
site_url	string	Yes	The URL of the property to retrieve, as defined by Search Console. Examples: http://www.example.com/ (for a URL-prefix property) or sc-domain:example.com (for a Domain property).

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

Get Sitemap

GOOGLE_SEARCH_CONSOLE_GET_SITEMAP

Retrieves sitemap metadata (submitted/indexed counts, errors, warnings, last-submission timestamps) for a specific sitemap in Search Console. Returns metadata only, not raw XML content. Note: numeric fields like errors, warnings, submitted, and indexed may be returned as strings; cast to int before comparisons. Values such as contents.indexed can lag several days after submission.

Input parameters

Name	Type	Required	Description
feedpath	string	Yes	The URL of the sitemap to retrieve. For example: https://www.example.com/sitemap.xml
site_url	string	Yes	The site’s URL, including protocol. For example: https://www.example.com/. For domain properties, use sc-domain:example.com format instead.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

Inspect URL

GOOGLE_SEARCH_CONSOLE_INSPECT_URL

Inspects a URL for indexing issues and status in Google Search Console. Results may reflect cached data lagging real changes by several days. High-volume use can trigger 429 quota errors; limit to priority URLs.

Input parameters

Name	Type	Required	Description
site_url	string	Yes	The URL of the property as defined in Search Console. URL-prefix properties must include a trailing slash. For example: https://www.example.com/
language_code	string	No	IETF BCP-47 language code for localizing the inspection results. For example: en-US, es-ES, fr-FR
inspection_url	string	Yes	The fully-qualified URL to inspect. Must be a page under the site specified in site_url. For example: https://www.example.com/page

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

List Sitemaps

GOOGLE_SEARCH_CONSOLE_LIST_SITEMAPS

Lists all sitemaps for a site in Google Search Console. Response fields errors, warnings, contents.submitted, and contents.indexed may be returned as strings; cast to integers before numeric operations. Evaluate these fields alongside isPending for sitemap health.

Input parameters

Name	Type	Required	Description
site_url	string	Yes	The site’s URL, including protocol. For example: https://www.example.com/. Must exactly match the Search Console property string — include trailing slash for URL-prefix properties or use sc-domain:example.com format for domain properties. An inexact match silently returns no data.
sitemap_index	string	No	A URL of a site’s sitemap index file (e.g., http://www.example.com/sitemapindex.xml). When specified, lists the sitemaps contained within this sitemap index file instead of all sitemaps for the site.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

List Sites

GOOGLE_SEARCH_CONSOLE_LIST_SITES

Lists all verified sites (properties) owned by the authenticated user in Google Search Console. Response contains a siteEntry array — always iterate it, never assume a single object. Each entry includes permissionLevel, which varies per site; do not assume owner-level access for all returned properties. When calling downstream tools, use the site_url value exactly as returned, including protocol, subdomain, sc-domain: prefix, and trailing slash — any deviation causes empty results or permission errors. Empty siteEntry may indicate missing OAuth scopes or no verified properties. Newly added properties may not appear immediately due to propagation delay.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

Search Analytics Query

GOOGLE_SEARCH_CONSOLE_SEARCH_ANALYTICS_QUERY

Queries Google Search Console for search analytics data including clicks, impressions, CTR, and position metrics. Only returns URLs with at least one impression; missing rows do not confirm non-indexing. Position is an impression-weighted average rank.

Input parameters

Name	Type	Required	Description
end_date	string	Yes	The end date of the date range for the query, in YYYY-MM-DD format.
site_url	string	Yes	The site’s URL, including protocol (e.g., https://www.example.com/) or a domain property (e.g., sc-domain:example.com). URL-prefix properties specify exact protocol and path, while domain properties aggregate data across all subdomains and protocols.
row_limit	integer	No	The maximum number of rows to return. Must be between 1 and 25,000. Note: The API returns top results sorted by clicks (or date when grouping by date). Use start_row to paginate; stop when response rows are less than row_limit.
start_row	integer	No	The first row to return from the result set. Used for pagination.
data_state	string	No	The data state to return. Accepted values: "final", "all", "hourly_all".
dimensions	array	No	The dimensions to group the data by. Results are sorted by clicks descending, except when grouping by date (sorted by date ascending).
start_date	string	Yes	The start date of the date range for the query, in YYYY-MM-DD format. Data lags 2–3 days (UTC); most recent 1–2 days may be incomplete. Data retention is approximately 16 months; older ranges return zero rows.
search_type	string	No	The search type to filter results by. Accepted values: "web", "image", "video", "news", "discover", "googleNews".
aggregation_type	string	No	How data is aggregated. Accepted values: "auto", "byPage", "byProperty", "byNewsShowcasePanel".
dimension_filter_groups	array	No	Optional filters to apply to dimensions. Each filter group contains an array of filters with structure: [{'filters': [{'dimension': 'country', 'operator': 'equals', 'expression': 'USA'}]}]. Operators: equals, notEquals, contains, notContains, includingRegex, excludingRegex. Invalid dimension names, unsupported operators, or mismatched expressions return zero rows without an error — verify each filter before trusting empty results.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

Submit Sitemap

GOOGLE_SEARCH_CONSOLE_SUBMIT_SITEMAP

Submits a sitemap to Google Search Console for indexing. This action registers or resubmits a sitemap for a verified property in Google Search Console. The sitemap file must be accessible at the specified URL and properly formatted as XML. Supported sitemap types include standard sitemaps, sitemap index files, RSS feeds, and Atom feeds. The authenticated user must have site owner or full user permissions for the property. After submission, Google will crawl and process the sitemap according to its standard indexing schedule.

Input parameters

Name	Type	Required	Description
feedpath	string	Yes	The full URL of the sitemap to submit (e.g., https://www.example.com/sitemap.xml). Must be accessible and properly formatted as a valid sitemap XML file. Can also be a sitemap index file or RSS/Atom feed URL. Must exactly match the registered sitemap URL including protocol, host, path, and trailing slash; mismatches return notFound or invalid errors.
site_url	string	Yes	The site URL as registered in Google Search Console. For URL-prefix properties, use the full URL with protocol (e.g., https://www.example.com/). For domain properties, use the sc-domain format (e.g., sc-domain:example.com). The site must be verified and owned by the authenticated user.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.