# gscdump

> gscdump syncs Google Search Console data, backfills up to 16 months of available history, and preserves your collected data for MCP, API, and SQL.

Canonical Origin: https://gscdump.com/

**Agent Skills:**

Skills an agent can install from this site. The index at https://gscdump.com/.well-known/agent-skills/index.json carries a sha256 digest for each one.

## LLM Resources

- [Full Content](https://gscdump.com/llms-full.txt): Complete page content in markdown format.
- [sitemap.xml](https://gscdump.com/sitemap.xml): XML sitemap for search engines and crawlers.
- [robots.txt](https://gscdump.com/robots.txt): Crawler rules and permissions.

## Agent Skills

- [gscdump](https://gscdump.com/SKILL.md): Drive the `gscdump` CLI for Google Search Console and Bing in Local or Hosted mode. Sync Google rows to a local Store, export Bing datasets, run SEO Analyzers and Reports, inspect Indexing Evidence, and manage sitemaps. Use when the user mentions gscdump, Search Console data, Bing Webmaster data, or GSC automation.

## Pages

- [gscdump · Google Search Console data for agents](/): gscdump syncs Google Search Console data, backfills up to 16 months of available history, and preserves your collected data for MCP, API, and SQL.
- [Builders · gscdump](/builders): Add Google Search Console data to your product. gscdump syncs each Site and keeps its history; your server reads it through a typed SDK.
- [Pricing · gscdump](/pricing): gscdump backfills up to 16 months of available Search Console history and preserves it. Free during beta, with CLI exports free for good.
- [Privacy · gscdump](/privacy): What personal data gscdump collects, why, who receives it, how long it is kept, and how to disconnect a Site, revoke access, or delete your account.
- [gscdump CLI skill · gscdump](/skill): The gscdump agent skill: the instructions Claude Code and other agents load to run the gscdump CLI, export Search Console data, and query it with SQL.
- [Support · gscdump](/support): Get help with gscdump: email support, the MCP setup docs, and fixes for an empty Site list, authorization errors, and a lost Google connection.
- [Terms · gscdump](/terms): The terms for using gscdump during beta: acceptable use, Google API data rules, no warranty, termination, changes to these terms, and how to contact us.
- [Trust · gscdump](/trust): How gscdump handles your Search Console data: a read-only Google scope, encrypted tokens, open formats, no resale, no scores, and what export covers today.

- [Google Search Console devtools · gscdump](/google-search-console): View Google Search Console page stats in Nuxt and Vite DevTools. Follow page navigation, compare clicks and impressions, and read top queries with gscdump.
- [Google Search Console in Nuxt · gscdump](/google-search-console/nuxt): Add Google Search Console to Nuxt DevTools. Set up the gscdump module to view page clicks, impressions, position, and queries as you develop your app.
- [Google Search Console in Vite · gscdump](/google-search-console/vite): Add Google Search Console to Vite DevTools. Set up the gscdump plugin to view page clicks, impressions, position, and queries as you develop your app.

- [gscdump CLI](/gscdump-cli): Read Search Console data, keep local history, and investigate search traffic with gscdump.
- [Analyzers](/gscdump-cli/api/analyzers): Choose a gscdump Analyzer to examine changes in clicks, impressions, queries, and pages.
- [Bing](/gscdump-cli/api/bing): Connect Bing Webmaster Tools and export Bing data with gscdump.
- [Commands](/gscdump-cli/api/commands): CLI commands and global flags for gscdump.
- [Export](/gscdump-cli/api/export): Export the gscdump Store to Parquet, CSV, JSON, SQLite, and DuckDB.
- [Query](/gscdump-cli/api/query): Filter Google search data and run SQL queries over the gscdump Store.
- [Reports](/gscdump-cli/api/reports): Run gscdump Reports with date windows, comparisons, and the inputs each Report requires.
- [Sync](/gscdump-cli/api/sync): Sync and backfill Google Search Console data with gscdump.
- [AI integration](/gscdump-cli/guides/ai-integration): This guide has moved to a task page.
- [Authentication](/gscdump-cli/guides/authentication): This guide has moved to a task page.
- [Check search visibility](/gscdump-cli/guides/check-visibility): Review page overlap and dated Indexing Evidence before changing pages or sitemaps.
- [Compare Google and Bing Indexing Evidence](/gscdump-cli/guides/check-visibility/google-and-bing): Read each Search Engine's dated observation for one URL without merging verdicts.
- [Check URL Indexing Evidence and sitemaps](/gscdump-cli/guides/check-visibility/indexing-evidence): Inspect Google observations, read saved results, and check sitemap membership for URLs.
- [Check page overlap before publishing](/gscdump-cli/guides/check-visibility/page-overlap): Compare a proposed topic with pages and queries already visible in the same Site.
- [CLI charts](/gscdump-cli/guides/cli-charts): This guide has moved to a task page.
- [Getting started](/gscdump-cli/guides/getting-started): This guide has moved to a task page.
- [Keep historical data in a Store](/gscdump-cli/guides/historical-database): This guide has moved to a task page.
- [Investigate search traffic](/gscdump-cli/guides/investigate-traffic): Pick a repeatable SEO investigation and check each Report against source rows.
- [Separate brand and non-brand traffic](/gscdump-cli/guides/investigate-traffic/brand-traffic): Define brand variants, compare equal windows, and check whether traffic mix changed.
- [Compare traffic by device and search type](/gscdump-cli/guides/investigate-traffic/device-gaps): Check mobile and desktop differences within one Search Console search type at a time.
- [Check whether search growth is seasonal](/gscdump-cli/guides/investigate-traffic/growth-trends): Compare complete windows and Store history before calling a traffic change a trend.
- [Find queries with impressions but few clicks](/gscdump-cli/guides/investigate-traffic/impressions-no-clicks): Inspect zero-click queries, their pages and positions, without claiming AI result attribution.
- [Find search queries with low CTR](/gscdump-cli/guides/investigate-traffic/low-ctr): Use the opportunities Report and CTR Analyzers to check pages before editing them.
- [Investigate a page traffic drop](/gscdump-cli/guides/investigate-traffic/traffic-drop): Check a page's clicks, queries, Report Sections, and dated Indexing Evidence.
- [Review search traffic each week](/gscdump-cli/guides/investigate-traffic/weekly-triage): Compare two complete weeks, inspect a movers Report Section, and pick a follow-up.
- [SEO analysis](/gscdump-cli/guides/seo-analysis): This guide has moved to a task page.
- [Start with gscdump CLI](/gscdump-cli/guides/start): Choose access, read one live Search Console result, or connect an agent.
- [Choose CLI access](/gscdump-cli/guides/start/choose-access): Compare the Local and Hosted access modes, then set up one of them.
- [Connect an agent to gscdump](/gscdump-cli/guides/start/connect-an-agent): Set up the packaged agent skill or MCP server and check one Search Console result.
- [Run your first Search Console query](/gscdump-cli/guides/start/first-result): Connect a Site and read live clicks, impressions, and position from Google Search Console.
- [URL inspection and indexing](/gscdump-cli/guides/url-indexing): This guide has moved to a task page.
- [Use Search Console data](/gscdump-cli/guides/use-data): Save history in a Store, then filter and export live or stored rows.
- [Save Search Console history in a Store](/gscdump-cli/guides/use-data/build-history): Preview, sync, check, and maintain local Search Console history with the CLI.
- [Query and export search data](/gscdump-cli/guides/use-data/query-and-export): Filter live or stored Search Console rows, save query output, and read terminal charts.
- [gscdump SDK](/gscdump-sdk): Build with direct search clients or hosted gscdump data.
- [Direct client exports](/gscdump-sdk/api/direct-client): Public imports for Google Search Console, Bing Webmaster, queries, and date helpers.
- [Hosted HTTP](/gscdump-sdk/api/hosted-http): Call typed v1 operations and handle API errors, rate limits, and retries.
- [Realtime](/gscdump-sdk/api/realtime): Receive hosted change notifications with tickets, replay, and application resync.
- [Build an integration](/gscdump-sdk/guides/build-integrations): Keep the API key on your server, then connect a UI or delivery handler.
- [Serve hosted analytics with Hono or Express](/gscdump-sdk/guides/build-integrations/hono-express): Share one SDK request behind either server framework.
- [Read hosted analytics in Next.js](/gscdump-sdk/guides/build-integrations/nextjs): Call hosted analytics in a route handler and render a server page.
- [Read hosted analytics in Nuxt](/gscdump-sdk/guides/build-integrations/nuxt): Call gscdump from a Nuxt server route and render rows in a page.
- [Show new hosted data in the browser](/gscdump-sdk/guides/build-integrations/realtime): Use a short-lived ticket, apply events before ACK, and resync through HTTP.
- [Receive and verify gscdump webhooks](/gscdump-sdk/guides/build-integrations/webhooks): Verify the raw body before processing a delivery.
- [Direct client guide locations](/gscdump-sdk/guides/direct-clients): Find direct Google and Bing guides.
- [SDK starting points](/gscdump-sdk/guides/getting-started): Find the new direct and hosted first-result guides.
- [Hosted integration guide locations](/gscdump-sdk/guides/hosted-integrations): Find hosted access, data, and operations guides.
- [Operate a hosted integration](/gscdump-sdk/guides/operate): Manage API keys, access, errors, and safe retries.
- [Handle hosted API errors and retries](/gscdump-sdk/guides/operate/errors-and-retry): Read typed failures, respect Retry-After, and avoid duplicate mutations.
- [Set up keys and scopes for hosted data](/gscdump-sdk/guides/operate/keys-and-scopes): Match credential class, fixed scopes, and Site ownership.
- [Read search data](/gscdump-sdk/guides/read-data): Choose rows, Reports, Indexing Evidence, or sitemaps.
- [Read Bing Indexing Evidence and traffic](/gscdump-sdk/guides/read-data/direct-bing): Check a URL and Site traffic with the direct Bing client.
- [Page through Search Analytics results](/gscdump-sdk/guides/read-data/direct-search-analytics): Query Google rows with a Site, dimensions, and Pacific reporting dates.
- [Read hosted analytics rows and Reports](/gscdump-sdk/guides/read-data/hosted-analytics): Choose raw rows or a Report with totals and sync metadata.
- [Read saved Indexing Evidence for a Site](/gscdump-sdk/guides/read-data/hosted-indexing): Review dated URL observations without issuing a new inspection.
- [Check sitemap membership and changes](/gscdump-sdk/guides/read-data/hosted-sitemaps): Read a Site generation, exact URL membership, and dated changes.
- [Start with the SDK](/gscdump-sdk/guides/start): Choose a data path and make one request.
- [Choose how your app reads search data](/gscdump-sdk/guides/start/choose-access): Pick direct Google or Bing calls, or hosted gscdump data.
- [Find your Sites in Google Search Console](/gscdump-sdk/guides/start/direct-first-result): Create a direct Google client and list accessible Sites.
- [Fetch your first hosted analytics rows](/gscdump-sdk/guides/start/hosted-first-result): Query an authorized Site with a server-held API key.
- [Learn Google Search Console](/learn-google-search-console): Read your Search Console reports, understand data limits, and use the API when you need more control.
- [Add social accounts to Search Console and read their Google traffic](/learn-google-search-console/social-platform-properties): Add Instagram, TikTok, X, or YouTube as a Search Console platform property. Understand first-data delays and what Google traffic says about your posts.
- [Google Search Console weekly and monthly views: read the trend](/learn-google-search-console/weekly-monthly-views): Switch Search Console to weekly or monthly views. Follow a real chart comparison and check axis scales and incomplete periods before reporting a traffic change.
- [Use AI agents with Search Console data](/learn-google-search-console/ai-agents): Choose a Search Console task for an agent, check your registered Sites and their synced dates, then connect Claude, ChatGPT, or another client through MCP.
- [Use Claude Code for Search Console analysis](/learn-google-search-console/ai-agents/claude-code-seo): Connect Claude Code to gscdump MCP, verify registered site access, and combine search data with a careful review of local content.
- [Check your Search Console MCP connection](/learn-google-search-console/ai-agents/mcp-server): Check that your agent reaches gscdump MCP. List registered Sites, confirm synced dates, make one bounded request, and tell authorization errors apart.
- [SEO workflows with Search Console MCP](/learn-google-search-console/ai-agents/seo-workflows): Run page-loss reviews, query investigations, and targeted URL inspection with comparable periods and traceable tool evidence.
- [Google Search Console API: make your first report](/learn-google-search-console/api): Make an authorized Search Console API request, read the returned metrics, and choose the right guide for filters, quotas, or hourly data.
- [Search Console API authentication with OAuth](/learn-google-search-console/api/authentication): Set up read-only Google OAuth access, confirm property permissions, and diagnose expired tokens or redirect errors.
- [Search Console hourly API data: request and check recent hours](/learn-google-search-console/api/hourly-search-analytics-api): Request hourly Search Console data with hour and hourly_all. Preserve timestamp offsets and inspect incomplete-hour metadata before comparing recent traffic.
- [Build a Search Console API query](/learn-google-search-console/api/query-builder): Build a mobile page report, combine filters, and paginate Search Analytics results without confusing returned rows with complete data.
- [Search Console API rate limits and quota errors](/learn-google-search-console/api/rate-limits): Identify Search Analytics request and load quotas, check URL Inspection limits, and choose a useful response to quota errors.
- [Google Search Console data limits](/learn-google-search-console/limits): Find the right check for missing history, truncated rows, delayed data, or a mismatch with Analytics.
- [Search Console 1,000-row limit: why totals and rows differ](/learn-google-search-console/limits/1000-row-limit): Diagnose a Search Console table that stops at 1,000 rows or fails to match the chart total. Check filters, aggregation, and query privacy.
- [Google Search Console data retention: the 16-month limit explained](/learn-google-search-console/limits/16-month-data-retention): Search Console exposes 16 months of search performance data. Learn what ages out, what BigQuery does not backfill, and how to preserve your history.
- [Search Console BigQuery export or API history: which fits?](/learn-google-search-console/limits/bigquery-alternative): Choose BigQuery for ongoing bulk exports or the API for earlier available history. Check first-export dates, table aggregation, and retention settings.
- [Google Search Console data delay: preliminary vs. finalized data](/learn-google-search-console/limits/data-delay): Check preliminary data, report dates, and API metadata before diagnosing missing Search Console traffic. Understand the usual delay and when to investigate.
- [Google Search Console export limits](/learn-google-search-console/limits/export-row-limits): Choose between report downloads, API pagination, and BigQuery. Keep the 1,000-row report cap separate from API response size and daily data limits.
- [Search Console vs. GA4: why your numbers don't match](/learn-google-search-console/limits/gsc-vs-ga4): Search Console clicks and GA4 sessions measure different events. See how collection, attribution, time zones, filtering, and canonical URLs create the gap.
- [Search Console Performance reports](/learn-google-search-console/performance): Choose a chart view and check what a change in search traffic actually tells you.
- [Search Console AI-powered configuration: check the suggested filters](/learn-google-search-console/performance/ai-powered-configuration): Follow a tested Search Console prompt from request to report settings. Check dates, countries, devices, and metrics before interpreting the resulting chart.
- [Search Console branded queries: use the filter without overreading it](/learn-google-search-console/performance/branded-queries-filter): Separate branded and non-branded search traffic. Understand Google's classification, compare it with query matching, and check why the filter may be missing.
- [Search Console annotations: record changes beside your traffic](/learn-google-search-console/performance/custom-annotations): Add a dated note to your Search Console chart. Learn what to record, how to investigate a change, and why annotations disappear from some views.
- [Search Console generative AI reports: read impressions correctly](/learn-google-search-console/performance/generative-ai-performance-reports): Read the dedicated Search Console AI reports. Follow a real impressions chart and understand how Search and Discover count visibility differently.
- [Search Console research and methods](/learn-google-search-console/research): Assess published Search Console findings by their measurement dates, sample, and denominator. Reproduce the examples before applying a headline to your own repo...
- [Search Console query gaps: what the studies actually measure](/learn-google-search-console/research/gsc-data-loss-study): Read the evidence behind missing-query percentages. Compare dated Ahrefs findings, distinguish attribution from privacy, and reproduce a simple weighting exampl...
- [Google Search Console MCP server · gscdump](/mcp): gscdump is a hosted Google Search Console MCP server. Connect ChatGPT or Claude with OAuth and query history kept past Google's 16-month window.
- [Connect Google Search Console to ChatGPT · gscdump](/mcp/chatgpt): Connect Google Search Console to ChatGPT with gscdump. Create an MCP app in ChatGPT on the web, approve read-only access, then ask about your Sites.
- [Connect Google Search Console to Claude · gscdump](/mcp/claude): Connect Google Search Console to Claude with gscdump. Add one custom connector, approve read-only access, then ask about your Sites in claude.ai or the apps.
- [Search Console tools · gscdump](/tools): Free canned queries over your synced Google Search Console record: striking distance, cannibalization, content decay, movers, zero-click, and index status.
- [Keyword cannibalization checker · gscdump](/tools/cannibalization): Free keyword cannibalization checker for Google Search Console. Lists queries where 2 or more of your pages get impressions, with the click split per page.
- [Content decay detector · gscdump](/tools/content-decay): Pages in your Google Search Console record whose clicks fell 20% or more against the previous 28 days, with the clicks lost. Free with a Google sign-in.
- [Bulk index checker · gscdump](/tools/index-checker): Index verdict, coverage state, last crawl, and Google canonical for up to 50 URLs at once, from the URL Inspection API. Free with a Google sign-in.
- [Movers and shakers · gscdump](/tools/movers): Queries whose clicks changed 20% or more against the previous 28 days in your Search Console record, split into rising and declining. Free with Google sign-in.
- [Opportunity keywords · gscdump](/tools/opportunity): Queries in your Google Search Console record whose CTR sits below the benchmark for their position, ranked by click gap. Free with a Google sign-in.
- [Striking distance keywords · gscdump](/tools/striking-distance): Queries ranking 4-20 in your Google Search Console record over the last 28 days, by impressions, with CTR and clicks. Free with a Google sign-in.
- [Zero-click keywords · gscdump](/tools/zero-click): Queries in your Google Search Console record in the top 10 with 100 or more impressions and CTR under 1% over 28 days. Free with a Google sign-in.