AgentQL

AgentQL MCP सर्वर

यह एक मॉडल कॉन्टेक्स्ट प्रोटोकॉल (MCP) सर्वर है जो AgentQL की डेटा निष्कर्षण क्षमताओं को एकीकृत करता है।

विशेषताएँ

उपकरण

• extract-web-data - किसी दिए गए 'url' से संरचित डेटा निकालें, जहाँ 'prompt' वास्तविक डेटा और उसके निकाले जाने वाले फ़ील्ड का विवरण है।

स्थापना

वेब पेजों से डेटा निकालने के लिए AgentQL MCP सर्वर का उपयोग करने हेतु, आपको इसे npm के माध्यम से स्थापित करना होगा, हमारे Dev Portal से एक API कुंजी प्राप्त करनी होगी, और इसे अपने पसंदीदा MCP-समर्थित ऐप में कॉन्फ़िगर करना होगा।

पैकेज स्थापित करें

npm install -g agentql-mcp

Claude कॉन्फ़िगर करें

• ⌘+, के माध्यम से 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 कॉन्फ़िगरेशन के बारे में अधिक जानकारी यहाँ पढ़ें।

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 एकीकरण मान्य करें

अपने एजेंट को एक ऐसा कार्य दें जिसके लिए वेब से डेटा निकालने की आवश्यकता होगी। उदाहरण के लिए:

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 नहीं खोल सकता या सामग्री लोड नहीं कर सकता, तो "उपकरणों का उपयोग करें" या "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 को दो समान सर्वरों से भ्रमित न करने के लिए डिफ़ॉल्ट AgentQL MCP सर्वर कॉन्फ़िग को हटाना न भूलें।

डिबगिंग

चूँकि MCP सर्वर stdio पर संचार करते हैं, डिबगिंग चुनौतीपूर्ण हो सकती है। हम MCP इंस्पेक्टर का उपयोग करने की अनुशंसा करते हैं, जो एक पैकेज स्क्रिप्ट के रूप में उपलब्ध है:

npm run inspector

इंस्पेक्टर आपके ब्राउज़र में डिबगिंग उपकरणों तक पहुँचने के लिए एक URL प्रदान करेगा।