AgentQL

Servidor MCP de AgentQL

Este es un servidor del Protocolo de Contexto de Modelo (MCP) que integra las capacidades de extracción de datos de AgentQL.

Características

Herramientas

• extract-web-data - extrae datos estructurados de una 'url' dada, usando 'prompt' como descripción de los datos reales y sus campos a extraer.

Instalación

Para usar el Servidor MCP de AgentQL y extraer datos de páginas web, necesitas instalarlo vía npm, obtener una clave API desde nuestro Portal de Desarrollo y configurarlo en tu aplicación favorita que soporte MCP.

Instalar el paquete

npm install -g agentql-mcp

Configurar Claude

• Abre Configuración de Claude Desktop mediante ⌘+, (no confundir con Configuración de la cuenta de Claude)
• Ve a la sección lateral Desarrollador
• Haz clic en Editar Configuración y abre el archivo claude_desktop_config.json
• Añade el servidor agentql dentro del diccionario mcpServers en el archivo de configuración
• Reinicia la aplicación

{
  "mcpServers": {
    "agentql": {
      "command": "npx",
      "args": ["-y", "agentql-mcp"],
      "env": {
        "AGENTQL_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Lee más sobre la configuración de MCP en Claude aquí.

Configurar VS Code

Para instalación en un clic, haz clic en uno de los botones de instalación a continuación:

Instalación Manual

Haz clic en los botones de instalación al inicio de esta sección para el método de instalación más rápido. Para instalación manual, sigue estos pasos:

Añade el siguiente bloque JSON a tu archivo de Configuración de Usuario (JSON) en VS Code. Puedes hacerlo presionando Ctrl + Shift + P y escribiendo 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}"
        }
      }
    }
  }
}

Opcionalmente, puedes añadirlo a un archivo llamado .vscode/mcp.json en tu espacio de trabajo. Esto te permitirá compartir la configuración con otros.

{
  "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}"
      }
    }
  }
}

Configurar Cursor

• Abre Configuración de Cursor
• Ve a MCP > Servidores MCP
• Haz clic en + Añadir nuevo Servidor MCP
• Ingresa lo siguiente:
  • Nombre: "agentql" (o tu nombre preferido)
  • Tipo: "command"
  • Comando: env AGENTQL_API_KEY=YOUR_API_KEY npx -y agentql-mcp

Lee más sobre la configuración de MCP en Cursor aquí.

Configurar Windsurf

• Abre Windsurf: Panel de Configuración MCP
• Haz clic en Añadir servidor personalizado+
• Alternativamente, puedes abrir ~/.codeium/windsurf/mcp_config.json directamente
• Añade el servidor agentql dentro del diccionario mcpServers en el archivo de configuración

{
  "mcpServers": {
    "agentql": {
      "command": "npx",
      "args": ["-y", "agentql-mcp"],
      "env": {
        "AGENTQL_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Lee más sobre la configuración de MCP en Windsurf aquí.

Validar la integración MCP

Dale a tu agente una tarea que requiera extraer datos de la web. Por ejemplo:

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.

[!TIP] En caso de que tu agente se queje de que no puede abrir URLs o cargar contenido de la web en lugar de usar AgentQL, intenta añadir la sugerencia "usa herramientas" o "usa la herramienta agentql".

Desarrollo

Instala las dependencias:

npm install

Construye el servidor:

npm run build

Para desarrollo con reconstrucción automática:

npm run watch

Si quieres probar la versión de desarrollo, puedes usar la siguiente configuración en lugar de la predeterminada:

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

[!NOTE] No olvides eliminar la configuración predeterminada del servidor MCP de AgentQL para no confundir a Claude con dos servidores similares.

Depuración

Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser desafiante. Recomendamos usar el Inspector MCP, que está disponible como un script de paquete:

npm run inspector

El Inspector proporcionará una URL para acceder a las herramientas de depuración en tu navegador.