{"_id":"@mikusnuz/gsc-mcp","_rev":"6-a0c2ab171726ddae85fca1512e732f68","name":"@mikusnuz/gsc-mcp","dist-tags":{"latest":"1.3.3"},"versions":{"1.1.0":{"name":"@mikusnuz/gsc-mcp","version":"1.1.0","keywords":["mcp","google-search-console","gsc","seo","indexing-api","search-analytics","sitemaps","url-inspection"],"license":"MIT","_id":"@mikusnuz/gsc-mcp@1.1.0","maintainers":[{"name":"mikusnuz","email":"jooon530@gmail.com"}],"homepage":"https://github.com/mikusnuz/gsc-mcp#readme","bugs":{"url":"https://github.com/mikusnuz/gsc-mcp/issues"},"bin":{"gsc-mcp":"dist/index.js"},"dist":{"shasum":"6bcf9f33572ccc4ac235218efcae8e2bb09e1b71","tarball":"https://registry.npmjs.org/@mikusnuz/gsc-mcp/-/gsc-mcp-1.1.0.tgz","fileCount":5,"integrity":"sha512-0Uo023Tq4Rj3SNUO+DhofstgaqP6W7usGckU7wF+pxQP0QhsyM9sEXzXsq3hmtYTRznHXGMb3HGnnqmQfdgAsA==","signatures":[{"sig":"MEYCIQDMgvDa57XLr33VXxI9HU/UadMTjtlQ0Xc+4sWpWEtxqwIhAIKD4/RMAn9NndSnZbtnt1t48seAZ3OXvPNkuURAhK9W","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":21838},"main":"dist/index.js","types":"./dist/index.d.ts","gitHead":"25d7e917a9272a6c19c3e1923a1ce5fb23bc731e","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"mikusnuz","email":"jooon530@gmail.com"},"repository":{"url":"git+https://github.com/mikusnuz/gsc-mcp.git","type":"git"},"_npmVersion":"11.3.0","description":"MCP server for Google Search Console & Indexing API — full API coverage","directories":{},"_nodeVersion":"24.1.0","dependencies":{"zod":"^3.24.2","google-auth-library":"^9.15.1","@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/gsc-mcp_1.1.0_1771324505852_0.9676881397463271","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"@mikusnuz/gsc-mcp","version":"1.2.0","keywords":["mcp","google-search-console","gsc","seo","indexing-api","search-analytics","sitemaps","url-inspection"],"license":"MIT","_id":"@mikusnuz/gsc-mcp@1.2.0","maintainers":[{"name":"mikusnuz","email":"jooon530@gmail.com"}],"homepage":"https://github.com/mikusnuz/gsc-mcp#readme","bugs":{"url":"https://github.com/mikusnuz/gsc-mcp/issues"},"bin":{"gsc-mcp":"dist/index.js"},"dist":{"shasum":"d490cd8c035f7834fff6f98e924aa3da0940be7f","tarball":"https://registry.npmjs.org/@mikusnuz/gsc-mcp/-/gsc-mcp-1.2.0.tgz","fileCount":6,"integrity":"sha512-WWeDpTieT+x0WGSXFuUxxpQFB+sfQDbvONuF3bocgWBtjXqdy89KdZQWUa/khiasRXhF3Ib3khdoB+5Aa1QWBQ==","signatures":[{"sig":"MEQCIBM4asDx8+gMe2DPYVQRqdtIbxqUISt03136/76yuw2oAiBq0sx2vU50qPlwWywbZqu05EpV6jgdJ9xfOWpcw8KcUg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":29476},"main":"dist/index.js","types":"./dist/index.d.ts","gitHead":"513ebf1346ee04d12b9c5760d2f772714ade38ee","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"mikusnuz","email":"jooon530@gmail.com"},"repository":{"url":"git+https://github.com/mikusnuz/gsc-mcp.git","type":"git"},"_npmVersion":"11.3.0","description":"MCP server for Google Search Console & Indexing API — full API coverage","directories":{},"_nodeVersion":"24.1.0","dependencies":{"zod":"^3.24.2","google-auth-library":"^9.15.1","@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/gsc-mcp_1.2.0_1771429924903_0.5283779888633315","host":"s3://npm-registry-packages-npm-production"}},"1.3.0":{"name":"@mikusnuz/gsc-mcp","version":"1.3.0","keywords":["mcp","google-search-console","gsc","seo","indexing-api","search-analytics","sitemaps","url-inspection"],"license":"MIT","_id":"@mikusnuz/gsc-mcp@1.3.0","maintainers":[{"name":"mikusnuz","email":"jooon530@gmail.com"}],"homepage":"https://github.com/mikusnuz/gsc-mcp#readme","bugs":{"url":"https://github.com/mikusnuz/gsc-mcp/issues"},"bin":{"gsc-mcp":"dist/index.js"},"dist":{"shasum":"dcfd3feeeff3e92e57fe26f6e77c0084fcc1fd68","tarball":"https://registry.npmjs.org/@mikusnuz/gsc-mcp/-/gsc-mcp-1.3.0.tgz","fileCount":6,"integrity":"sha512-GYAMBaGGENnu4+QdK74QCzFoFqYXT48nA5pe5IgIB312kZqgqIb5vZQ00AfACUjrjRIlNxBOogO3+NK4plo3jw==","signatures":[{"sig":"MEYCIQCI6uABO7L2WYz21oi21Skef5u3Q3pSLK3AJBT+3WyregIhAOddIzrig1ivPY/P+ShSGbSAlDEmz5HdoMlw4peIYV1W","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":32463},"main":"dist/index.js","types":"./dist/index.d.ts","gitHead":"06a7ee936c81c414d1fa76116f1279d58b58f6e5","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"mikusnuz","email":"jooon530@gmail.com"},"repository":{"url":"git+https://github.com/mikusnuz/gsc-mcp.git","type":"git"},"_npmVersion":"11.9.0","description":"MCP server for Google Search Console & Indexing API — full API coverage","directories":{},"_nodeVersion":"25.6.1","dependencies":{"zod":"^3.24.2","google-auth-library":"^9.15.1","@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/gsc-mcp_1.3.0_1773854259552_0.895769042045969","host":"s3://npm-registry-packages-npm-production"}},"1.3.1":{"name":"@mikusnuz/gsc-mcp","version":"1.3.1","keywords":["mcp","google-search-console","gsc","seo","indexing-api","search-analytics","sitemaps","url-inspection"],"license":"MIT","_id":"@mikusnuz/gsc-mcp@1.3.1","maintainers":[{"name":"mikusnuz","email":"jooon530@gmail.com"}],"homepage":"https://github.com/mikusnuz/gsc-mcp#readme","bugs":{"url":"https://github.com/mikusnuz/gsc-mcp/issues"},"bin":{"gsc-mcp":"dist/index.js"},"dist":{"shasum":"fe8ebd21693b073e1877c66d6b02ef8a1f059730","tarball":"https://registry.npmjs.org/@mikusnuz/gsc-mcp/-/gsc-mcp-1.3.1.tgz","fileCount":14,"integrity":"sha512-dJHFXPRkfWAHm0bhavu4EGVmKyuVuRTeR3C/gKzjyXlZF8Yv2wxwHjhv14S9xPWhqTEtXN609pxH4oGW32HgeQ==","signatures":[{"sig":"MEYCIQCbGJtB90rhWtjUa4uBwyuvXE6l1RsQDmDUIcopqhuv9gIhAJpBH0xgYXSJs+EI6Oc44Bh7xTNwyD5XCI9GNcckNW8n","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":5644131},"main":"dist/index.js","types":"./dist/index.d.ts","gitHead":"cbdb59592036fc73ce852224ae25f86ac3667e5a","mcpName":"io.github.mikusnuz/gsc","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"mikusnuz","email":"jooon530@gmail.com"},"repository":{"url":"git+https://github.com/mikusnuz/gsc-mcp.git","type":"git"},"_npmVersion":"11.9.0","description":"MCP server for Google Search Console & Indexing API — full API coverage","directories":{},"_nodeVersion":"25.6.1","dependencies":{"zod":"^3.24.2","google-auth-library":"^9.15.1","@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/gsc-mcp_1.3.1_1773944011975_0.4909862978099908","host":"s3://npm-registry-packages-npm-production"}},"1.3.2":{"name":"@mikusnuz/gsc-mcp","version":"1.3.2","keywords":["mcp","google-search-console","gsc","seo","indexing-api","search-analytics","sitemaps","url-inspection"],"author":{"name":"mikusnuz"},"license":"MIT","_id":"@mikusnuz/gsc-mcp@1.3.2","maintainers":[{"name":"mikusnuz","email":"jooon530@gmail.com"}],"homepage":"https://github.com/mikusnuz/gsc-mcp#readme","bugs":{"url":"https://github.com/mikusnuz/gsc-mcp/issues"},"bin":{"gsc-mcp":"dist/index.js"},"dist":{"shasum":"bb34cbf600b02a0b52b8c3b2d0fd8f1f20c7864a","tarball":"https://registry.npmjs.org/@mikusnuz/gsc-mcp/-/gsc-mcp-1.3.2.tgz","fileCount":6,"integrity":"sha512-meSNPtzbzkyDsItnxQhxmT41aXZty3PbVGrEMoMoTsQGY8AgfzEBzsQ/FVUT5K+EYaB1FjdEyZSmIOF7oNWFmA==","signatures":[{"sig":"MEUCIQCFFV5HRtc2BNuvfbT8iyRQWKyqsSQSA1yjyf56m3basQIgGrU1fRpADDJ1vRxxemgJCRNvykH8ijtCdBGG95HYNDk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":39379},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"74b5d19900dc3ebe5c8b3b5c62c02c419cb9f663","mcpName":"io.github.mikusnuz/gsc","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"mikusnuz","email":"jooon530@gmail.com"},"repository":{"url":"git+https://github.com/mikusnuz/gsc-mcp.git","type":"git"},"_npmVersion":"11.9.0","description":"MCP server for Google Search Console & Indexing API — full API coverage","directories":{},"_nodeVersion":"25.6.1","dependencies":{"zod":"^3.24.2","google-auth-library":"^10.9.1","@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/gsc-mcp_1.3.2_1785832481088_0.03949542929171712","host":"s3://npm-registry-packages-npm-production"}},"1.3.3":{"name":"@mikusnuz/gsc-mcp","version":"1.3.3","mcpName":"io.github.mikusnuz/gsc","description":"MCP server for Google Search Console & Indexing API — full API coverage","type":"module","main":"dist/index.js","bin":{"gsc-mcp":"dist/index.js"},"engines":{"node":">=18"},"scripts":{"build":"tsc","start":"node dist/index.js","dev":"tsx src/index.ts"},"keywords":["mcp","google-search-console","gsc","seo","indexing-api","search-analytics","sitemaps","url-inspection"],"author":{"name":"mikusnuz"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/mikusnuz/gsc-mcp.git"},"homepage":"https://github.com/mikusnuz/gsc-mcp#readme","bugs":{"url":"https://github.com/mikusnuz/gsc-mcp/issues"},"dependencies":{"@modelcontextprotocol/sdk":"^1.30.0","google-auth-library":"^10.9.1","zod":"^3.24.2"},"devDependencies":{"@types/node":"^22.0.0","tsx":"^4.19.0","typescript":"^5.7.0"},"gitHead":"e2f5d54913f998a15493878a888cf14a4fdaa252","types":"./dist/index.d.ts","_id":"@mikusnuz/gsc-mcp@1.3.3","_nodeVersion":"25.6.1","_npmVersion":"11.9.0","dist":{"integrity":"sha512-RGkh/3xDrl1HwlVIk8UGVZ18PXmf/8+aSOc6s+6v+JrfOqlG+dgGJr2QK/44HMyZkoIu8YOUFgVc9Hp127Wpjg==","shasum":"9ca0c7835a3b66bb1e0464af2278d6dab0c644f6","tarball":"https://registry.npmjs.org/@mikusnuz/gsc-mcp/-/gsc-mcp-1.3.3.tgz","fileCount":6,"unpackedSize":39379,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCIPAfuMyGTHyTr4tyqiLwagmrqF4rQD9a0n5mUaIA3FgIgbosYzjSaNh0xq9CT571DMTVdx6609/TyJlCbyQmo48Q="}]},"_npmUser":{"name":"mikusnuz","email":"jooon530@gmail.com"},"directories":{},"maintainers":[{"name":"mikusnuz","email":"jooon530@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/gsc-mcp_1.3.3_1786005238330_0.6091525873745316"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-17T10:35:05.774Z","modified":"2026-08-06T08:33:58.636Z","1.1.0":"2026-02-17T10:35:06.013Z","1.2.0":"2026-02-18T15:52:05.083Z","1.3.0":"2026-03-18T17:17:39.678Z","1.3.1":"2026-03-19T18:13:32.189Z","1.3.2":"2026-08-04T08:34:41.235Z","1.3.3":"2026-08-06T08:33:58.510Z"},"bugs":{"url":"https://github.com/mikusnuz/gsc-mcp/issues"},"author":{"name":"mikusnuz"},"license":"MIT","homepage":"https://github.com/mikusnuz/gsc-mcp#readme","keywords":["mcp","google-search-console","gsc","seo","indexing-api","search-analytics","sitemaps","url-inspection"],"repository":{"type":"git","url":"git+https://github.com/mikusnuz/gsc-mcp.git"},"description":"MCP server for Google Search Console & Indexing API — full API coverage","maintainers":[{"name":"mikusnuz","email":"jooon530@gmail.com"}],"readme":"# gsc-mcp\n\n[![npm version](https://img.shields.io/npm/v/@mikusnuz%2Fgsc-mcp)](https://www.npmjs.com/package/@mikusnuz/gsc-mcp)\n\n[English](README.md) | [한국어](README.ko.md)\n\n[![MCP Badge](https://lobehub.com/badge/mcp/mikusnuz-gsc-mcp)](https://lobehub.com/mcp/mikusnuz-gsc-mcp)\n\nMCP server for **Google Search Console API** and **Google Indexing API** — full API coverage.\n\n## When to Use\n\n| Task | Tool |\n|------|------|\n| \"Check which queries my site ranks for\" | `search_analytics_query` |\n| \"Submit a URL for indexing\" | `indexing_publish` |\n| \"Find pages with indexing errors\" | `url_inspection_inspect` |\n| \"Get search performance data for the last 30 days\" | `search_analytics_query` |\n| \"Compare click-through rates between mobile and desktop\" | `search_analytics_query` (group by `device`) |\n| \"Submit my sitemap to Google\" | `sitemaps_submit` |\n| \"Batch submit URLs for indexing\" | `indexing_batch_publish` |\n\n> **For AI agents:** See [`llms.txt`](llms.txt) for a machine-readable summary. Copy [`templates/CLAUDE.md`](templates/CLAUDE.md) or [`templates/AGENTS.md`](templates/AGENTS.md) into your project to teach your agent about this MCP.\n\nUnlike other GSC MCP servers that only wrap `searchAnalytics.query`, this server exposes **every endpoint** available in the Google Search Console and Indexing APIs.\n\n## Tools (13)\n\n### Sites\n| Tool | Description |\n|------|-------------|\n| `sites_list` | List all sites (properties) in your Search Console |\n| `sites_get` | Get details of a specific site |\n| `sites_add` | Add a new site (property) |\n| `sites_delete` | Remove a site |\n\n### Sitemaps\n| Tool | Description |\n|------|-------------|\n| `sitemaps_list` | List all submitted sitemaps for a site |\n| `sitemaps_get` | Get details of a specific sitemap |\n| `sitemaps_submit` | Submit a sitemap |\n| `sitemaps_delete` | Delete a sitemap |\n\n### Search Analytics\n| Tool | Description |\n|------|-------------|\n| `search_analytics_query` | Query search performance data (clicks, impressions, CTR, position) with filtering and grouping. Supports hourly data with the `hour` dimension. |\n\n### URL Inspection\n| Tool | Description |\n|------|-------------|\n| `url_inspection_inspect` | Inspect a URL's index status, crawl info, rich results, AMP, and mobile usability |\n\n### Indexing API\n| Tool | Description |\n|------|-------------|\n| `indexing_publish` | Notify Google about URL updates or removals |\n| `indexing_get_metadata` | Get latest notification status for a URL |\n| `indexing_batch_publish` | Batch notify Google about up to 100 URL updates/removals in a single request |\n\n## Authentication\n\nTwo authentication methods are supported:\n\n### Option 1: OAuth2 Refresh Token\n\n```json\n{\n  \"mcpServers\": {\n    \"gsc-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@mikusnuz/gsc-mcp\"],\n      \"env\": {\n        \"GSC_CLIENT_ID\": \"your-client-id\",\n        \"GSC_CLIENT_SECRET\": \"your-client-secret\",\n        \"GSC_REFRESH_TOKEN\": \"your-refresh-token\"\n      }\n    }\n  }\n}\n```\n\nRequired OAuth2 scopes:\n- `https://www.googleapis.com/auth/webmasters`\n- `https://www.googleapis.com/auth/indexing`\n\n### Option 2: Service Account\n\n```json\n{\n  \"mcpServers\": {\n    \"gsc-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@mikusnuz/gsc-mcp\"],\n      \"env\": {\n        \"GSC_SERVICE_ACCOUNT_KEY_PATH\": \"/path/to/service-account-key.json\"\n      }\n    }\n  }\n}\n```\n\nThe service account must be added as an owner or user in Google Search Console for each site.\n\n## Setup Guide\n\n### OAuth2 Setup\n\n1. Go to [Google Cloud Console](https://console.cloud.google.com/)\n2. Create a project (or select existing)\n3. Enable **Search Console API** and **Indexing API**\n4. Create OAuth 2.0 credentials (Desktop app type)\n5. Use the [OAuth Playground](https://developers.google.com/oauthplayground/) to generate a refresh token with scopes:\n   - `https://www.googleapis.com/auth/webmasters`\n   - `https://www.googleapis.com/auth/indexing`\n\n### Service Account Setup\n\n1. Go to [Google Cloud Console](https://console.cloud.google.com/)\n2. Create a service account\n3. Download the JSON key file\n4. Enable **Search Console API** and **Indexing API**\n5. In Search Console, add the service account email as an owner for your sites\n\n## License\n\nMIT\n","readmeFilename":"README.md"}