AgentQL

AgentQL MCP サーバー

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

機能

ツール

• extract-web-data - 指定された 'url' から構造化データを抽出します。'prompt' は抽出する実際のデータとそのフィールドの説明として使用します。

インストール

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

パッケージのインストール

npm install -g agentql-mcp

Claude の設定

• ⌘+, で Claude Desktop の 設定 を開きます (Claude アカウント設定と混同しないでください)
• Developer サイドバーセクションに移動します
• Edit Config をクリックし、claude_desktop_config.json ファイルを開きます
• 設定ファイル内の mcpServers ディクショナリに agentql サーバーを追加します
• アプリを再起動します

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

Claude での MCP 設定の詳細は こちら をご覧ください。

VS Code の設定

ワンクリックインストールの場合は、以下のインストールボタンのいずれかをクリックしてください。

手動インストール

最も迅速なインストール方法として、このセクションの上部にあるインストールボタンをクリックしてください。手動インストールの場合は、次の手順に従ってください。

VS Code のユーザー設定 (JSON) ファイルに次の JSON ブロックを追加します。これを行うには、Ctrl + Shift + P を押して 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}"
        }
      }
    }
  }
}

オプションで、ワークスペース内の .vscode/mcp.json というファイルに追加することもできます。これにより、設定を他のユーザーと共有できます。

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

Cursor の設定

• Cursor 設定 を開きます
• MCP > MCP サーバー に移動します
• + 新しい MCP サーバーを追加 をクリックします
• 以下を入力します。
  • 名前: "agentql" (または任意の名前)
  • タイプ: "command"
  • コマンド: 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 統合の検証

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] 2 つの類似したサーバーで Claude が混乱しないように、デフォルトの AgentQL MCP サーバー設定を忘れずに削除してください。

デバッグ

MCP サーバーは標準入出力を介して通信するため、デバッグが難しい場合があります。MCP Inspector の使用をお勧めします。これはパッケージスクリプトとして利用できます。

npm run inspector

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