{
  "markdown": "# 🚀 Advanced SEO MCP Server\n\n<div align=\"center\">\n\n![Python Version](https://img.shields.io/badge/python-3.10%2B-blue?style=for-the-badge&logo=python)\n![License](https://img.shields.io/badge/license-MIT-green?style=for-the-badge)\n![Status](https://img.shields.io/badge/status-stable-purple?style=for-the-badge)\n![MCP](https://img.shields.io/badge/MCP-FastMCP-orange?style=for-the-badge)\n\n**Powering AI Agents with Advanced SEO Intelligence**\n\n</div>\n\n## 📖 Overview\n\n**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.\n\n---\n\n## 🚀 Installation\n\n### Option 1: One-Command Install (Recommended)\n\nIf you have [uv](https://github.com/astral-sh/uv) installed, you can install this extension directly with Gemini CLI. `uv` handles all Python dependencies automatically.\n\n```bash\ngemini extensions install https://github.com/halilertekin/advanced-seo-mcp\n```\n\n*Note: You will need to configure your API keys in the `.env` file inside the extension directory after installation.*\n\n### Option 2: Manual Developer Setup\n\nIf you want to modify the code or don't use `uv`, follow these steps:\n\n1.  **Clone the repository:**\n    ```bash\n    git clone https://github.com/halilertekin/advanced-seo-mcp.git\n    cd advanced-seo-mcp\n    ```\n\n2.  **Create virtual environment & Install:**\n    ```bash\n    python3 -m venv .venv\n    source .venv/bin/activate  # Windows: .venv\\Scripts\\activate\n    pip install -e .\n    ```\n\n3.  **Setup Configuration:**\n    Run the setup script to generate the local configuration:\n    ```bash\n    python setup_extension.py\n    ```\n\n4.  **Link to Gemini:**\n    ```bash\n    ln -s $(pwd) ~/.gemini/extensions/advanced-seo-mcp\n    ```\n\n---\n\n## 🔑 Configuration\n\nThis server requires API keys for full functionality.\n\n1.  Create a `.env` file in the project root (or rename `.env.example`):\n    ```bash\n    cp .env.example .env\n    ```\n\n2.  Add your API keys:\n    ```ini\n    # Required for Ahrefs Tools (Backlinks, Keywords, Traffic)\n    # Get key: https://dashboard.capsolver.com/\n    CAPSOLVER_API_KEY=\"your_capsolver_key\"\n\n    # Required for PageSpeed Insights\n    # Get key: https://developers.google.com/speed/docs/insights/v5/get-started\n    GOOGLE_PSI_API_KEY=\"your_google_psi_key\"\n    ```\n\n## 🛠️ Management & Execution\n\nA handy `skills.sh` script is included for easy management of the MCP server.\n\nMake the script executable:\n```bash\nchmod +x skills.sh\n```\n\n**Available Commands:**\n* `./skills.sh install` - Installs project dependencies using `uv`.\n* `./skills.sh update` - Compiles and upgrades dependencies.\n* `./skills.sh audit` - Runs a Python security audit (`pip-audit`).\n* `./skills.sh run` - Runs the advanced-seo MCP server.\n\n---\n\n## 📚 Tools Reference\n\n| Tool | Description |\n|------|-------------|\n| `generate_audit_report` | **Best!** Generates a full Markdown SEO report combining all metrics. |\n| `onpage_audit` | Analyzes content structure, meta tags, and density. |\n| `analyze_page_speed` | Google PageSpeed Insights analysis (Mobile/Desktop). |\n| `check_schema_markup` | Validates JSON-LD Schema implementation. |\n| `check_broken_links_on_page` | Scans page for broken (404) internal/external links. |\n| `compare_competitors` | Compares Backlinks/Traffic/DR of 2 domains. |\n| `bulk_sitemap_audit` | Scans sitemap and performs quick audit on multiple pages. |\n| `get_backlinks` | Retrieves Domain Rating & Top Backlinks (Ahrefs Data). |\n| `keyword_ideas` | Generates keyword ideas & questions (Ahrefs Data). |\n\n## 📝 License\nMIT",
  "bytes": 3700,
  "sha": "404c0879e4d186911c555976205181d9a6aafc569b77a33869ea42dfea751af9",
  "repo_slug": "halilertekin/advanced-seo-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_halilertekin_advanced_seo_mcp_c85e3558/readme"
}