About Advanced Seo MCP
Advanced Seo MCP is an MCP server published by halilertekin in the Developer Tools category: professional SEO Analysis MCP Server for AI Agents (Ahrefs, PSI, Technical).
The repository has 5 stars and 2 forks, with the last commit 5 months ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
git clone https://github.com/halilertekin/advanced-seo-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (9)
analyze_page_speedGoogle PageSpeed Insights analysis (Mobile/Desktop).
Parameters not published.
bulk_sitemap_auditScans sitemap and performs quick audit on multiple pages.
Parameters not published.
check_broken_links_on_pageScans page for broken (404) internal/external links.
Parameters not published.
check_schema_markupValidates JSON-LD Schema implementation.
Parameters not published.
compare_competitorsCompares Backlinks/Traffic/DR of 2 domains.
Parameters not published.
generate_audit_report**Best!** Generates a full Markdown SEO report combining all metrics.
Parameters not published.
get_backlinksRetrieves Domain Rating & Top Backlinks (Ahrefs Data).
Parameters not published.
keyword_ideasGenerates keyword ideas & questions (Ahrefs Data).
Parameters not published.
onpage_auditAnalyzes content structure, meta tags, and density.
Parameters not published.
Ask AI
Ask AI about Advanced Seo MCP
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 7 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- !License declaredNo license file. Legally you have no right to use it in a product.
- !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
README
🚀 Advanced SEO MCP Server
Powering AI Agents with Advanced SEO Intelligence
📖 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:
-
Clone the repository:
git clone https://github.com/halilertekin/advanced-seo-mcp.git cd advanced-seo-mcp -
Create virtual environment & Install:
python3 -m venv .venv source .venv/bin/activate # Windows: .venv\Scripts\activate pip install -e . -
Setup Configuration: Run the setup script to generate the local configuration:
python setup_extension.py -
Link to Gemini:
ln -s $(pwd) ~/.gemini/extensions/advanced-seo-mcp
🔑 Configuration
This server requires API keys for full functionality.
-
Create a
.envfile in the project root (or rename.env.example):cp .env.example .env -
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"
🛠️ Management & Execution
A handy skills.sh script is included for easy management of the MCP server.
Make the script executable:
chmod +x skills.sh
Available Commands:
./skills.sh install- Installs project dependencies usinguv../skills.sh update- Compiles and upgrades dependencies../skills.sh audit- Runs a Python security audit (pip-audit)../skills.sh run- Runs the advanced-seo MCP server.
📚 Tools Reference
| Tool | Description |
|---|---|
generate_audit_report |
Best! Generates a full Markdown SEO report combining all metrics. |
onpage_audit |
Analyzes content structure, meta tags, and density. |
analyze_page_speed |
Google PageSpeed Insights analysis (Mobile/Desktop). |
check_schema_markup |
Validates JSON-LD Schema implementation. |
check_broken_links_on_page |
Scans page for broken (404) internal/external links. |
compare_competitors |
Compares Backlinks/Traffic/DR of 2 domains. |
bulk_sitemap_audit |
Scans sitemap and performs quick audit on multiple pages. |
get_backlinks |
Retrieves Domain Rating & Top Backlinks (Ahrefs Data). |
keyword_ideas |
Generates keyword ideas & questions (Ahrefs Data). |
📝 License
MIT
README fetched from the repository 7 days ago. The original is authoritative.