Skip to content
Back to search

mcp-server-gsc

A Model Context Protocol (MCP) server providing access to Google Search Console

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ahonn--mcp-server-gsc/badge.svg)](/listings/ahonn--mcp-server-gsc)

HTML

<a href="/listings/ahonn--mcp-server-gsc"><img src="/api/listings/ahonn--mcp-server-gsc/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

npm install mcp-server-gsc

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 162 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Google Search Console MCP Server
  2. A Model Context Protocol (MCP) server providing comprehensive access to Google Search Console data with enhanced analytics capabilities.
  3. ## Features
  4. - **Enhanced Search Analytics**: Retrieve up to 25,000 rows of performance data
  5. - **Advanced Filtering**: Support for regex patterns and multiple filter operators
  6. - **Quick Wins Detection**: Automatically identify optimization opportunities
  7. - **Rich Dimensions**: Query, page, country, device, and search appearance analysis
  8. - **Flexible Date Ranges**: Customizable reporting periods with historical data access
  9. ### Sponsored by
  10. <a href="https://macuse.app?ref=mcp-server-gsc">
  11. <img src="https://macuse.app/logo-pill.png" width="200" alt="macuse.app">
  12. </a>
  13. [macuse.app](https://macuse.app) is a native macOS application that gives your AI superpowers by integrating AI assistants with macOS apps like Calendar, Mail, and Notes, plus universal UI control for any application. Supports Claude Desktop, Cursor, and Raycast with one-click setup. Privacy-first, runs locally.
  14. ## Prerequisites
  15. - Node.js 18 or later
  16. - Google Cloud Project with Search Console API enabled
  17. - Service Account credentials with Search Console access
  18. ## Installation
  19. ```bash
  20. npm install mcp-server-gsc
  21. ```
  22. ## Authentication Setup
  23. To obtain Google Search Console API credentials:
  24. 1. Visit the [Google Cloud Console](https://console.cloud.google.com/)
  25. 2. Create a new project or select an existing one
  26. 3. Enable the API:
  27. - Go to "APIs & Services" > "Library"
  28. - Search for and enable ["Search Console API"](https://console.cloud.google.com/marketplace/product/google/searchconsole.googleapis.com)
  29. 4. Create credentials:
  30. - Navigate to ["APIs & Services" > "Credentials"](https://console.cloud.google.com/apis/credentials)
  31. - Click "Create Credentials" > "Service Account"
  32. - Fill in the service account details
  33. - Create a new key in JSON format
  34. - The credentials file (.json) will download automatically
  35. 5. Grant access:
  36. - Open Search Console
  37. - Add the service account email (format: name@project.iam.gserviceaccount.com) as a property administrator
  38. ## Usage
  39. ### Claude Desktop Configuration
  40. ```json
  41. {
  42. "mcpServers": {
  43. "gsc": {
  44. "command": "npx",
  45. "args": ["-y", "mcp-server-gsc"],
  46. "env": {
  47. "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/credentials.json"
  48. }
  49. }
  50. }
  51. }
  52. ```
  53. ## Available Tools
  54. ### search_analytics
  55. Get comprehensive search performance data from Google Search Console with enhanced analytics capabilities.
  56. **Required Parameters:**
  57. - `siteUrl`: Site URL (format: `http://www.example.com/` or `sc-domain:example.com`)
  58. - `startDate`: Start date (YYYY-MM-DD)
  59. - `endDate`: End date (YYYY-MM-DD)
  60. **Optional Parameters:**
  61. - `dimensions`: Comma-separated list (`query`, `page`, `country`, `device`, `searchAppearance`, `date`)
  62. - `type`: Search type (`web`, `image`, `video`, `news`, `discover`, `googleNews`)
  63. - `aggregationType`: Aggregation method (`auto`, `byNewsShowcasePanel`, `byProperty`, `byPage`)
  64. - `rowLimit`: Maximum rows to return (default: 1000, max: 25000)
  65. - `dataState`: Data freshness (`all` or `final`, default: `final`)
  66. **Filter Parameters:**
  67. - `pageFilter`: Filter by page URL (supports regex with `regex:` prefix)
  68. - `queryFilter`: Filter by search query (supports regex with `regex:` prefix)
  69. - `countryFilter`: Filter by country ISO 3166-1 alpha-3 code (e.g., `USA`, `CHN`)
  70. - `deviceFilter`: Filter by device type (`DESKTOP`, `MOBILE`, `TABLET`)
  71. - `searchAppearanceFilter`: Filter by search feature (e.g., `AMP_BLUE_LINK`, `AMP_TOP_STORIES`)
  72. - `filterOperator`: Operator for filters (`equals`, `contains`, `notEquals`, `notContains`, `includingRegex`, `excludingRegex`)
  73. **Quick Wins Detection:**
  74. - `detectQuickWins`: Enable automatic detection of optimization opportunities (default: `false`)
  75. - `quickWinsConfig`: Configuration for quick wins detection:
  76. - `positionRange`: Position range to consider (default: `[4, 20]`)
  77. - `minImpressions`: Minimum impressions threshold (default: `100`)
  78. - `minCtr`: Minimum CTR percentage (default: `1`)
  79. **Example - Basic Query:**
  80. ```json
  81. {
  82. "siteUrl": "https://example.com",
  83. "startDate": "2024-01-01",
  84. "endDate": "2024-01-31",
  85. "dimensions": "query,page",
  86. "rowLimit": 5000
  87. }
  88. ```
  89. **Example - Advanced Filtering with Regex:**
  90. ```json
  91. {
  92. "siteUrl": "https://example.com",
  93. "startDate": "2024-01-01",
  94. "endDate": "2024-01-31",
  95. "dimensions": "page,query",
  96. "queryFilter": "regex:(AI|machine learning|ML)",
  97. "filterOperator": "includingRegex",
  98. "deviceFilter": "MOBILE",
  99. "rowLimit": 10000
  100. }
  101. ```
  102. **Example - Quick Wins Detection:**
  103. ```json
  104. {
  105. "siteUrl": "https://example.com",
  106. "startDate": "2024-01-01",
  107. "endDate": "2024-01-31",
  108. "dimensions": "query,page",
  109. "detectQuickWins": true,
  110. "quickWinsConfig": {
  111. "positionRange": [4, 15],
  112. "minImpressions": 500,
  113. "minCtr": 2
  114. }
  115. }
  116. ```
  117. ## License
  118. MIT
  119. ## Contributing
  120. Contributions are welcome! Please read our contributing guidelines before submitting pull requests.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.