remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Enables web data extraction capabilities within Windsurf (a Codeium product) through AgentQL integration
Supports extracting structured video data including titles, authors, view counts, and URLs from YouTube search results

Servidor MCP de AgentQL

Este es un servidor de 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' determinada, utilizando 'prompt' como descripción de los datos reales y sus campos a extraer.

Instalación

Para utilizar AgentQL MCP Server para extraer datos de páginas web, debe instalarlo a través de npm, obtener una clave API de nuestro Portal de desarrolladores y configurarlo en su aplicación favorita que admita MCP.

Instalar el paquete

npm install -g agentql-mcp

Configurar Claude

Abra la configuración de escritorio de Claude mediante ⌘ + , (no confunda con la configuración de la cuenta de Claude)
Vaya a la sección de la barra lateral del desarrollador
Haga clic en Editar configuración y abra el archivo claude_desktop_config.json
Agregue el servidor agentql dentro del diccionario mcpServers en el archivo de configuración
Reiniciar la aplicación

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

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

Configurar cursor

Abrir configuración del cursor
Vaya a MCP > Servidores MCP
Haga clic en + Agregar nuevo servidor MCP
Introduzca lo siguiente:
- Nombre: "agentql" (o su nombre preferido)
- Tipo: "comando"
- Comando: env AGENTQL_API_KEY=YOUR_API_KEY npx -y agentql-mcp

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

Configurar Windsurf

Open Windsurf: Panel de configuración MCP
Haga clic en Agregar servidor personalizado+
Alternativamente, puede abrir ~/.codeium/windsurf/mcp_config.json directamente
Agregue 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"
      }
    }
  }
}

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

Validar la integración de MCP

Asigna 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 su agente se queje de que no puede abrir URL o cargar contenido de la web en lugar de usar AgentQL, intente agregar la sugerencia "usar herramientas" o "usar herramienta agentql".

Desarrollo

Instalar dependencias:

npm install

Construir el servidor:

npm run build

Para desarrollo con reconstrucción automática:

npm run watch

Si desea probar la versión de desarrollo, puede utilizar 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"
      }
    }
  }
}

[!NOTA] No olvides eliminar la configuración del servidor MCP de AgentQL predeterminada 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 complicada. Recomendamos usar el Inspector MCP , disponible como script de paquete:

npm run inspector

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

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

extract-web-data

Un servidor que proporciona las capacidades de extracción de datos de AgentQL, lo que permite a los agentes de IA obtener datos estructurados de la web no estructurada.

Related Resources

Reddit Discussion about this server