Agentql MCP

🚀 AgentQL MCP サーバー

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

✨ 主な機能

ツール

• extract-web-data - 与えられた 'url' と実際のデータとそのフィールドを説明する 'prompt' に基づいて、ウェブページから構造化データを抽出します。

📦 インストール

AgentQL MCP サーバーを使用してウェブページからデータを抽出するには、npm を通じてインストールし、開発者ポータル から API キーを取得し、MCP 対応のアプリケーションで設定を行ってください。

インストールパッケージ

npm install -g agentql-mcp

Claude の設定

• Claude Desktop の 設定 を ⌘+, で開きます（Claude アカウント設定と混同しないでください）。
• 開発者 サイドバーセクションに移動します。
• 編集設定 をクリックし、claude_desktop_config.json ファイルを開きます。
• 設定ファイルの mcpServers 辞書の下に agentql サーバーを追加します。
• アプリケーションを再起動します。

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

Claude での MCP 設定の詳細は こちら を参照してください。

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

エージェントにウェブページからデータを抽出するタスクを与えてください。例えば：

https://www.youtube.com/results?search_query=agentql ページのビデオリストを抽出します。各ビデオにはタイトル、作者名、視聴回数、ビデオ URL が含まれている必要があります。広告項目を除外してください。Markdown テーブル形式に整形します。

💡 使用アドバイス

エージェントが 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"
      }
    }
  }
}

⚠️ 重要な注意

Claude に 2 つの類似したサーバーがあると混乱するため、デフォルトの AgentQL MCP サーバー設定を削除することを忘れないでください。

🔍 デバッグ

MCP サーバーは stdio を通じて通信するため、デバッグは難しい場合があります。MCP インスペクター をおすすめします。これはパッケージスクリプトとして利用できます：

npm run inspector

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