SEO MCP

Description du Projet

SEO MCP (Model Control Protocol) est un service gratuit d'outils SEO qui exploite les données d'Ahrefs. Il propose une API pour récupérer des données SEO depuis Ahrefs, gérant la résolution des CAPTCHA, l'authentification et la récupération des informations. Les résultats sont mis en cache pour améliorer les performances et réduire les coûts d'API.

Ce service est destiné à des fins éducatives.

Instructions d'Utilisation

Prérequis

• Python 3.10 ou version ultérieure
• Un compte et une clé API Capsolver

Installation

Installer depuis PyPI

pip install seo-mcp
# Ou avec uv
uv pip install seo-mcp

Installation Manuelle

1. Cloner le dépôt :

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

2. Installer les dépendances :

   pip install -e .
   # Ou
   uv pip install -e .
   

3. Définir la clé API CapSolver :

   export CAPSOLVER_API_KEY="votre-cle-api-capsolver"
   

Lancer le Service

Utiliser dans l'IDE Cursor

Dans les paramètres de Cursor, naviguez vers l'onglet MCP, cliquez sur "+Ajouter un nouveau serveur MCP global", et insérez :

{
  "mcpServers": {
    "SEO MCP": {
      "command": "uvx",
      "args": ["--python", "3.10", "seo-mcp"],
      "env": {
        "CAPSOLVER_API_KEY": "CAP-xxxxxx"
      }
    }
  }
}

Référence API

• get_backlinks_list(domain: str) : Récupère les backlinks d'un domaine.
  • Paramètres : domain (chaîne de caractères, ex. "example.com")
• keyword_generator(keyword: str, country: str = "us", search_engine: str = "Google") : Génère des idées de mots-clés.
  • Paramètres : keyword (chaîne de caractères), country (chaîne de caractères, par défaut : "us"), search_engine (chaîne de caractères, par défaut : "Google")
• get_traffic(domain_or_url: str, country: str = "None", mode: str = "subdomains") : Estime le trafic.
  • Paramètres : domain_or_url (chaîne de caractères), country (chaîne de caractères, par défaut : "None"), mode (chaîne de caractères, "subdomains" ou "exact")
• keyword_difficulty(keyword: str, country: str = "us") : Obtient le score de difficulté d'un mot-clé.
  • Paramètres : keyword (chaîne de caractères), country (chaîne de caractères, par défaut : "us")

Fonctionnalités Clés

• Analyse de Backlinks : Obtenez des données détaillées sur les backlinks (note du domaine, texte d'ancrage, attributs des liens), filtrez les domaines éducatifs et gouvernementaux.
• Recherche de Mots-Clés : Générez des idées de mots-clés, consultez leur difficulté, leur volume de recherche et leurs tendances.
• Analyse de Trafic : Estimez le trafic web, visualisez l'historique, les pages populaires, la répartition par pays et suivez le classement des mots-clés.
• Optimisation des Performances : Utilise CapSolver pour la résolution automatique des CAPTCHA, inclut la mise en cache des réponses.
• Intégration des Données Ahrefs : Récupère les données SEO directement depuis Ahrefs.

Utilisateurs Cibles

Cet outil s'adresse aux développeurs, aux professionnels du SEO et aux chercheurs qui ont besoin d'un accès programmatique aux données Ahrefs pour l'analyse, l'automatisation ou des projets éducatifs.

Liens du Projet

• Dépôt GitHub : https://github.com/cnych/seo-mcp

Scénarios d'Application

• Collecte automatisée de données SEO depuis Ahrefs.
• Création de tableaux de bord ou d'outils SEO personnalisés.
• Recherche de profils de backlinks pour l'analyse concurrentielle.
• Génération d'idées de mots-clés pour la création de contenu.
• Suivi programmatique du trafic du site web et du classement des mots-clés.