{"_id":"google-searchconsole-mcp","_rev":"2-b6771eec78033fd2737fe76e1f347e7a","name":"google-searchconsole-mcp","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"google-searchconsole-mcp","version":"1.0.0","keywords":["mcp","model-context-protocol","claude","google-search-console","gsc","seo","search-analytics","webmaster-tools"],"author":{"name":"aashish"},"license":"MIT","_id":"google-searchconsole-mcp@1.0.0","maintainers":[{"name":"aashishm","email":"aashishm20606@gmail.com"}],"homepage":"https://github.com/aashish/gsc-mcp-server#readme","bugs":{"url":"https://github.com/aashish/gsc-mcp-server/issues"},"bin":{"gsc-mcp-auth":"dist/authenticate.js","google-searchconsole-mcp":"dist/index.js"},"dist":{"shasum":"cb3cf0048db1030949478c1037a9a4f75a3bd2d4","tarball":"https://registry.npmjs.org/google-searchconsole-mcp/-/google-searchconsole-mcp-1.0.0.tgz","fileCount":11,"integrity":"sha512-YMxunH4beJ53YxnnH0vXnX+HCoe6tjKQ+lAfBcZahQHdWO7f1lkXV80Ppdvvg34TRt6fzOUQDWOeAG1ZtIpOvA==","signatures":[{"sig":"MEQCIBj4WhfC2oDkdWrTlrIynDm3hZ6XbgMb58tXYrdXNkHMAiBnQz9GlkstKyFGqKTMCOhGfJguFOk0iNsEZKfwtHwM8g==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":82662},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"scripts":{"dev":"tsc && node dist/index.js","auth":"node dist/authenticate.js","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"aashishm","email":"aashishm20606@gmail.com"},"repository":{"url":"git+https://github.com/aashish/gsc-mcp-server.git","type":"git"},"_npmVersion":"11.8.0","description":"MCP server for Google Search Console - query search analytics, inspect URLs, analyze keywords, and more","directories":{},"_nodeVersion":"25.5.0","dependencies":{"open":"^10.1.0","googleapis":"^144.0.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/google-searchconsole-mcp_1.0.0_1772515185379_0.4497972982664251","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"google-searchconsole-mcp","version":"1.0.1","description":"MCP server for Google Search Console - query search analytics, inspect URLs, analyze keywords, and more","main":"dist/index.js","type":"module","bin":{"google-searchconsole-mcp":"dist/index.js","gsc-mcp-auth":"dist/authenticate.js"},"scripts":{"build":"tsc","start":"node dist/index.js","dev":"tsc && node dist/index.js","auth":"node dist/authenticate.js","prepublishOnly":"npm run build"},"keywords":["mcp","model-context-protocol","claude","google-search-console","gsc","seo","search-analytics","webmaster-tools"],"license":"MIT","author":{"name":"aashish"},"repository":{"type":"git","url":"git+https://github.com/aashish/gsc-mcp-server.git"},"engines":{"node":">=18"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","googleapis":"^144.0.0","open":"^10.1.0"},"devDependencies":{"@types/node":"^22.0.0","typescript":"^5.7.0"},"gitHead":"1ada043526103d440e9bbc40212ba507dfc8c53e","types":"./dist/index.d.ts","_id":"google-searchconsole-mcp@1.0.1","bugs":{"url":"https://github.com/aashish/gsc-mcp-server/issues"},"homepage":"https://github.com/aashish/gsc-mcp-server#readme","_nodeVersion":"25.5.0","_npmVersion":"11.8.0","dist":{"integrity":"sha512-HyjoeLX7Q6gT76pEcNix2uFo/gc5ED2qbj9Tx4f9UGAs6Kr8zckMAceO1rc06EGMrPCkxiHa441vQ9qkbR+6fg==","shasum":"c6b8c4156affc59e9ce18e42fcd2e8e9553e0811","tarball":"https://registry.npmjs.org/google-searchconsole-mcp/-/google-searchconsole-mcp-1.0.1.tgz","fileCount":13,"unpackedSize":93464,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIFJD5QyxPXYGCbQbjwGCKwPXyZXdARS8wGqF9T2zkRYwAiEArxjIc51QwGabxt+Bah0ZZO4FFdNcJ8jojE0VM1TsanM="}]},"_npmUser":{"name":"aashishm","email":"aashishm20606@gmail.com"},"directories":{},"maintainers":[{"name":"aashishm","email":"aashishm20606@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/google-searchconsole-mcp_1.0.1_1773035217982_0.6943181060691657"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-03T05:19:45.379Z","modified":"2026-03-09T05:46:58.224Z","1.0.0":"2026-03-03T05:19:45.546Z","1.0.1":"2026-03-09T05:46:58.126Z"},"bugs":{"url":"https://github.com/aashish/gsc-mcp-server/issues"},"author":{"name":"aashish"},"license":"MIT","homepage":"https://github.com/aashish/gsc-mcp-server#readme","keywords":["mcp","model-context-protocol","claude","google-search-console","gsc","seo","search-analytics","webmaster-tools"],"repository":{"type":"git","url":"git+https://github.com/aashish/gsc-mcp-server.git"},"description":"MCP server for Google Search Console - query search analytics, inspect URLs, analyze keywords, and more","maintainers":[{"name":"aashishm","email":"aashishm20606@gmail.com"}],"readme":"# Google Search Console MCP Server\n\n[![npm version](https://img.shields.io/npm/v/google-searchconsole-mcp)](https://www.npmjs.com/package/google-searchconsole-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nA [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that connects **Google Search Console** to AI assistants like **Claude Desktop**, **Cursor**, **Windsurf**, and any MCP-compatible client. Analyze your SEO data, inspect URLs, find keyword opportunities, and track search performance — all through natural language.\n\n> **No Google Cloud setup required.** Install, authenticate with your Google account, and start querying your Search Console data in under 2 minutes.\n\n## What Can You Do?\n\nAsk Claude questions like:\n- *\"What are my top performing pages this month?\"*\n- *\"Find keywords where I have high impressions but low CTR\"*\n- *\"Compare my search performance this month vs last month\"*\n- *\"Is this URL indexed? Any issues?\"*\n- *\"Show me my brand vs non-brand traffic split\"*\n\n## Quick Start\n\n### 1. Install\n\n```bash\nnpm install -g google-searchconsole-mcp\n```\n\n### 2. Authenticate (one time)\n\n```bash\ngsc-mcp-auth\n```\n\nOpens your browser — log in with your Google account and grant Search Console read access. Your tokens are saved locally to `~/.gsc-mcp/tokens/`. **Your data stays on your machine.**\n\n**Multiple accounts:**\n\n```bash\ngsc-mcp-auth --alias work\ngsc-mcp-auth --alias personal\ngsc-mcp-auth --list\n```\n\n### 3. Add to Claude Desktop\n\nAdd to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):\n\n```json\n{\n  \"mcpServers\": {\n    \"google-search-console\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"google-searchconsole-mcp\"]\n    }\n  }\n}\n```\n\nRestart Claude Desktop. Done — your Search Console data is now available in Claude.\n\n### Use with Other MCP Clients\n\nWorks with any MCP-compatible client including **Cursor**, **Windsurf**, **VS Code + Cline**, and more. Just point the MCP client to:\n\n```bash\nnpx google-searchconsole-mcp\n```\n\n## Available Tools (13 SEO Tools)\n\n| Tool | Description |\n|------|-------------|\n| `list_accounts` | List all authenticated Google accounts and their Search Console sites |\n| `list_sites` | List all Search Console properties you have access to |\n| `query_search_analytics` | Query clicks, impressions, CTR, and position by any dimension (query, page, country, device, date) |\n| `inspect_url` | Check URL indexing status, mobile usability, and rich results eligibility |\n| `list_sitemaps` | List all submitted sitemaps and their status |\n| `find_keyword_opportunities` | Discover high-impression, low-CTR keywords — quick SEO wins |\n| `get_top_pages` | Get top pages sorted by clicks, impressions, CTR, or position |\n| `compare_performance` | Compare search performance between two time periods (week-over-week, month-over-month) |\n| `analyze_brand_queries` | Analyze brand vs non-brand organic traffic split |\n| `get_keyword_trend` | Get daily trend data for a specific keyword |\n| `export_analytics` | Export search analytics data as CSV or JSON |\n| `query_by_search_appearance` | Filter results by search appearance: AMP, FAQ, HowTo, Rich Results, Video, etc. |\n| `query_by_search_type` | Filter by search type: web, image, video, news, or discover |\n\n## Examples\n\n### Example 1: Find your top performing pages\n\n**User prompt:** \"Show me my top 10 pages by clicks for the last 30 days\"\n\n**Expected behavior:**\n- Calls `get_top_pages` with your site URL, date range of last 30 days, `sortBy: \"clicks\"`, and `limit: 10`\n- Returns a ranked list of your top 10 pages with clicks, impressions, CTR, and average position for each\n- Helps identify your strongest content and highest-traffic landing pages\n\n### Example 2: Discover keyword optimization opportunities\n\n**User prompt:** \"Find keywords where I have high impressions but low CTR on example.com\"\n\n**Expected behavior:**\n- Calls `find_keyword_opportunities` with your site URL and a 28-day date range\n- Filters for queries with 100+ impressions and less than 3% CTR within the top 20 positions\n- Returns a list of keywords where better titles, meta descriptions, or content could significantly increase clicks\n\n### Example 3: Check if a URL is indexed by Google\n\n**User prompt:** \"Check if https://example.com/blog/my-new-post is indexed\"\n\n**Expected behavior:**\n- Calls `inspect_url` with the site property and the full URL to inspect\n- Returns indexing status (indexed, crawled but not indexed, not found, etc.), last crawl date, mobile usability status, and any rich results detected\n- Identifies issues preventing indexing such as robots.txt blocks, noindex tags, or crawl errors\n\n### Example 4: Compare this month vs last month\n\n**User prompt:** \"Compare my search performance this month vs last month for example.com\"\n\n**Expected behavior:**\n- Calls `compare_performance` with current and previous month date ranges\n- Returns queries that gained or lost the most clicks, with delta values for clicks, impressions, CTR, and position\n- Highlights trending keywords and declining pages to prioritize optimization efforts\n\n## Use Cases\n\n- **SEO Performance Monitoring** — Track clicks, impressions, CTR, and average position over time\n- **Keyword Research & Opportunities** — Find keywords you rank for with high impressions but low CTR\n- **Content Optimization** — Identify which pages need improvement based on search data\n- **Technical SEO Audits** — Check URL indexing status, sitemap health, and mobile usability\n- **Competitive Analysis** — Compare performance periods to spot trends and drops\n- **Reporting** — Export data for SEO reports and dashboards\n- **Brand Monitoring** — Track brand vs non-brand search traffic\n\n## How Authentication Works\n\nThis package ships with built-in OAuth credentials — you don't need to create a Google Cloud project. When you run `gsc-mcp-auth`:\n\n1. Your browser opens Google's login page\n2. You log in with **your** Google account\n3. You grant read-only access to **your** Search Console data\n4. Tokens are saved locally on your machine (`~/.gsc-mcp/tokens/`)\n\n**Your data never leaves your machine.** The OAuth credentials just identify the app — each user authenticates separately and can only access their own Search Console data.\n\n### Advanced: Use Your Own OAuth Credentials\n\nIf you prefer to use your own Google Cloud project:\n\n**Option A: Environment variables**\n```bash\nexport GSC_CLIENT_ID=\"your-client-id\"\nexport GSC_CLIENT_SECRET=\"your-client-secret\"\n```\n\n**Option B: Credentials file**\nSave your OAuth credentials JSON to `~/.gsc-mcp/credentials.json`\n\n<details>\n<summary>How to create your own Google Cloud OAuth credentials</summary>\n\n1. Go to [Google Cloud Console](https://console.cloud.google.com/apis/credentials)\n2. Create a project (or select existing)\n3. Enable the **Google Search Console API**\n4. Go to **Credentials** > **Create Credentials** > **OAuth 2.0 Client ID**\n5. Choose **Desktop app** as application type\n6. Download the credentials JSON file\n\n</details>\n\n## Requirements\n\n- **Node.js** >= 18\n- A Google account with access to Google Search Console\n\n## Related\n\n- [Model Context Protocol](https://modelcontextprotocol.io) — The open standard for AI-tool integration\n- [Claude Desktop](https://claude.ai/download) — Anthropic's desktop AI assistant\n- [MCP Server Registry](https://github.com/punkpeye/awesome-mcp-servers) — Curated list of MCP servers\n\n## Privacy Policy\n\nSee [PRIVACY.md](./PRIVACY.md) for our complete privacy policy.\n\n**TL;DR:** This extension runs locally on your machine. OAuth tokens are stored locally in `~/.gsc-mcp/`, and all Search Console data is queried directly from Google's API without passing through any intermediary. No data is collected, stored, or transmitted to any third party by this MCP server.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}