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(Model Context Protocol) 서버입니다.

특징

도구

extract-web-data - 'prompt'를 실제 데이터와 추출할 필드에 대한 설명으로 사용하여 주어진 'url'에서 구조화된 데이터를 추출합니다.

설치

AgentQL MCP Server를 사용하여 웹 페이지에서 데이터를 추출하려면 npm을 통해 설치하고, Dev Portal 에서 API 키를 받은 다음, MCP를 지원하는 원하는 앱에서 구성해야 합니다.

패키지를 설치하세요

지엑스피1

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] 에이전트가 AgentQL을 사용하지 않고는 URL을 열거나 웹에서 콘텐츠를 로드할 수 없다고 불평하는 경우 "도구 사용" 또는 "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] Claude를 두 개의 유사한 서버와 혼동하지 않으려면 기본 AgentQL MCP 서버 구성을 제거하는 것을 잊지 마세요.

디버깅

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

AI 에이전트가 비정형 웹에서 정형화된 데이터를 가져올 수 있도록 AgentQL의 데이터 추출 기능을 제공하는 서버

Related Resources

Reddit Discussion about this server