AgentQL

offiziell

Ermöglicht KI-Agenten, strukturierte Daten aus unstrukturierten Webseiten mit AgentQL zu extrahieren.

GitHub
174

Was kann man mit Agent QL MCP machen?

  • Strukturierte Daten aus jeder URL extrahieren — Beschreiben Sie die gewünschten Felder und lassen Sie die KI diese über extract-web-data mit einer natürlichsprachlichen Eingabe abrufen.
  • Eine Webseite in eine Tabelle oder Liste umwandeln — Fragen Sie nach Elementen wie Produkten, Videos oder Artikeln von einer URL und geben Sie an, welche Eigenschaften für jedes erfasst werden sollen.
  • Ungewünschte Inhalte während der Extraktion herausfiltern — Fügen Sie Ausschlüsse in Ihre Eingabe ein (z. B. Werbung oder gesponserte Elemente überspringen), sodass die Ergebnisse nur relevante Daten enthalten.

Dokumentation

AgentQL MCP Server

Dies ist ein Model Context Protocol (MCP)-Server, der die Datenextraktionsfähigkeiten von AgentQL integriert.

Funktionen

Werkzeuge

  • extract-web-data – extrahiert strukturierte Daten von einer angegebenen 'url', wobei 'prompt' als Beschreibung der tatsächlichen Daten und ihrer zu extrahierenden Felder dient.

Installation

Um den AgentQL MCP Server zum Extrahieren von Daten aus Webseiten zu verwenden, müssen Sie ihn via npm installieren, einen API-Schlüssel von unserem Dev Portal beziehen und ihn in Ihrer bevorzugten App, die MCP unterstützt, konfigurieren.

Paket installieren

npm install -g agentql-mcp

Claude konfigurieren

  • Öffnen Sie die Claude Desktop Einstellungen über ⌘+, (nicht mit den Claude-Kontoeinstellungen verwechseln)
  • Gehen Sie zum Seitenbereich Entwickler
  • Klicken Sie auf Konfiguration bearbeiten und öffnen Sie die Datei claude_desktop_config.json
  • Fügen Sie den agentql-Server im mcpServers-Dictionary der Konfigurationsdatei hinzu
  • Starten Sie die App neu
{
  "mcpServers": {
    "agentql": {
      "command": "npx",
      "args": ["-y", "agentql-mcp"],
      "env": {
        "AGENTQL_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Lesen Sie mehr über die MCP-Konfiguration in Claude hier.

VS Code konfigurieren

Für eine Ein-Klick-Installation klicken Sie auf eine der Installationsschaltflächen unten:

Install with NPX in VS Code Install with NPX in VS Code Insiders

Manuelle Installation

Klicken Sie auf die Installationsschaltflächen oben in diesem Abschnitt für die schnellste Installationsmethode. Für eine manuelle Installation folgen Sie diesen Schritten:

Fügen Sie den folgenden JSON-Block zu Ihrer Benutzereinstellungsdatei (JSON) in VS Code hinzu. Sie können dies tun, indem Sie Ctrl + Shift + P drücken und Preferences: Open User Settings (JSON) eingeben.

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

Optional können Sie es zu einer Datei namens .vscode/mcp.json in Ihrem Arbeitsbereich hinzufügen. Dadurch können Sie die Konfiguration mit anderen teilen.

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

  • Öffnen Sie die Cursor-Einstellungen
  • Gehen Sie zu MCP > MCP-Server
  • Klicken Sie auf + Neuen MCP-Server hinzufügen
  • Geben Sie Folgendes ein:
    • Name: "agentql" (oder ein bevorzugter Name)
    • Typ: "command"
    • Befehl: env AGENTQL_API_KEY=YOUR_API_KEY npx -y agentql-mcp

Lesen Sie mehr über die MCP-Konfiguration in Cursor hier.

Windsurf konfigurieren

  • Öffnen Sie das Windsurf: MCP-Konfigurationspanel
  • Klicken Sie auf Benutzerdefinierten Server hinzufügen+
  • Alternativ können Sie ~/.codeium/windsurf/mcp_config.json direkt öffnen
  • Fügen Sie den agentql-Server im mcpServers-Dictionary der Konfigurationsdatei hinzu
{
  "mcpServers": {
    "agentql": {
      "command": "npx",
      "args": ["-y", "agentql-mcp"],
      "env": {
        "AGENTQL_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Lesen Sie mehr über die MCP-Konfiguration in Windsurf hier.

MCP-Integration validieren

Geben Sie Ihrem Agenten eine Aufgabe, die das Extrahieren von Daten aus dem Web erfordert. Zum Beispiel:

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] Falls Ihr Agent sich beschwert, dass er keine URLs öffnen oder Inhalte aus dem Web laden kann, anstatt AgentQL zu verwenden, versuchen Sie den Hinweis "use tools" oder "use agentql tool" hinzuzufügen.

Entwicklung

Abhängigkeiten installieren:

npm install

Server bauen:

npm run build

Für die Entwicklung mit automatischem Neubau:

npm run watch

Wenn Sie die Entwicklungsversion ausprobieren möchten, können Sie die folgende Konfiguration anstelle der Standardkonfiguration verwenden:

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

[!NOTE] Vergessen Sie nicht, die Standardkonfiguration des AgentQL MCP-Servers zu entfernen, um Claude nicht mit zwei ähnlichen Servern zu verwirren.

Fehlerbehebung

Da MCP-Server über stdio kommunizieren, kann die Fehlerbehebung herausfordernd sein. Wir empfehlen die Verwendung des MCP Inspector, der als Paketskript verfügbar ist:

npm run inspector

Der Inspector stellt eine URL bereit, um auf Debugging-Werkzeuge in Ihrem Browser zuzugreifen.