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

# Serveur MCP Octoparse

> Découvrez le serveur MCP Octoparse et connectez votre agent IA pour rechercher des modèles, exécuter des tâches et récupérer des données.

Connectez la plateforme de web scraping Octoparse à n’importe quel agent IA compatible MCP. Recherchez des modèles, exécutez des tâches dans le Cloud et récupérez des données, le tout en langage naturel.

Le serveur fonctionne avec les modèles Octoparse prédéfinis et les tâches compatibles avec le Cloud.

## Prérequis

<Steps>
  <Step title="Un compte Octoparse">
    Tout compte Octoparse peut se connecter. Les utilisateurs des offres gratuite et Basic bénéficient de 2 000 enregistrements gratuits par semaine pour l’extraction MCP, sans mise à niveau nécessaire pour commencer.
  </Step>

  <Step title="Un client compatible MCP">
    Par exemple ChatGPT, Codex, Claude, Claude Code, OpenClaw, Cursor, VS Code (GitHub Copilot) ou Antigravity.
  </Step>
</Steps>

***

## Fonctionnalités et limites

<Columns cols={2}>
  <Card title="✅ Fonctionnalités disponibles">
    * Rechercher des modèles de scraping prédéfinis
    * Créer et exécuter une nouvelle tâche dans le Cloud à partir d’un modèle prédéfini
    * Déclencher et surveiller l’exécution de tâches compatibles avec le Cloud
    * Exporter les données collectées (JSON / CSV)
    * Répertorier et rechercher les tâches existantes
    * Démarrer ou arrêter une tâche en cours d’exécution
    * Utiliser un code promotionnel
  </Card>

  <Card title="❌ Fonctionnalités non disponibles">
    * Exécuter des tâches uniquement locales (le client de bureau est requis)
    * Créer des tâches entièrement personnalisées ou modifier leur configuration, notamment les champs, la pagination, les boucles ou le Flux de travail du navigateur
    * Importer des modèles de scraping personnalisés
    * Accéder aux paramètres du compte ou à la facturation
    * Effectuer du scraping sans modèle prédéfini
  </Card>
</Columns>

<Note>
  MCP peut créer et exécuter de nouvelles tâches dans le Cloud à partir des modèles prédéfinis Octoparse. Il ne peut ni créer de Flux de travail de scraping entièrement personnalisés ni modifier les détails de configuration d’une tâche personnalisée. Si vous avez besoin d’un Flux de travail personnalisé, créez-le d’abord dans Octoparse, puis utilisez MCP pour l’exécuter, le surveiller, l’arrêter ou exporter ses résultats.
</Note>

***

## Démarrage rapide

### URL du serveur

```text Server URL theme={null}
https://mcp.octoparse.com
```

### Méthodes d’authentification

<Columns cols={2}>
  <Card title="Option A : OAuth 2.1" icon="lock-keyhole">
    Connexion dans le navigateur. Recommandée à la plupart des utilisateurs. Aucune clé API n’est nécessaire : connectez-vous simplement à Octoparse lorsque vous y êtes invité.
  </Card>

  <Card title="Option B : clé API" icon="key">
    Authentification directe par clé API. Idéale pour les environnements automatisés ou sans interface graphique tels que Claude Code, Codex CLI, VS Code, TRAE et OpenClaw.

    Obtenez votre clé dans le [centre de compte Octoparse](https://www.octoparse.fr/console/account-center/api-keys).
  </Card>
</Columns>

## Clients compatibles

Sélectionnez votre client MCP ci-dessous et suivez les étapes de configuration.

<div className="mb-8 grid grid-cols-2 gap-2 sm:grid-cols-4">
  <a href="#chatgpt" className="flex min-h-14 items-center gap-3 rounded-lg border border-gray-200 px-3 py-2 text-sm font-medium text-gray-900 no-underline transition-colors hover:border-gray-300 hover:bg-gray-50 dark:border-gray-700 dark:text-gray-100 dark:hover:border-gray-600 dark:hover:bg-gray-900/40"><img src="https://op-official-us-1251101074.cos.na-siliconvalley.myqcloud.com/mcp/chatgpt.svg" alt="" className="h-6 w-6 shrink-0" /><span>ChatGPT</span></a>
  <a href="#codex" className="flex min-h-14 items-center gap-3 rounded-lg border border-gray-200 px-3 py-2 text-sm font-medium text-gray-900 no-underline transition-colors hover:border-gray-300 hover:bg-gray-50 dark:border-gray-700 dark:text-gray-100 dark:hover:border-gray-600 dark:hover:bg-gray-900/40"><img src="https://mintcdn.com/octoparse/JjtZ5xTfKo3caPro/images/mcp/codex.svg?fit=max&auto=format&n=JjtZ5xTfKo3caPro&q=85&s=56e3220fb8fd0f8dd7aa931b0836e0cf" alt="" className="h-6 w-6 shrink-0" width="36" height="36" data-path="images/mcp/codex.svg" /><span>Codex</span></a>
  <a href="#claude" className="flex min-h-14 items-center gap-3 rounded-lg border border-gray-200 px-3 py-2 text-sm font-medium text-gray-900 no-underline transition-colors hover:border-gray-300 hover:bg-gray-50 dark:border-gray-700 dark:text-gray-100 dark:hover:border-gray-600 dark:hover:bg-gray-900/40"><img src="https://op-official-us-1251101074.cos.na-siliconvalley.myqcloud.com/mcp/claude.svg" alt="" className="h-6 w-6 shrink-0" /><span>Claude</span></a>
  <a href="#claude-code" className="flex min-h-14 items-center gap-3 rounded-lg border border-gray-200 px-3 py-2 text-sm font-medium text-gray-900 no-underline transition-colors hover:border-gray-300 hover:bg-gray-50 dark:border-gray-700 dark:text-gray-100 dark:hover:border-gray-600 dark:hover:bg-gray-900/40"><img src="https://mintcdn.com/octoparse/JjtZ5xTfKo3caPro/images/mcp/claude-code.svg?fit=max&auto=format&n=JjtZ5xTfKo3caPro&q=85&s=41a82256b2cd0af12c8c70542c817228" alt="" className="h-6 w-6 shrink-0" width="36" height="36" data-path="images/mcp/claude-code.svg" /><span>Claude Code</span></a>
  <a href="#openclaw" className="flex min-h-14 items-center gap-3 rounded-lg border border-gray-200 px-3 py-2 text-sm font-medium text-gray-900 no-underline transition-colors hover:border-gray-300 hover:bg-gray-50 dark:border-gray-700 dark:text-gray-100 dark:hover:border-gray-600 dark:hover:bg-gray-900/40"><img src="https://op-official-us-1251101074.cos.na-siliconvalley.myqcloud.com/mcp/openclaw.svg" alt="" className="h-6 w-6 shrink-0" /><span>OpenClaw</span></a>
  <a href="#cursor" className="flex min-h-14 items-center gap-3 rounded-lg border border-gray-200 px-3 py-2 text-sm font-medium text-gray-900 no-underline transition-colors hover:border-gray-300 hover:bg-gray-50 dark:border-gray-700 dark:text-gray-100 dark:hover:border-gray-600 dark:hover:bg-gray-900/40"><img src="https://op-official-us-1251101074.cos.na-siliconvalley.myqcloud.com/mcp/cursor.svg" alt="" className="h-6 w-6 shrink-0" /><span>Cursor</span></a>
  <a href="#vs-code" className="flex min-h-14 items-center gap-3 rounded-lg border border-gray-200 px-3 py-2 text-sm font-medium text-gray-900 no-underline transition-colors hover:border-gray-300 hover:bg-gray-50 dark:border-gray-700 dark:text-gray-100 dark:hover:border-gray-600 dark:hover:bg-gray-900/40"><img src="https://op-official-us-1251101074.cos.na-siliconvalley.myqcloud.com/mcp/vscode.svg" alt="" className="h-6 w-6 shrink-0" /><span>VS Code</span></a>
  <a href="#antigravity" className="flex min-h-14 items-center gap-3 rounded-lg border border-gray-200 px-3 py-2 text-sm font-medium text-gray-900 no-underline transition-colors hover:border-gray-300 hover:bg-gray-50 dark:border-gray-700 dark:text-gray-100 dark:hover:border-gray-600 dark:hover:bg-gray-900/40"><img src="https://mintcdn.com/octoparse/JjtZ5xTfKo3caPro/images/mcp/antigravity.svg?fit=max&auto=format&n=JjtZ5xTfKo3caPro&q=85&s=fabe46bcd843c81a23b16f27bc031b23" alt="" className="h-6 w-6 shrink-0" width="36" height="36" data-path="images/mcp/antigravity.svg" /><span>Antigravity</span></a>
</div>

<AccordionGroup>
  <Accordion id="chatgpt" title="ChatGPT">
    <Steps>
      <Step title="Ouvrir les paramètres de personnalisation">
        Cliquez sur votre avatar, puis choisissez **Personnaliser ChatGPT**.
      </Step>

      <Step title="Activer le mode développeur">
        Accédez à **Applications → Paramètres avancés**, puis activez **Mode développeur (bêta)**.
      </Step>

      <Step title="Créer l’application Octoparse">
        Cliquez sur **Créer une application**. Définissez le nom sur `Octoparse` et l’URL MCP sur `https://mcp.octoparse.com`. Laissez l’ID client OAuth et le secret vides, confirmez la déclaration, puis créez l’application.
      </Step>

      <Step title="Autoriser via OAuth">
        ChatGPT vous redirige vers Octoparse. Connectez-vous, puis cliquez sur **Autoriser**.
      </Step>
    </Steps>

    [Consulter le guide de configuration complet](https://helpcenter.octoparse.com/fr/articles/13444709-how-to-integrate-octoparse-with-chatgpt-via-mcp-step-by-step)
  </Accordion>

  <Accordion id="codex" title="Codex">
    <Note>Codex CLI et l’extension Codex pour IDE partagent la même configuration MCP (`~/.codex/config.toml`). Configurez-la une fois pour l’utiliser dans les deux environnements.</Note>

    **Option A : OAuth**

    <Steps>
      <Step title="Ajouter le serveur">
        ```bash theme={null}
        codex mcp add octoparse --url https://mcp.octoparse.com
        ```
      </Step>

      <Step title="Autoriser via OAuth">
        ```bash theme={null}
        codex mcp login octoparse
        ```

        Une fenêtre de navigateur s’ouvre. Connectez-vous à Octoparse, puis cliquez sur **Autoriser**.
      </Step>
    </Steps>

    ***

    **Option B : clé API**

    Ajoutez ce qui suit à `~/.codex/config.toml` :

    ```toml theme={null}
        [mcp_servers.octoparse]
        url = "https://mcp.octoparse.com"
        http_headers = { "x-api-key" = "YOUR_API_KEY" }
    ```
  </Accordion>

  <Accordion id="claude" title="Claude">
    **Option A : OAuth**

    <Steps>
      <Step title="Ouvrir Paramètres → Connecteurs">
        Dans la barre latérale de Claude, accédez à **Paramètres → Connecteurs**.
      </Step>

      <Step title="Ajouter l’URL du serveur">
        Cliquez sur **Ajouter un connecteur**, puis saisissez `https://mcp.octoparse.com`.
      </Step>

      <Step title="Autoriser via OAuth">
        Cliquez sur **Connecter**. Une fenêtre de navigateur s’ouvre. Connectez-vous, puis cliquez sur **Autoriser**.
      </Step>
    </Steps>

    [Consulter le guide de configuration complet](https://helpcenter.octoparse.com/fr/articles/14001844-how-to-integrate-octoparse-with-claude-via-mcp-step-by-step)
  </Accordion>

  <Accordion id="claude-code" title="Claude Code">
    <Note>Les serveurs ajoutés avec `claude mcp add` sont partagés entre Claude Code CLI, l’application de bureau et les extensions pour IDE (VS Code / JetBrains). Une seule configuration suffit pour tous ces environnements.</Note>

    **Option A : OAuth**

    <Steps>
      <Step title="Ajouter le serveur">
        ```bash theme={null}
        claude mcp add --transport http octoparse https://mcp.octoparse.com
        ```
      </Step>

      <Step title="Autoriser via OAuth">
        Démarrez Claude Code et exécutez `/mcp`, puis sélectionnez **octoparse** pour vous authentifier. Une fenêtre de navigateur s’ouvre : connectez-vous à Octoparse, puis cliquez sur **Autoriser**.
      </Step>
    </Steps>

    ***

    **Option B : clé API**

    ```bash theme={null}
    claude mcp add --transport http octoparse https://mcp.octoparse.com --header "x-api-key: YOUR_API_KEY"
    ```
  </Accordion>

  <Accordion id="openclaw" title="OpenClaw">
    **Option A : OAuth**

    <Steps>
      <Step title="Installer OpenClaw">
        Installez OpenClaw, puis exécutez la commande d’initialisation.
      </Step>

      <Step title="Enregistrer le serveur MCP">
        Définissez le serveur MCP Octoparse et vérifiez la configuration.
      </Step>

      <Step title="Redémarrer la passerelle">
        Redémarrez la passerelle pour appliquer la configuration.
      </Step>

      <Step title="Autoriser via OAuth">
        Le premier appel d’un outil Octoparse ouvre une fenêtre de navigateur pour OAuth. Connectez-vous, puis cliquez sur **Autoriser**.
      </Step>
    </Steps>

    ***

    **Option B : clé API**

    ```bash theme={null}
        mcporter config add octoparse https://mcp.octoparse.com
        mcporter config set octoparse header.x-api-key "YOUR_API_KEY"
    ```

    Ajoutez ensuite ce qui suit à la configuration OpenClaw :

    ```json theme={null}
        {
          "mcp": {
            "servers": {
              "octoparse": {
                "command": "mcporter",
                "args": ["run", "stdio", "--server", "octoparse"]
              }
            }
          }
        }
    ```
  </Accordion>

  <Accordion id="cursor" title="Cursor">
    **Option A : OAuth**

    <Steps>
      <Step title="Ouvrir les paramètres de Cursor">
        Ouvrez Cursor et cliquez sur l’icône des paramètres en haut à droite.
      </Step>

      <Step title="Accéder à Tools & MCP">
        Dans la barre latérale gauche, sélectionnez **Tools & MCP**.
      </Step>

      <Step title="Ajouter un serveur MCP personnalisé">
        Cliquez sur **Add Custom MCP**. Cursor ouvre le fichier de configuration MCP. Ajoutez `https://mcp.octoparse.com`, puis enregistrez.
      </Step>
    </Steps>

    [Consulter le guide de configuration complet](https://helpcenter.octoparse.com/fr/articles/14013893-how-to-integrate-octoparse-with-cursor-via-mcp-step-by-step)

    ***

    **Option B : clé API**

    Ajoutez ce qui suit à `~/.cursor/mcp.json` :

    ```json theme={null}
        {
          "mcpServers": {
            "octoparse": {
              "type": "http",
              "url": "https://mcp.octoparse.com",
              "headers": {
                "x-api-key": "YOUR_API_KEY"
              }
            }
          }
        }
    ```
  </Accordion>

  <Accordion id="vs-code" title="VS Code">
    <Info>Un abonnement **GitHub Copilot** actif est requis.</Info>

    **Option A : OAuth**

    Ajoutez ce qui suit à `.vscode/mcp.json` :

    ```json theme={null}
        {
          "servers": {
            "octoparse": {
              "type": "http",
              "url": "https://mcp.octoparse.com"
            }
          }
        }
    ```

    [Consulter le guide de configuration complet](https://helpcenter.octoparse.com/fr/articles/14004033-how-to-integrate-octoparse-with-vs-code-via-mcp-step-by-step)

    ***

    **Option B : clé API**

    ```json theme={null}
        {
          "servers": {
            "octoparse": {
              "type": "http",
              "url": "https://mcp.octoparse.com",
              "headers": {
                "x-api-key": "YOUR_API_KEY"
              }
            }
          }
        }
    ```
  </Accordion>

  <Accordion id="antigravity" title="Antigravity">
    <Note>L’IDE Antigravity et Antigravity CLI partagent la même configuration MCP (`~/.gemini/config/mcp_config.json`). Configurez-la une fois pour l’utiliser dans les deux environnements. Dans l’IDE, vous pouvez également l’ouvrir depuis le panneau de l’agent : **MCP Servers → View raw config**.</Note>

    **Option A : OAuth**

    Ajoutez ce qui suit à `~/.gemini/config/mcp_config.json` :

    ```json theme={null}
        {
          "mcpServers": {
            "octoparse": {
              "serverUrl": "https://mcp.octoparse.com"
            }
          }
        }
    ```

    Actualisez la liste des serveurs MCP. Le premier appel d’un outil Octoparse ouvre une fenêtre de navigateur pour OAuth : connectez-vous, puis cliquez sur **Autoriser**.

    ***

    **Option B : clé API**

    ```json theme={null}
        {
          "mcpServers": {
            "octoparse": {
              "serverUrl": "https://mcp.octoparse.com",
              "headers": {
                "x-api-key": "YOUR_API_KEY"
              }
            }
          }
        }
    ```
  </Accordion>
</AccordionGroup>