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

AgentQL MCP 服务器

这是一个集成了AgentQL数据提取功能的模型上下文协议 (MCP) 服务器。

特征

工具

extract-web-data - 从给定的“url”中提取结构化数据，使用“prompt”作为要提取的实际数据及其字段的描述。

安装

要使用 AgentQL MCP 服务器从网页中提取数据，您需要通过 npm 安装它，从我们的开发门户获取 API 密钥，然后在您最喜欢的支持 MCP 的应用程序中对其进行配置。

安装包

npm install -g agentql-mcp

配置 Claude

通过⌘``,打开 Claude 桌面设置（不要与 Claude 帐户设置混淆）
转到开发人员侧边栏部分
单击**“编辑配置”**并打开claude_desktop_config.json文件
在配置文件中的mcpServers字典中添加agentql服务器
重启应用程序

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

点击此处了解有关 Claude 中的 MCP 配置的更多信息。

配置光标

打开游标设置
前往MCP > MCP 服务器
点击**+ 添加新的 MCP 服务器**
输入以下内容：
- 名称：“agentql”（或您喜欢的名称）
- 类型：“命令”
- 命令： env AGENTQL_API_KEY=YOUR_API_KEY npx -y agentql-mcp

在此处阅读有关 Cursor 中的 MCP 配置的更多信息。

配置 Windsurf

打开Windsurf：MCP 配置面板
点击添加自定义服务器+
或者您可以直接打开~/.codeium/windsurf/mcp_config.json
在配置文件中的mcpServers字典中添加agentql服务器

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

在此处阅读有关 Windsurf 中 MCP 配置的更多信息。

验证 MCP 集成

给你的代理一个需要从网络中提取数据的任务。例如：

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] 如果您的代理抱怨它无法打开 URL 或从网络加载内容，而不是使用 AgentQL，请尝试添加“使用工具”或“使用 agentql 工具”提示。

发展

安装依赖项：

npm install

构建服务器：

npm run build

对于使用自动重建的开发：

npm run watch

如果您想尝试开发版本，您可以使用以下配置代替默认配置：

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

[!NOTE] 不要忘记删除默认的 AgentQL MCP 服务器配置，以免将 Claude 与两个类似的服务器混淆。

调试

由于 MCP 服务器通过 stdio 进行通信，调试起来可能比较困难。我们推荐使用MCP Inspector ，它以包脚本的形式提供：

npm run inspector

检查器将提供一个 URL 来访问浏览器中的调试工具。

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

extract-web-data

提供 AgentQL 数据提取功能的服务器，使 AI 代理能够从非结构化 Web 中获取结构化数据

Related Resources

Reddit Discussion about this server

AgentQL MCP Server