AgentQL MCP サーバー

これは、 AgentQLのデータ抽出機能を統合するモデルコンテキストプロトコル (MCP) サーバーです。

特徴

ツール

extract-web-data - 実際のデータと抽出するフィールドの説明として「プロンプト」を使用して、指定された「url」から構造化データを抽出します。

インストール

AgentQL MCP サーバーを使用して Web ページからデータを抽出するには、npm 経由でインストールし、 Dev Portalから API キーを取得し、MCP をサポートするお気に入りのアプリで構成する必要があります。

パッケージをインストールする

npm install -g agentql-mcp

クロードを設定する

⌘ + ,で 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の設定

Open 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統合の検証

エージェントに、Webからデータを抽出するタスクを割り当てます。例:

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 を開いたり Web からコンテンツを読み込んだりできないというエラーを表示する場合は、「ツールを使用する」または「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 が 2 つの類似したサーバーを混同しないように、デフォルトの AgentQL MCP サーバー構成を忘れずに削除してください。

デバッグ

MCPサーバーはstdio経由で通信するため、デバッグが困難になる場合があります。パッケージスクリプトとして提供されているMCP Inspectorの使用をお勧めします。

npm run inspector

インスペクターは、ブラウザでデバッグツールにアクセスするための URL を提供します。

AgentQL MCP Server

Integrations