mcp-gsc  by AminForou

Conversational SEO analysis for Google Search Console

Created 11 months ago
428 stars

Top 69.2% on SourcePulse

GitHubView on GitHub
Project Summary

<2-3 sentences summarising what the project addresses and solves, the target audience, and the benefit.> This project integrates Google Search Console (GSC) data with Claude AI, allowing SEO professionals to analyze their website's performance and health through natural language conversations. It simplifies complex SEO data retrieval and interpretation, offering actionable insights without requiring direct GSC interface navigation or coding expertise.

How It Works

The tool acts as a server that connects to the Google Search Console API, enabling Claude AI to access and process GSC data. Users interact with Claude, which then utilizes specific tools (e.g., get_search_analytics, inspect_url_enhanced) to fetch property information, search query performance, indexing status, and sitemap details. Claude analyzes this data, generates visualizations, and provides conversational explanations and recommendations, streamlining SEO workflows.

Quick Start & Requirements

  • Installation: Clone the repository or download the ZIP. Create a Python virtual environment (e.g., using uv or venv) and install dependencies via pip install -r requirements.txt.
  • Prerequisites: Python 3.11+, Node.js, Claude Desktop, Google Search Console API access (requires setting up OAuth client ID or service account credentials JSON file), and configuring claude_desktop_config.json with correct file paths.
  • Links: GitHub repository (implied), YouTube tutorial for setup.

Highlighted Details

  • Leverages Claude AI for conversational analysis of Google Search Console data.
  • Supports a wide range of GSC operations including property management, search analytics, URL inspection, and sitemap handling.
  • Offers both OAuth (recommended) and Service Account authentication methods for GSC API access.
  • Claude can generate data visualizations and provide actionable SEO recommendations.

Maintenance & Community

The project is hosted on GitHub, welcoming contributions via issues and pull requests. No specific community channels (like Discord or Slack) or details on maintainers/sponsors are provided in the README.

Licensing & Compatibility

Licensed under the MIT License, permitting broad use, modification, and distribution, including for commercial purposes.

Limitations & Caveats

Setup requires careful configuration of Google Cloud API credentials and Claude's desktop application, including precise file path specifications. Users may encounter path-related issues, particularly on macOS, which can be addressed via aliasing or manual path adjustments. Troubleshooting often relies on external AI assistance or community support via GitHub.

Health Check
Last Commit

1 month ago

Responsiveness

Inactive

Pull Requests (30d)
1
Issues (30d)
0
Star History
229 stars in the last 30 days

Explore Similar Projects

Starred by Chip Huyen Chip Huyen(Author of "AI Engineering", "Designing Machine Learning Systems"), Zack Li Zack Li(Cofounder of Nexa AI), and
12 more.

search_with_lepton by leptonai

0%
8k
Conversational search engine demo
Created 2 years ago
Updated 2 months ago
Feedback? Help us improve.