Index of every page on this site: llms.txt
Skip to content

Connect an agent to gscdump

Agents can use the packaged skill to run CLI commands. An MCP client can call live Google tools. The MCP server reads live Google data, not your local Store, and does not expose Bing tools.

Choose a connection

ConnectionUse it forFirst command
Agent skillCLI commands, Store queries, Bing, and Reportsgscdump skill install --agent codex
MCP serverLive Google requests through a stdio clientgscdump mcp

Check the commands reference for CLI setup. Authenticate first with Choose access.

Set it up

gscdump skill install --agent codex
gscdump auth status --json
gscdump sites --json

Use --agent claude for Claude Code or --agent codex for Codex. For another client that reads agent skills, pass --target /path/to/skills. The CLI writes a gscdump/ directory there. Have the agent read the installed SKILL.md before its first gscdump task. You can also read the raw SKILL.md or view the skill on skilld.

The skill runs CLI commands with your selected authentication and local Store access. It instructs agents to ask before Site, sitemap, indexing, or Store deletion changes. It may send a sanitized CLI papercut report for each distinct problem, unless you forbid reporting. See the skill text for its reporting rules.

For MCP, configure your client's stdio server command as gscdump mcp. Pass the same profile and environment credentials to that process. The server can list tools before authentication, but Google calls then return an access error.

Ask for one Site and Report

Ask: “List my Search Console Sites. Run the movers Report for example.com for two complete weeks. Show the dates, source, changed pages, and uncertainty.” Review the returned Site and date window before acting. MCP exposes list-reports and run-report; its live Report set includes brand, movers, opportunities, pre-publish, and risks. The Reports reference describes their inputs.

If the agent cannot read data

Check gscdump auth status --json and gscdump sites --json in the same profile. Restart an MCP client after changing its environment credentials. If it requests growth, health, or triage through MCP, use the CLI with a Store instead. If a live fetch reaches its row budget, describe the result as partial.

Try an investigation

Use the weekly traffic review to check the Report against rows. More setup: Start.