Tool reference | Searchata Docs

Recommended order

For backlink research, call backlinks_get_referring_domains directly with a public domain. You can research competitor domains without connecting them as properties. This tool returns referring domains, not exact source-page URLs.

Backlink access requires the backlinks:read permission. If an older connection lacks this permission, remove the Searchata connection from your AI client and add it again to approve the new permission. For API-key connections, create a new key.

MCP service limits

An active trial, subscription, or lifetime plan is required for every MCP tool call, including property lists and cached reports. You can connect MCP and discover its tools before starting the trial. If a tool returns subscription_required, open its setup link and complete billing before retrying.

Trial and paid workspaces have no total MCP call limit. Each workspace can make 60 calls per minute, with 6 calls running at once. All agents and credentials in a workspace share these limits. If a limit is reached, wait for the retry delay in the tool response before sending another request.

Data-source limits and the separate performance allowances below still apply. Searchata caches reports, bounds report sizes, and stops requests that take too long.

SEO analysis tools

Start with seo_get_roadmap to find which pages to investigate first. Use seo_get_page_evidence for a page's supporting metrics. These tools use your existing Search Console permission.

SEO reports use completed reporting periods and bounded samples. Each report identifies missing evidence and data limits. The current tools do not read page content, suggest verified internal links, compare competitor keywords, or enable automatic monitoring. Content briefs and topic groups use search queries. Schema drafts use facts supplied by you and need page review before publication.

Performance tool limits

Trial and paid workspaces can run 20 fresh audits per UTC day, with up to 2 per minute and 1 running at a time. Results are cached for 6 hours. Mobile and desktop use separate audits.

Trial and paid workspaces can request 200 fresh lookups per UTC day, with up to 10 per minute and 2 running at a time. Results, including missing-data results, are cached for 24 hours.

Cached results do not use these fresh-request allowances. Standard MCP plan limits still apply. Requests sent to Google count toward performance allowances even if they fail or time out. Temporary limit errors include a retry delay. Google service limits can also apply.

List Search Console Properties

google_search_console_list_properties

Lists every Google Search Console property available through the user's Searchata connection. Use this first when a request does not identify a Searchata propertyId, or when you need to map a site to the canonical propertyId required by the other tools.

Use when: Start here when the property is not known or when a user asks which Search Console properties are available.
Returns: Canonical property IDs, site URLs, domains, names, permission levels, and connection status.

Parameters

This tool has no input parameters.

Get Search Console Performance

google_search_console_get_performance

Returns Google Search Console clicks, impressions, CTR, and average position for a date range, with optional dimensions and filters. Use it for performance questions about queries, pages, countries, devices, dates, hours, or search appearance. Use the returned cursor to request more rows.

Use when: Use for one-period performance analysis, filtered reports, totals, or paginated Search Console rows.
Returns: Performance rows, totals, period details, aggregation metadata, and an optional cursor for the next page.

Parameters

propertyIdRequired: Canonical property ID returned by the property-list tool.
days or startDate and endDate: A relative period or an exact inclusive date range.
dimensions: Date, hour, query, page, country, device, or search appearance groupings.
filters: Up to 10 Search Console dimension filters.
limit and cursor: Page size and the cursor returned by a previous request.
comparePreviousPeriod: Adds totals for the preceding period when enabled.

Compare Search Console Performance

google_search_console_compare_performance

Compares Google Search Console rows between a current date range and a baseline date range. Use it when a user asks what gained, declined, or changed between two periods and needs row-level differences for clicks, impressions, CTR, or position.

Use when: Use for period-over-period analysis with explicit current and baseline dates.
Returns: Ranked rows with current values, baseline values, and calculated changes.

Parameters

propertyIdRequired: Canonical property ID returned by the property-list tool.
currentStartDate and currentEndDateRequired: Inclusive dates for the period being evaluated.
baselineStartDate and baselineEndDateRequired: Inclusive dates for the comparison period.
dimensions and filters: Optional row groupings and Search Console filters.
sortBy and sortDirection: Controls which change appears first.

Find Search Console Opportunities

google_search_console_get_opportunities

Finds evidence-based Search Console opportunities such as striking-distance queries, high-impression low-CTR rows, declining rows, and possible query cannibalization. Use it when a user asks where to focus SEO work based on their connected Search Console data.

Use when: Use to prioritize search opportunities from current and previous Search Console performance.
Returns: Ranked opportunities with the relevant query, page, score, current values, and baseline values when applicable.

Parameters

propertyIdRequired: Canonical property ID returned by the property-list tool.
days: Analysis period from 1 to 90 days.
types: One or more supported opportunity types.
thresholds: Optional impression, CTR, position, and decline thresholds.
limit: Maximum number of ranked opportunities to return.

Inspect a URL in Search Console

google_search_console_inspect_url

Returns Google Search Console inspection details for one URL, including index status, crawl state, canonical URLs, mobile usability, AMP, and rich results. Use it when a user asks whether one known URL is indexed or how Google currently sees it.

Use when: Use for a detailed inspection of one URL inside a connected Search Console property.
Returns: Indexing, crawl, canonical, mobile usability, AMP, rich-result, sitemap, and referring-URL details.

Parameters

propertyIdRequired: Canonical property ID returned by the property-list tool.
urlRequired: Exact URL inside the selected Search Console property.
languageCode: Optional language for the inspection response.

Inspect Multiple URLs in Search Console

google_search_console_inspect_urls

Returns Google Search Console inspection details for up to 10 URLs in one property. Use it when a user needs the same indexing and crawl checks for several known URLs and a batch request is more efficient than separate inspections.

Use when: Use for a small batch of known URLs that belong to the same Search Console property.
Returns: One inspection result per URL, with index, crawl, canonical, mobile, AMP, and rich-result details.

Parameters

propertyIdRequired: Canonical property ID returned by the property-list tool.
urlsRequired: Between 1 and 10 exact URLs inside the selected property.
languageCode: Optional language for the inspection responses.

List Search Console Sitemaps

google_search_console_get_sitemaps

Lists submitted sitemaps for one Google Search Console property, with processing state, warnings, errors, and optional content counts. Use it when a user asks which sitemaps are submitted or wants an overview of sitemap health.

Use when: Use for a property-level sitemap inventory or health review.
Returns: Submitted sitemap URLs, types, status dates, pending state, warnings, errors, and optional content counts.

Parameters

propertyIdRequired: Canonical property ID returned by the property-list tool.
limit: Maximum number of submitted sitemaps to return.
includeContents: Includes submitted and indexed content counts when enabled.
sitemapIndex: Optional sitemap-index URL used to narrow the result.

Get a Search Console Sitemap

google_search_console_get_sitemap

Returns status and content counts for one exact submitted sitemap in Google Search Console. Use it when a user names a sitemap URL or asks for detailed warnings, errors, processing state, or indexed counts for one sitemap.

Use when: Use after the user identifies a specific submitted sitemap URL.
Returns: The sitemap type, submission and download dates, pending state, warnings, errors, and optional content counts.

Parameters

propertyIdRequired: Canonical property ID returned by the property-list tool.
sitemapUrlRequired: Exact submitted sitemap URL.
includeContents: Includes submitted and indexed content counts when enabled.

List Bing Webmaster Sites

bing_webmaster_tools_list_sites

Lists every verified Bing Webmaster Tools site available through the user's Searchata connection. Use this first when a Bing request does not identify a Searchata propertyId, when you must map a site URL to its canonical property, or when you need to confirm the available Bing sites.

Use when: Start here when the Bing site is not known or when a user asks which verified Bing sites are available.
Returns: Canonical property IDs, site URLs, domains, names, verification state, and connection status.

Parameters

This tool has no input parameters.

Get Bing Search Traffic

bing_webmaster_tools_get_traffic

Returns daily clicks and impressions from Bing Webmaster Tools. Bing combines web, chat, news, image, video, and knowledge-panel traffic in this report. Use it to review a daily Bing traffic trend, calculate CTR, or find dates with material visibility changes.

Use when: Use for the daily Bing traffic trend for one connected site.
Returns: Daily clicks, impressions, calculated CTR, data freshness, and included search surfaces.

Parameters

propertyIdRequired: Canonical property ID returned by the Bing site-list tool.
limit: Maximum number of source rows to return.

Get Bing Query Statistics

bing_webmaster_tools_get_query_stats

Returns Bing Webmaster Tools statistics for top queries, including clicks, impressions, CTR, and average click and impression positions. Use it to find the Bing queries that produce traffic or visibility and to compare their source metrics.

Use when: Use when a user asks which queries produce visibility or traffic from Bing.
Returns: Weekly query rows with traffic and position metrics.

Parameters

propertyIdRequired: Canonical property ID returned by the Bing site-list tool.
limit: Maximum number of source rows to return.

Get Bing Page Statistics

bing_webmaster_tools_get_page_stats

Returns Bing Webmaster Tools statistics for top pages, including clicks, impressions, CTR, and average click and impression positions. Use it to find the pages that produce Bing traffic or visibility and to compare their source metrics.

Use when: Use when a user asks which pages produce visibility or traffic from Bing.
Returns: Weekly page rows with traffic and position metrics.

Parameters

propertyIdRequired: Canonical property ID returned by the Bing site-list tool.
limit: Maximum number of source rows to return.

Get Bing Crawl Statistics

bing_webmaster_tools_get_crawl_stats

Returns Bing crawl and index statistics, including crawled pages, indexed pages, crawl errors, robots exclusions, malware findings, and HTTP status groups. Use it to review crawl health, identify error trends, or check changes in Bing index coverage.

Use when: Use to review Bing crawl health or find changes in indexing and crawl errors.
Returns: Daily crawl, index, link, error, malware, robots, and HTTP status metrics.

Parameters

propertyIdRequired: Canonical property ID returned by the Bing site-list tool.
limit: Maximum number of source rows to return.

List Bing Sitemaps

bing_webmaster_tools_get_sitemaps

Lists the top-level sitemaps and feeds known to Bing Webmaster Tools for one connected site. Use it to review the Bing sitemap inventory, processing status, submission and crawl times, URL counts, file sizes, and compression state.

Use when: Use for a Bing sitemap inventory or processing-status review.
Returns: Sitemap URLs, types, status, submission and crawl times, URL counts, file sizes, and compression state.

Parameters

propertyIdRequired: Canonical property ID returned by the Bing site-list tool.
limit: Maximum number of sitemap rows to return.

Inspect a URL in Bing

bing_webmaster_tools_inspect_url

Returns the index details that Bing Webmaster Tools stores for one URL, including crawl dates, HTTP status, document size, anchors, and child URL count. Use it when a user asks how Bing discovered, crawled, or stored a URL inside the selected site.

Use when: Use when a user asks how Bing currently sees one URL in a connected site.
Returns: Bing URL index, crawl, discovery, HTTP, document, anchor, and child URL details.

Parameters

propertyIdRequired: Canonical property ID returned by the Bing site-list tool.
urlRequired: Exact URL inside the connected Bing site.

List Connected GA4 Properties

google_analytics_list_properties

Lists the Google Analytics 4 properties selected in this workspace and their optional Searchata site associations. Use this before requesting an Analytics report so you use the correct GA4 property ID and do not confuse it with a Searchata site ID.

Use when: Start here to find the GA4 property associated with a website.
Returns: GA4 property IDs, display names, account names, and optional Searchata site IDs.

Parameters

This tool has no input parameters.

Get a Google Analytics Report

google_analytics_get_report

Reads organic traffic, landing pages, engagement, key events, or revenue from a selected GA4 property. Use it to investigate visitor activity after search clicks or compare two date ranges. Tracking configuration determines which key events and revenue are available.

Use when: Analyze website visitor activity, conversion events, or period changes.
Returns: Report headers, rows, totals when supplied by Google, quota details, reporting metadata, date ranges, and cache timestamp.

Parameters

propertyIdRequired: GA4 property ID from google_analytics_list_properties.
dateRangesRequired: One or two objects with startDate and endDate in YYYY-MM-DD format.
dimensions: Optional breakdowns: date, landingPagePlusQueryString, sessionDefaultChannelGroup, sessionSourceMedium, country, deviceCategory, eventName, hostName.
metrics: sessions, activeUsers, newUsers, engagedSessions, engagementRate, averageSessionDuration, keyEvents, totalRevenue, eventCount, or screenPageViews. Defaults to sessions, activeUsers, keyEvents, and totalRevenue.
organicOnly: Defaults to true. Set false to report all traffic channels.
limit: Maximum returned rows, from 1 to 1000. Defaults to 100.
offset: Row offset for pagination. Defaults to zero.

Run a PageSpeed Insights Audit

pagespeed_insights_run_audit

Runs a mobile or desktop Lighthouse audit for a URL in a connected Searchata site. Use it to investigate loading performance, accessibility, best practices, and basic SEO checks. Results are simulated lab data. Fresh audits have workspace limits and are cached for six hours.

Use when: Diagnose a public page's performance and identify concrete audit findings.
Returns: Category scores, lab measurements, up to 25 audit findings, warnings, final URL, and cache timestamps.

Parameters

propertyIdRequired: Searchata property ID from Search Console or Bing.
urlRequired: Public URL inside the connected property.
strategy: mobile (default) or desktop. Each device uses a separate audit.

Get a Chrome UX Report

chrome_ux_report_get_record

Reads real-user performance data from the Chrome UX Report for a page or origin in a connected Searchata site. Use it to examine Core Web Vitals and the reported collection period. Missing data is returned explicitly, without substituting origin data for a page. Results are cached for 24 hours.

Use when: Check real-user loading, responsiveness, and layout stability for a page or origin.
Returns: Data availability, record scope, device, metric histograms and percentiles, collection period, and cache timestamps.

Parameters

propertyIdRequired: Searchata property ID from Search Console or Bing.
urlRequired: Public URL inside the connected property.
level: url (default) or origin. Origin queries require access to the full origin.
formFactor: PHONE (default), DESKTOP, TABLET, or ALL.

Get Referring Domains

backlinks_get_referring_domains

Returns websites that link to one public target domain in Searchata's backlink index. Use it for backlink research on your site or a competitor. No connected property is required. Results are domain-level; exact source-page URLs and anchor text are not included. Results use a stable pagination order, not score ranking. Empty results do not prove that no backlinks exist.

Use when: Find websites that link to a target domain or competitor.
Returns: Referring domains, available domain scores from 0 to 100, edge counts, domain availability, data date when known, and a next-page cursor. An edge count measures links between domains in the index; it is not a count of live source pages. Missing scores and dates are null.

Parameters

domainRequired: Public target domain, such as example.com. URLs are normalized to their domain.
limit: Maximum rows per page. Defaults to 50; maximum 100.
cursor: nextCursor from the previous response for the same domain.

Get an SEO Roadmap

seo_get_roadmap

Returns up to ten prioritized page investigations from Google Search Console by default. Use for 'what should I fix first?' Each action includes metrics, reasons, confidence, and explainable priority factors. This release does not read page content, run a crawl, or make website changes. Missing rows are not treated as zero traffic.

Use when: Choose the next SEO investigations using connected search evidence.
Returns: Ranked, deduplicated page actions, supporting metrics, coverage limits, and follow-up requests.

Parameters

propertyIdRequired: Searchata property ID from google_search_console_list_properties.
period: days (7–90) or startDate and endDate. Defaults to 28 reporting days ending three days before today in Search Console's timezone.
country, device, brandTerms, limit: Optional country/device filters, explicit brand terms, and up to 30 findings (default 10).
focus, maxEffort, businessPriorityUrls: Select growth, recovery, content, or technical_review. All current actions are small investigations; priority URLs provide explicit business context.

Get SEO Page Evidence

seo_get_page_evidence

Reads exact-page Search Console totals separately from query detail, with a previous-period comparison and a bounded daily trend. Use to inspect the evidence behind a roadmap action. It does not fetch the page, resolve unverified canonical aliases, or return page text, links, or schema.

Use when: Inspect search evidence for one known URL.
Returns: Independent page metrics, query metrics, available trend, dates, and missing-data warnings.

Parameters

propertyIdRequired: Searchata property ID from google_search_console_list_properties.
urlRequired: Exact HTTP(S) page URL inside the selected property.
period: days (7–90) or startDate and endDate. Defaults to 28 reporting days ending three days before today in Search Console's timezone.
country, device, brandTerms, limit: Optional country/device filters, explicit brand terms, and up to 30 findings (default 10).

Find Content Decay Candidates

seo_get_content_decay

Finds pages losing clicks between completed Search Console periods. Checks a bounded shortlist for sustained weekly declines and optionally a same-weekday period 364 days earlier. Traffic loss does not prove content is outdated. This is an on-demand report; it does not enable monitoring.

Use when: Investigate traffic declines and their measured patterns.
Returns: Decline candidates, losses, available weekly evidence, seasonal context, confidence, and next checks.

Parameters

propertyIdRequired: Searchata property ID from google_search_console_list_properties.
period: days (7–90) or startDate and endDate. Defaults to 28 reporting days ending three days before today in Search Console's timezone.
country, device, brandTerms, limit: Optional country/device filters, explicit brand terms, and up to 30 findings (default 10).
days, urls, minBaselineClicks, declinePercent, includeSeasonality: days is an alternative to period. Optionally restrict URLs or adjust thresholds (30 baseline clicks and 20% decline by default). Seasonal checks are optional and bounded.

Find Possible Competing Pages

seo_get_cannibalization

Finds multiple pages with meaningful impressions for the same query. Returns query-overlap candidates and observed leading-page changes. Use to review possible cannibalization. It does not establish identical search intent or recommend automatic page merges or deletion.

Use when: Review whether pages may compete for the same search intent.
Returns: Queries, competing-page candidates, metrics, previous leaders, and explicit intent-review requirements.

Parameters

propertyIdRequired: Searchata property ID from google_search_console_list_properties.
period: days (7–90) or startDate and endDate. Defaults to 28 reporting days ending three days before today in Search Console's timezone.
country, device, brandTerms, limit: Optional country/device filters, explicit brand terms, and up to 30 findings (default 10).
query, urls: Optional query terms or a list of up to ten page URLs to narrow the report.

Get a Query-Based Content Brief

seo_get_content_brief

Returns observed queries and search performance for a page to guide an editorial review. Use before drafting content changes. Only query_brief mode is supported: it cannot identify missing sections, thin content, or outdated statements without reading page content. The connected client must inspect the page before making those claims.

Use when: Prepare a page update brief from real search demand.
Returns: Page metrics, query evidence, user target-query observations, and instructions for a grounded content draft.

Parameters

propertyIdRequired: Searchata property ID from google_search_console_list_properties.
urlRequired: Exact HTTP(S) page URL inside the selected property.
period: days (7–90) or startDate and endDate. Defaults to 28 reporting days ending three days before today in Search Console's timezone.
country, device, brandTerms, limit: Optional country/device filters, explicit brand terms, and up to 30 findings (default 10).
mode, targetQueries: mode is query_brief. Supply up to 20 target queries as user goals.

Get Search Query Topic Groups

seo_get_topic_clusters

Groups observed Search Console queries and pages by shared terms. Use to explore topic coverage in queries mode. Groups are lexical candidates, not semantic content audits or a Google authority score. A missing query topic does not prove a missing content page.

Use when: Explore observed query groups and the pages associated with them.
Returns: Reproducible query groups, representative queries, associated pages, and reference-topic observations.

Parameters

propertyIdRequired: Searchata property ID from google_search_console_list_properties.
period: days (7–90) or startDate and endDate. Defaults to 28 reporting days ending three days before today in Search Console's timezone.
country, device, brandTerms, limit: Optional country/device filters, explicit brand terms, and up to 30 findings (default 10).
mode, topic, referenceTopics: mode is queries. Optionally filter by topic terms or compare up to 20 explicit reference topics.

Generate a JSON-LD Draft

seo_generate_schema

Generates Article, Organization, or BreadcrumbList JSON-LD from explicitly supplied facts for a connected page. Use to draft structured data. It does not read the live page or existing markup, infer missing facts, publish changes, or guarantee a rich result. Missing required facts return an incomplete result instead of invented values.

Use when: Create a structured-data draft from known facts.
Returns: JSON-LD or missing-fact requirements, provenance, template validation, and unverified page-consistency status.

Parameters

propertyIdRequired: Searchata property ID from google_search_console_list_properties.
urlRequired: Exact HTTP(S) page URL inside the selected property.
typesRequired: One or more of Article, Organization, BreadcrumbList.
factsRequired: Source explanation and typed article, organization, or ordered breadcrumb facts.