Screenshot Scout

Screenshot Scout MCP सर्वर

MCP क्लाइंट से Screenshot Scout का उपयोग करके HTTP या HTTPS वेबपेजों को छवियों या PDF के रूप में कैप्चर करें।

यह सर्वर एक टूल, capture_screenshot प्रदान करता है। यह फुल-पेज और एलिमेंट कैप्चर, डिवाइस और व्यूपोर्ट नियंत्रण, स्थान चयन, पेज इंटरैक्शन और ब्लॉकिंग विकल्प, छवि आकार और गुणवत्ता, PDF लेआउट, कैशिंग, अस्थायी परिणाम URL और पात्र MCP छवि सामग्री का समर्थन करता है।

आपको क्या चाहिए

• एक Screenshot Scout खाता और API कुंजी पृष्ठ से एक एक्सेस कुंजी।
• npm/stdio इंस्टॉलेशन के लिए Node.js 22 या नया। Claude Desktop का MCPB रनटाइम Claude के साथ बंडल किया गया है।
• वैकल्पिक गुप्त कुंजी केवल तब जब आपकी चयनित API कुंजी को हस्ताक्षरित Screenshot Scout अनुरोधों की आवश्यकता हो।

हर कैप्चर आपके Screenshot Scout खाते का उपयोग करता है और उसकी योजना, कोटा और दर सीमाओं के अधीन है।

npm के साथ स्थानीय stdio

इस स्थानीय stdio कॉन्फ़िगरेशन से शुरू करें:

{
  "mcpServers": {
    "screenshotscout": {
      "command": "npx",
      "args": ["-y", "@screenshotscout/mcp"],
      "env": {
        "SCREENSHOTSCOUT_ACCESS_KEY": "YOUR_ACCESS_KEY"
      }
    }
  }
}

यदि एक्सेस कुंजी को अनुरोध हस्ताक्षर की आवश्यकता है, तो गुप्त कुंजी स्थानीय रूप से जोड़ें:

"SCREENSHOTSCOUT_SECRET_KEY": "YOUR_SECRET_KEY"

व्यक्तिगत कॉन्फ़िगरेशन फ़ाइलों को स्रोत नियंत्रण से बाहर रखें। क्रेडेंशियल प्रक्रिया पर्यावरण मान हैं, टूल तर्क नहीं। Claude Desktop, Claude Code, Cursor, VS Code/GitHub Copilot, Devin और Cline के लिए क्लाइंट-विशिष्ट कॉपी-पेस्ट कॉन्फ़िगरेशन देखें।

स्रोत चेकआउट से चलाएँ

npm ci
npm run build

क्लाइंट को node के साथ dist/stdio.js के पूर्ण पथ पर इंगित करें, और ऊपर दिखाए गए समान पर्यावरण चर प्रदान करें।

Claude Desktop MCPB

Claude Desktop एक्सटेंशन स्थापित करने के लिए:

1. उस संस्करण के GitHub रिलीज़ से screenshotscout-mcp-<version>.mcpb डाउनलोड करें।
2. Claude Desktop में, Settings → Extensions → Advanced settings खोलें और Install Extension… चुनें।
3. डाउनलोड की गई फ़ाइल का चयन करें।
4. आवश्यक एक्सेस कुंजी दर्ज करें। केवल उस API कुंजी के लिए गुप्त कुंजी दर्ज करें जिसे हस्ताक्षरित अनुरोधों की आवश्यकता हो।

Claude Desktop दोनों फ़ील्ड को संवेदनशील सेटिंग्स के रूप में मानता है। v0.1.0 MCPB Windows का समर्थन करता है।

होस्टेड Streamable HTTP

होस्टेड API-कुंजी एंडपॉइंट यहाँ लाइव है:

https://mcp.screenshotscout.com/mcp/api-key

यह केवल उन क्लाइंटों के लिए है जो एक स्थिर HTTP हेडर संलग्न कर सकते हैं:

Authorization: Bearer YOUR_ACCESS_KEY

एंडपॉइंट केवल एक एक्सेस कुंजी स्वीकार करता है। इसे कभी भी Screenshot Scout गुप्त कुंजी न भेजें, और कभी भी URL या टूल तर्क में कोई कुंजी न डालें। जो क्लाइंट स्थिर Bearer हेडर संलग्न नहीं कर सकते, वे इस एंडपॉइंट का उपयोग नहीं कर सकते।

जिन API कुंजियों को अनुरोध हस्ताक्षर की आवश्यकता होती है, उन्हें इसके बजाय स्थानीय stdio या MCPB का उपयोग करना चाहिए, या होस्टेड एंडपॉइंट के लिए एक समर्पित अहस्ताक्षरित एक्सेस कुंजी का उपयोग करना चाहिए।

Docker के साथ स्थानीय stdio

स्रोत चेकआउट से प्रोडक्शन इमेज बनाएँ:

docker build --tag screenshotscout-mcp:local .

स्थानीय पर्यावरण से क्रेडेंशियल पास करें और MCP stdio ट्रैफ़िक के लिए stdin संलग्न रखें:

docker run --rm -i --init --cap-drop=ALL --security-opt=no-new-privileges --read-only \
  -e SCREENSHOTSCOUT_ACCESS_KEY \
  -e SCREENSHOTSCOUT_SECRET_KEY \
  screenshotscout-mcp:local

SCREENSHOTSCOUT_SECRET_KEY वैकल्पिक रहता है। इमेज एक अनविशेषाधिकार प्राप्त उपयोगकर्ता के रूप में चलती है और इसमें केवल संकलित stdio सर्वर और उसकी प्रोडक्शन निर्भरताएँ होती हैं। यह कोई पोर्ट या कंटेनर स्वास्थ्य जाँच घोषित नहीं करता है: एक MCP क्लाइंट stdio प्रक्रिया का मालिक है और MCP आरंभीकरण पूरा करके तत्परता सत्यापित करता है। इमेज और docker-mcp-catalog.yaml में इसका Docker MCP कैटलॉग मेटाडेटा स्थानीय तैयारी हैं; इन कमांडों से कोई सार्वजनिक इमेज निहित नहीं है।

टूल: capture_screenshot

capture_screenshot आपूर्ति किए गए URL और विकल्पों के लिए एक कैप्चर अनुरोध भेजता है। लक्ष्य वेबपेज बाहरी है, और उसकी लौटाई गई सामग्री को अविश्वसनीय माना जाना चाहिए।

इनपुट

केवल url आवश्यक है। कैप्चर डिफ़ॉल्ट रूप से 1280×720 व्यूपोर्ट का उपयोग करते हैं। जब कोई प्रारूप निर्दिष्ट नहीं होता है, तो टूल गुणवत्ता 60 पर JPEG लौटाता है। resultMode डिफ़ॉल्ट रूप से "auto" है।

समूह	इनपुट
लक्ष्य और आउटपुट	url; format (png, jpg, jpeg, webp, gif, tiff, pdf); resultMode (auto, url_only)
स्थान और व्यूपोर्ट	country (दो-अक्षर देश कोड), device, deviceViewportWidth, deviceViewportHeight, colorScheme (auto, dark, light), fullPage
पेज तैयारी	blockCookieBanners, blockAds, blockChatWidgets, selector, hideSelectors, clickSelectors
समय	waitUntil (load, domcontentloaded, networkidle0, networkidle2), delay (0–30 सेकंड), navigationTimeout (5–90 सेकंड), timeout (1–240 सेकंड)
कैश	cache, cacheTtl (14,400–2,592,000 सेकंड)
आउटपुट आकार बदलना	imageWidth, imageHeight (1–8,192; छवियों और PDF के लिए उपलब्ध)
केवल छवि	imageQuality (0–100, केवल JPEG/WebP)
केवल PDF	pdfPaperFormat (letter, legal, tabloid, a4, a3, content), pdfLandscape, pdfPrintBackground, pdfMargin, प्रति-पक्ष मार्जिन फ़ील्ड, pdfScale (0 से अधिक और अधिकतम 3)

जब दोनों आउटपुट आयाम प्रदान किए जाते हैं, तो उनका उत्पाद 64,000,000 पिक्सेल से अधिक नहीं हो सकता। PDF मार्जिन px, in, mm, या cm में गैर-नकारात्मक मान स्वीकार करते हैं। imageQuality के लिए JPEG या WebP आउटपुट की आवश्यकता होती है, और केवल PDF विकल्पों के लिए format: "pdf" की आवश्यकता होती है।

परिणाम

• PNG, JPEG, WebP और GIF को MCP छवि सामग्री के रूप में शामिल किया जा सकता है जब resultMode auto हो, MIME प्रकार पात्र हो, आयाम ज्ञात हों और प्रति पक्ष अधिकतम 8,000 पिक्सेल हों, कच्चा डेटा अधिकतम 5 MiB हो, और पूरा क्रमबद्ध परिणाम वर्तमान 128,000-बाइट सर्वर सीमा में फिट हो।
• एक कैप्चर जो एम्बेड करने के लिए पात्र नहीं है, वह सफल रहता है और अपना अस्थायी URL और एक कार्रवाई योग्य बहिष्करण कारण लौटाता है।
• TIFF केवल URL है।
• PDF बाइट्स कभी एम्बेड नहीं होते हैं। एक PDF परिणाम में सुरक्षित पाठ और संरचित मेटाडेटा, साथ ही एक संसाधन लिंक शामिल होता है जब Screenshot Scout एक परिणाम URL प्रदान करता है।
• resultMode: "url_only" हर प्रारूप के लिए छवि बाइट्स को छोड़ देता है।

MCP क्लाइंट नियंत्रित करते हैं कि लौटाई गई छवि सामग्री या संसाधन लिंक प्रदर्शित होते हैं या मॉडल को उपलब्ध कराए जाते हैं।

संरचित मेटाडेटा में screenshotUrl, screenshotUrlExpiresAt, cacheStatus, format, mimeType, imageWidth, imageHeight, inlineImageIncluded और inlineImageOmissionReason शामिल हो सकते हैं।

परिणाम URL को संवेदनशील, अस्थायी लिंक के रूप में मानें और उनकी रिपोर्ट की गई समाप्ति का सम्मान करें।

उदाहरण प्रॉम्प्ट

• “https://example.com को डार्क मोड में फुल-पेज PNG के रूप में कैप्चर करें। केवल एक URL लौटाएँ।”
• “https://example.com/pricing का 1280×720 JPEG स्क्रीनशॉट लें, कुकी बैनर और विज्ञापन ब्लॉक करें, और गुणवत्ता 80 का उपयोग करें।”
• “https://example.com/report का A4 PDF बैकग्राउंड सक्षम और 10 मिमी मार्जिन के साथ बनाएँ।”

गोपनीयता और सुरक्षा

सर्वर लक्ष्य URL और चयनित कैप्चर विकल्पों को Screenshot Scout को भेजता है, जो लक्ष्य वेबसाइट लोड करता है। निजी या विनियमित सामग्री कैप्चर करने से पहले Screenshot Scout गोपनीयता नीति की समीक्षा करें।

• उन पृष्ठों को कैप्चर न करें जिन्हें आप एक्सेस करने के लिए अधिकृत नहीं हैं।
• प्रॉम्प्ट, टूल इनपुट, URL, मुद्दा रिपोर्ट या लॉग में क्रेडेंशियल पेस्ट न करें।
• स्थानीय एक्सेस और गुप्त कुंजियों को क्लाइंट-प्रबंधित गुप्त भंडारण या निजी पर्यावरण कॉन्फ़िगरेशन में रखें।
• स्थानीय stdio सर्वर कोई टेलीमेट्री नहीं जोड़ता है। होस्टेड सेवा के लिए एप्लिकेशन लॉगिंग अनुरोध विधि, प्रतिक्रिया स्थिति, अवधि और स्वच्छ अप्रत्याशित त्रुटियों तक सीमित है। इसे क्रेडेंशियल, लक्ष्य URL, स्क्रीनशॉट URL, अनुरोध या प्रतिक्रिया सामग्री या छवि बाइट्स शामिल नहीं करने के लिए डिज़ाइन किया गया है।
• टूल उपयोग की अनुमति देने से पहले प्रत्येक लक्ष्य और कैप्चर अनुरोध की समीक्षा करें। टूल ओपन-वर्ल्ड है, कोटा खपत करता है और बाहरी वेबसाइट के साथ इंटरैक्ट करता है।
• SECURITY.md में वर्णित अनुसार कमजोरियों की निजी रिपोर्ट करें।

विकास

npm ci
npm run format:check
npm run lint
npm run typecheck
npm test
npm run metadata:check
npm run registry:validate
npm run mcpb:validate
npm run mcpb:pack

लाइसेंस

MIT © Oleksii Velykyi