sync_history
Sync Search Console Analytics data into a local SQLite history to keep records beyond Google's 16-month limit, skipping final stored days and refreshing recent ones.
Instructions
Copy Search Analytics rows into the local SQLite history, one day at a time (keeps data past 16 months).
Days already stored and final are skipped; recent or empty days are refreshed. dimensions defaults to
query,page; add country,device for more detail (more rows). One call works for about 45 seconds and
then reports how many days are left — call it again to continue, or run gsc-mcp-full sync SITE --days N in a terminal (no time limit; put it in cron to keep history growing).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"site_url": "<site_url>"
},
"name": "sync_history"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | ||
| end_date | No | ||
| site_url | Yes | ||
| dimensions | No | query,page | |
| start_date | No | ||
| search_type | No | web | |
| refresh_provisional | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |