AgentQL

officiel

Permettre aux agents IA d'obtenir des données structurées à partir du web non structuré avec AgentQL.

GitHub
174

Que pouvez-vous faire avec Agent QL MCP ?

  • Extraire des données structurées depuis n'importe quelle URL — Décrivez les champs souhaités et laissez l'IA les récupérer via extract-web-data à l'aide d'une instruction en langage naturel.
  • Transformer une page web en tableau ou en liste — Demandez des éléments comme des produits, des vidéos ou des articles à partir d'une URL, en précisant les propriétés à capturer pour chacun.
  • Filtrer le contenu indésirable lors de l'extraction — Incluez des exclusions dans votre instruction (par exemple, ignorer les publicités ou les éléments sponsorisés) afin que les résultats ne contiennent que les données pertinentes.

Documentation

Serveur MCP AgentQL

Il s'agit d'un serveur Model Context Protocol (MCP) qui intègre les capacités d'extraction de données d'AgentQL.

Fonctionnalités

Outils

  • extract-web-data - extrait des données structurées à partir d'une 'url' donnée, en utilisant 'prompt' comme description des données réelles et de leurs champs à extraire.

Installation

Pour utiliser le serveur MCP AgentQL afin d'extraire des données de pages web, vous devez l'installer via npm, obtenir une clé API depuis notre Portail Développeur, et le configurer dans votre application préférée prenant en charge MCP.

Installer le paquet

npm install -g agentql-mcp

Configurer Claude

  • Ouvrez les Paramètres de Claude Desktop via ⌘+, (ne confondez pas avec les Paramètres du compte Claude)
  • Allez dans la section latérale Développeur
  • Cliquez sur Modifier la configuration et ouvrez le fichier claude_desktop_config.json
  • Ajoutez le serveur agentql dans le dictionnaire mcpServers du fichier de configuration
  • Redémarrez l'application
{
  "mcpServers": {
    "agentql": {
      "command": "npx",
      "args": ["-y", "agentql-mcp"],
      "env": {
        "AGENTQL_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

En savoir plus sur la configuration MCP dans Claude ici.

Configurer VS Code

Pour une installation en un clic, cliquez sur l'un des boutons d'installation ci-dessous :

Install with NPX in VS Code Install with NPX in VS Code Insiders

Installation manuelle

Cliquez sur les boutons d'installation en haut de cette section pour la méthode d'installation la plus rapide. Pour une installation manuelle, suivez ces étapes :

Ajoutez le bloc JSON suivant à votre fichier de paramètres utilisateur (JSON) dans VS Code. Vous pouvez le faire en appuyant sur Ctrl + Shift + P et en tapant Preferences: Open User Settings (JSON).

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "apiKey",
        "description": "AgentQL API Key",
        "password": true
      }
    ],
    "servers": {
      "agentql": {
        "command": "npx",
        "args": ["-y", "agentql-mcp"],
        "env": {
          "AGENTQL_API_KEY": "${input:apiKey}"
        }
      }
    }
  }
}

Optionnellement, vous pouvez l'ajouter à un fichier nommé .vscode/mcp.json dans votre espace de travail. Cela vous permettra de partager la configuration avec d'autres.

{
  "inputs": [
    {
      "type": "promptString",
      "id": "apiKey",
      "description": "AgentQL API Key",
      "password": true
    }
  ],
  "servers": {
    "agentql": {
      "command": "npx",
      "args": ["-y", "agentql-mcp"],
      "env": {
        "AGENTQL_API_KEY": "${input:apiKey}"
      }
    }
  }
}

Configurer Cursor

  • Ouvrez les Paramètres de Cursor
  • Allez dans MCP > Serveurs MCP
  • Cliquez sur + Ajouter un nouveau serveur MCP
  • Saisissez les informations suivantes :
    • Nom : "agentql" (ou le nom de votre choix)
    • Type : "command"
    • Commande : env AGENTQL_API_KEY=YOUR_API_KEY npx -y agentql-mcp

En savoir plus sur la configuration MCP dans Cursor ici.

Configurer Windsurf

  • Ouvrez le Panneau de configuration MCP de Windsurf
  • Cliquez sur Ajouter un serveur personnalisé+
  • Vous pouvez également ouvrir directement ~/.codeium/windsurf/mcp_config.json
  • Ajoutez le serveur agentql dans le dictionnaire mcpServers du fichier de configuration
{
  "mcpServers": {
    "agentql": {
      "command": "npx",
      "args": ["-y", "agentql-mcp"],
      "env": {
        "AGENTQL_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

En savoir plus sur la configuration MCP dans Windsurf ici.

Valider l'intégration MCP

Donnez à votre agent une tâche qui nécessitera d'extraire des données du web. Par exemple :

Extract the list of videos from the page https://www.youtube.com/results?search_query=agentql, every video should have a title, an author name, a number of views and a url to the video. Make sure to exclude ads items. Format this as a markdown table.

[!ASTUCE] Si votre agent se plaint de ne pas pouvoir ouvrir des URLs ou charger du contenu depuis le web au lieu d'utiliser AgentQL, essayez d'ajouter l'indice "utilise les outils" ou "utilise l'outil agentql".

Développement

Installer les dépendances :

npm install

Compiler le serveur :

npm run build

Pour le développement avec reconstruction automatique :

npm run watch

Si vous souhaitez essayer la version de développement, vous pouvez utiliser la configuration suivante au lieu de celle par défaut :

{
  "mcpServers": {
    "agentql": {
      "command": "/path/to/agentql-mcp/dist/index.js",
      "env": {
        "AGENTQL_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

[!REMARQUE] N'oubliez pas de supprimer la configuration du serveur MCP AgentQL par défaut pour ne pas confondre Claude avec deux serveurs similaires.

Débogage

Étant donné que les serveurs MCP communiquent via stdio, le débogage peut être difficile. Nous recommandons d'utiliser l'Inspecteur MCP, qui est disponible en tant que script de paquet :

npm run inspector

L'Inspecteur fournira une URL pour accéder aux outils de débogage dans votre navigateur.