AgentQL

Server MCP AgentQL

Ini adalah server Model Context Protocol (MCP) yang mengintegrasikan kemampuan ekstraksi data AgentQL.

Fitur

Alat

• extract-web-data - mengekstrak data terstruktur dari 'url' yang diberikan, menggunakan 'prompt' sebagai deskripsi data aktual dan bidang yang akan diekstrak.

Instalasi

Untuk menggunakan Server MCP AgentQL guna mengekstrak data dari halaman web, Anda perlu menginstalnya melalui npm, mendapatkan kunci API dari Portal Pengembang kami, dan mengonfigurasinya di aplikasi favorit Anda yang mendukung MCP.

Instal paket

npm install -g agentql-mcp

Konfigurasi Claude

• Buka Pengaturan Claude Desktop melalui ⌘+, (jangan bingung dengan Pengaturan Akun Claude)
• Buka bagian bilah sisi Developer
• Klik Edit Config dan buka file claude_desktop_config.json
• Tambahkan server agentql di dalam kamus mcpServers dalam file konfigurasi
• Mulai ulang aplikasi

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

Baca lebih lanjut tentang konfigurasi MCP di Claude di sini.

Konfigurasi VS Code

Untuk instalasi satu klik, klik salah satu tombol instal di bawah ini:

Instalasi Manual

Klik tombol instal di bagian atas bagian ini untuk metode instalasi tercepat. Untuk instalasi manual, ikuti langkah-langkah berikut:

Tambahkan blok JSON berikut ke file Pengaturan Pengguna (JSON) Anda di VS Code. Anda dapat melakukannya dengan menekan Ctrl + Shift + P dan mengetik 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}"
        }
      }
    }
  }
}

Secara opsional, Anda dapat menambahkannya ke file bernama .vscode/mcp.json di ruang kerja Anda. Ini akan memungkinkan Anda untuk berbagi konfigurasi dengan orang lain.

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

Konfigurasi Cursor

• Buka Pengaturan Cursor
• Buka MCP > Server MCP
• Klik + Tambah Server MCP Baru
• Masukkan yang berikut:
  • Nama: "agentql" (atau nama pilihan Anda)
  • Tipe: "command"
  • Perintah: env AGENTQL_API_KEY=YOUR_API_KEY npx -y agentql-mcp

Baca lebih lanjut tentang konfigurasi MCP di Cursor di sini.

Konfigurasi Windsurf

• Buka Windsurf: Panel Konfigurasi MCP
• Klik Tambah server kustom+
• Atau Anda dapat membuka ~/.codeium/windsurf/mcp_config.json secara langsung
• Tambahkan server agentql di dalam kamus mcpServers dalam file konfigurasi

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

Baca lebih lanjut tentang konfigurasi MCP di Windsurf di sini.

Validasi integrasi MCP

Berikan agen Anda tugas yang memerlukan ekstraksi data dari web. Misalnya:

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] Jika agen Anda mengeluh bahwa ia tidak dapat membuka url atau memuat konten dari web alih-alih menggunakan AgentQL, coba tambahkan petunjuk "gunakan alat" atau "gunakan alat agentql".

Pengembangan

Instal dependensi:

npm install

Bangun server:

npm run build

Untuk pengembangan dengan pembangunan ulang otomatis:

npm run watch

Jika Anda ingin mencoba versi pengembangan, Anda dapat menggunakan konfigurasi berikut alih-alih yang default:

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

[!NOTE] Jangan lupa untuk menghapus konfigurasi server MCP AgentQL default agar tidak membingungkan Claude dengan dua server yang serupa.

Debugging

Karena server MCP berkomunikasi melalui stdio, debugging bisa menjadi tantangan. Kami merekomendasikan menggunakan MCP Inspector, yang tersedia sebagai skrip paket:

npm run inspector

Inspektur akan menyediakan URL untuk mengakses alat debugging di browser Anda.