> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Guide de connexion MCP de Google Search

> serp MCP 服务器集成

[MCP (Model Context Protocol)](https://modelcontextprotocol.io) est un protocole de contexte de modèle lancé par Anthropic, permettant aux modèles d'IA (comme Claude, GPT, etc.) d'appeler des outils externes via une interface standardisée. Grâce au serveur SERP MCP fourni par XHuoAPI, vous pouvez effectuer des recherches Google directement dans des clients IA tels que Claude Desktop, VS Code, Cursor, etc., pour obtenir des résultats de recherche de pages web, d'images, de nouvelles, de vidéos, de lieux, etc.

## Vue d'ensemble des fonctionnalités

Le serveur SERP MCP offre les fonctionnalités principales suivantes :

* **Recherche de pages web** — Recherche de résultats de pages Google
* **Recherche d'images** — Recherche d'images Google
* **Recherche de nouvelles** — Recherche de nouvelles Google
* **Recherche de vidéos** — Recherche de vidéos Google
* **Recherche de lieux** — Recherche d'informations sur les lieux Google
* **Recherche de cartes** — Recherche de cartes Google
* **Multilingue et multi-régions** — Prise en charge des paramètres de pays et de langue personnalisés
* **Filtrage par plage de temps** — Filtrage des résultats par jour, semaine, mois, année

## Préparations préalables

Avant d'utiliser, vous devez obtenir un jeton API XHuoAPI :

1. Inscrivez-vous ou connectez-vous à la [plateforme XHuoAPI](https://api.xhuoapi.ai)
2. Allez à la page [Google SERP API](https://api.xhuoapi.ai/documents/serp-google)
3. Cliquez sur « Acquire » pour obtenir un jeton API (première demande avec un quota gratuit)

## Installation et configuration

### Méthode 1 : installation avec pip (recommandée)

```bash theme={null}
pip install mcp-serp
```

### Méthode 2 : installation à partir du code source

```bash theme={null}
git clone https://github.com/XHuoAPI/SerpMCP.git
cd SerpMCP
pip install -e .
```

Une fois l'installation terminée, vous pouvez utiliser la commande `mcp-serp` pour démarrer le service.

## Utilisation dans Claude Desktop

Éditez le fichier de configuration de Claude Desktop :

* **macOS** : `~/Library/Application Support/Claude/claude_desktop_config.json`
* **Windows** : `%APPDATA%\Claude\claude_desktop_config.json`

Ajoutez la configuration suivante :

```json theme={null}
{
  "mcpServers": {
    "serp": {
      "command": "mcp-serp",
      "env": {
        "XHuoAPI_API_TOKEN": "votre jeton API"
      }
    }
  }
}
```

Si vous utilisez `uvx` (pas besoin d'installer le package à l'avance) :

```json theme={null}
{
  "mcpServers": {
    "serp": {
      "command": "uvx",
      "args": ["mcp-serp"],
      "env": {
        "XHuoAPI_API_TOKEN": "votre jeton API"
      }
    }
  }
}
```

Après avoir enregistré la configuration, redémarrez Claude Desktop pour pouvoir utiliser les outils de recherche Google dans la conversation.

## Utilisation dans VS Code / Cursor

Créez un fichier `.vscode/mcp.json` dans le répertoire racine du projet :

```json theme={null}
{
  "servers": {
    "serp": {
      "command": "mcp-serp",
      "env": {
        "XHuoAPI_API_TOKEN": "votre jeton API"
      }
    }
  }
}
```

Ou utilisez `uvx` :

```json theme={null}
{
  "servers": {
    "serp": {
      "command": "uvx",
      "args": ["mcp-serp"],
      "env": {
        "XHuoAPI_API_TOKEN": "votre jeton API"
      }
    }
  }
}
```

## Liste des outils disponibles

| Nom de l'outil       | Description                   |
| -------------------- | ----------------------------- |
| `serp_google_search` | Recherche de pages Google     |
| `serp_google_images` | Recherche d'images Google     |
| `serp_google_news`   | Recherche de nouvelles Google |
| `serp_google_videos` | Recherche de vidéos Google    |
| `serp_google_places` | Recherche de lieux Google     |
| `serp_google_maps`   | Recherche de cartes Google    |

## Exemples d'utilisation

Une fois la configuration terminée, vous pouvez appeler ces fonctionnalités directement en langage naturel dans le client IA, par exemple :

* « Aide-moi à rechercher les derniers articles sur l'IA »
* « Recherche de bons restaurants de hot pot à Pékin »
* « Trouver des images sur la programmation asynchrone en Python »
* « Recherche des nouvelles technologiques d'aujourd'hui »
* « Trouver des cafés à proximité sur la carte »

## Plus d'informations

* Dépôt GitHub : [XHuoAPI/SerpMCP](https://github.com/XHuoAPI/SerpMCP)
* Package PyPI : [mcp-serp](https://pypi.org/project/mcp-serp/)
* Documentation API : [API de moteur de recherche](https://api.xhuoapi.ai/documents/serp)