Skip to main content
The GSC tools connect Rankahead’s AI visibility data with your Google Search Console account. Use them to check whether your GSC integration is active, retrieve a dashboard of actionable search insights, and surface unread alerts about ranking changes or new striking-distance keyword opportunities. These tools are particularly useful for agents that need to cross-reference traditional SEO signals with AI citation data.

​
get_gsc_connection

Returns the status of your Google Search Console connection, including the verified site URL and the timestamp of the most recent data sync. Use this tool to confirm GSC is connected before calling other GSC tools. This tool takes no input parameters. 
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_gsc_connection",
    "arguments": {}
  },
  "id": 1
}
​
connected
boolean
Whether a valid GSC connection is active for your account.
​
siteUrl
string
The verified site URL associated with the GSC connection (e.g. https://acmecrm.com/).
​
lastSyncedAt
string
ISO 8601 timestamp of the most recent successful data sync from GSC.

​
get_gsc_dashboard

Returns a summary of your most actionable GSC insights. This includes queries in striking distance of a top-10 ranking, content gaps where you have impressions but low clicks, your top-performing posts by click volume, and any keyword cannibalization alerts. This tool takes no input parameters. 
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_gsc_dashboard",
    "arguments": {}
  },
  "id": 2
}
​
strikingDistanceQueries
object[]
Queries ranking in positions 4–20 with meaningful impression volume. These are candidates for quick ranking gains with targeted content updates.
​
strikingDistanceQueries[].query
string
The search query text.
​
strikingDistanceQueries[].position
number
Current average ranking position in GSC.
​
strikingDistanceQueries[].impressions
number
Impression count over the reporting period.
​
contentGaps
object[]
Pages with high impressions but low CTR, indicating a title or meta description opportunity.
​
topPostsByClicks
object[]
Your highest-traffic pages ranked by organic clicks over the reporting period.
​
cannibalizationAlerts
object[]
Pairs of pages competing for the same queries, which may be splitting ranking signals.

​
get_gsc_alerts

Returns recent unread GSC alerts. Alerts are generated automatically when Rankahead detects significant changes in your GSC data — such as a ranking drop on a monitored page or a query entering striking distance for the first time. This tool takes no input parameters. 
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_gsc_alerts",
    "arguments": {}
  },
  "id": 3
}
​
alerts
object[]
Array of unread alert objects.
​
alerts[].alertId
string
Unique identifier for the alert.
​
alerts[].type
string
Alert type. Common values include RANKING_DROP and STRIKING_DISTANCE_OPPORTUNITY.
​
alerts[].message
string
Human-readable description of what triggered the alert.
​
alerts[].detectedAt
string
ISO 8601 timestamp when the alert was generated.
​
alerts[].read
boolean
Whether the alert has been marked as read. This endpoint returns only unread alerts.

​
mark_gsc_alert_read

Marks one or all unread GSC alerts as read. If you omit alertId, all current unread alerts are marked as read in a single call.
​
alertId
string
Optional ID of a specific alert to mark as read. Omit to mark all unread alerts as read.
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "mark_gsc_alert_read",
    "arguments": {
      "alertId": "alr_05oep6v5r3hb"
    }
  },
  "id": 4
}
Call get_gsc_alerts after marking alerts read to confirm the unread count has cleared.