🚀 Advanced SEO MCP Server

📖 Overview

Advanced SEO MCP is a robust Model Context Protocol (MCP) server designed to equip AI agents with professional-grade SEO capabilities. It combines On-Page analysis, Technical Audits, Google PageSpeed Insights, and Ahrefs Data (via CapSolver) into a unified interface.

🚀 Installation

Option 1: One-Command Install (Recommended)

If you have uv installed, you can install this extension directly with Gemini CLI. uv handles all Python dependencies automatically.

gemini extensions install https://github.com/halilertekin/advanced-seo-mcp

Note: You will need to configure your API keys in the .env file inside the extension directory after installation.

Option 2: Manual Developer Setup

If you want to modify the code or don't use uv, follow these steps:

1. Clone the repository:

   git clone https://github.com/halilertekin/advanced-seo-mcp.git
   cd advanced-seo-mcp
   

2. Create virtual environment & Install:

   python3 -m venv .venv
   source .venv/bin/activate  # Windows: .venv\Scripts\activate
   pip install -e .
   

3. Setup Configuration: Run the setup script to generate the local configuration:

   python setup_extension.py
   

4. Link to Gemini:

   ln -s $(pwd) ~/.gemini/extensions/advanced-seo-mcp
   

🔑 Configuration

This server requires API keys for full functionality.

1. Create a .env file in the project root (or rename .env.example):

   cp .env.example .env
   

2. Add your API keys:

   # Required for Ahrefs Tools (Backlinks, Keywords, Traffic)
   # Get key: https://dashboard.capsolver.com/
   CAPSOLVER_API_KEY="your_capsolver_key"
   
   # Required for PageSpeed Insights
   # Get key: https://developers.google.com/speed/docs/insights/v5/get-started
   GOOGLE_PSI_API_KEY="your_google_psi_key"
   

📚 Tools Reference

📝 License

MIT