ScreenshotOne

ScreenshotOne MCP Server

ScreenshotOne के लिए MCP (Model Context Protocol) सर्वर का आधिकारिक कार्यान्वयन।

इसे बनाने के कारण और MCP के भविष्य के बारे में कुछ विचार।

ScreenshotOne एक आधिकारिक होस्टेड MCP सर्वर भी प्रदान करता है। सेटअप निर्देशों और नवीनतम अपडेट के लिए ScreenshotOne MCP integration देखें।

टूल

• render-website-screenshot: वेबसाइट का स्क्रीनशॉट रेंडर करें और अनुरोध के अनुसार अस्थायी स्क्रीनशॉट, सामग्री और स्लाइस URL लौटाएँ।
• render-website-screenshot-as-file: वेबसाइट का स्क्रीनशॉट या PDF रेंडर करें और फ़ाइल को अस्थायी URL के साथ, MCP संसाधन के रूप में एम्बेड करके प्रतिक्रिया में लौटाएँ।
• render-html-screenshot-as-file: आपके द्वारा लिखे या प्राप्त किए गए HTML, जैसे सोशल कार्ड या चार्ट, को रेंडर करें और स्क्रीनशॉट को इनलाइन इमेज के रूप में लौटाएँ, जिसे एजेंट देख सके; साथ में फ़ाइल का नाम और आकार भी दें।
• extract-website-markdown: वेबसाइट रेंडर करें और उसकी साफ़ की गई Markdown सामग्री सीधे टेक्स्ट के रूप में लौटाएँ।
• get-usage: ScreenshotOne API का कोटा और समवर्ती उपयोग देखें।

स्क्रीनशॉट टूल में ये विशिष्ट विकल्प उपलब्ध हैं:

• url
• block_banners (डिफ़ॉल्ट true है)
• block_ads (डिफ़ॉल्ट true है)
• image_quality (डिफ़ॉल्ट 80 है)
• full_page (डिफ़ॉल्ट false है)
• full_page_slices (डिफ़ॉल्ट false है; इसके लिए full_page=true आवश्यक है)
• metadata_content (डिफ़ॉल्ट false है)
• metadata_content_format (html या markdown; इसके लिए metadata_content=true आवश्यक है)

मेटाडेटा सामग्री और पूरे पृष्ठ के स्लाइस के विकल्पों के नाम और मान ScreenshotOne API से मेल खाते हैं। टूल प्रतिक्रिया-प्रकार या कैश नियंत्रण उपलब्ध नहीं कराता; यह हमेशा API कैशिंग बंद करके JSON प्रतिक्रिया का अनुरोध करता है।

स्क्रीनशॉट के साथ अस्थायी Markdown सामग्री URL पाने के लिए metadata_content=true और metadata_content_format=markdown सेट करें। छोटे ऊर्ध्वाधर स्क्रीनशॉट URL पाने के लिए full_page=true और full_page_slices=true सेट करें। जब किसी AI एजेंट को लंबे पृष्ठ का विश्लेषण करना हो, जिसे एक बड़ी इमेज के रूप में विश्वसनीय ढंग से संभालना संभव न हो, तो स्लाइस बेहतर विकल्प हैं।

सफल कैप्चर अनुरोधित URL को टेक्स्ट और संरचित सामग्री के रूप में लौटाता है:

{
    "url": "https://<screenshotone-cache-domain>/...",
    "content": {
        "url": "https://<screenshotone-cache-domain>/...",
        "expires": "Sun, 07 Sep 2026 12:00:00 GMT",
        "format": "markdown"
    },
    "slices": [
        {
            "index": 0,
            "offset_y": 0,
            "width": 1280,
            "height": 4000,
            "url": "https://<screenshotone-cache-domain>/..."
        }
    ]
}

URL अस्थायी होते हैं। स्क्रीनशॉट URL अधिकतम चार घंटे तक उपलब्ध रहता है, जबकि मेटाडेटा सामग्री में उसकी सटीक समाप्ति का समय शामिल होता है। जिन आर्टिफ़ैक्ट को रखना हो, उन्हें डाउनलोड करें।

render-website-screenshot-as-file उन क्लाइंट के लिए है जिन्हें फ़ाइल स्वयं चाहिए, उदाहरण के लिए उसे सहेजने या संलग्न करने के लिए, या जो लिंक डाउनलोड नहीं कर सकते। यह url, format (डिफ़ॉल्ट रूप से jpg, png, webp, gif, jp2, tiff, avif, heif, या pdf), block_banners, block_ads, image_quality, full_page, और full_page_max_height स्वीकार करता है (इसके लिए full_page=true आवश्यक है)। यह फ़ाइल को एम्बेडेड संसाधन के रूप में लौटाता है (type: "resource", जिसमें base64 blob और उसका MIME प्रकार शामिल है), साथ ही उसका नाम, URI, MIME प्रकार, आकार और अस्थायी URL टेक्स्ट और संरचित सामग्री के रूप में देता है। 5 MB से बड़ी फ़ाइलें एम्बेड नहीं की जातीं; टूल कम आकार, गुणवत्ता या ऊँचाई चुनने का सुझाव देने वाली त्रुटि और अस्थायी URL लौटाता है।

render-html-screenshot-as-file कॉल में दिए गए HTML, जैसे सोशल कार्ड, चार्ट या रिपोर्ट, को रेंडर करता है, ताकि एजेंट को ब्राउज़र चलाए बिना इमेज मिल सके। यह html (आवश्यक, अधिकतम 1,000,000 वर्ण; जैसा दिया गया है, ठीक वैसा ही भेजा जाता है), viewport_width (320–3840; डिफ़ॉल्ट 1280 है; HTML जिस चौड़ाई के लिए बनाया गया है, वही उपयोग करें), full_page (डिफ़ॉल्ट true है), और image_quality (डिफ़ॉल्ट 80 है) स्वीकार करता है। HTML को JSON POST बॉडी में API को भेजा जाता है और API JPEG सीधे लौटाता है, बिना किसी अस्थायी URL के। टूल इसे इनलाइन इमेज के रूप में लौटाता है (type: "image", जिसमें base64 data शामिल है), साथ ही उसका नाम, MIME प्रकार और आकार टेक्स्ट और संरचित सामग्री के रूप में देता है। 5 MB से बड़ी इमेज नहीं लौटाई जातीं; त्रुटि कम गुणवत्ता या कम full_page=false का सुझाव देती है।

extract-website-markdown केवल url स्वीकार करता है। यह ScreenshotOne के format=markdown API अनुरोध का एक विशिष्ट शॉर्टकट है और परिणामी Markdown को सीधे एक MCP टेक्स्ट प्रतिक्रिया में लौटाता है। जब एजेंट को स्क्रीनशॉट के बिना पृष्ठ की सामग्री पढ़नी या उसका विश्लेषण करना हो, तब इसका उपयोग करें।

उपयोग

इसे बनाएँ

हमेशा पहले निर्भरताएँ इंस्टॉल करें और इसे बिल्ड करें:

npm install && npm run build

अपनी ScreenshotOne API key प्राप्त करें

ScreenshotOne पर साइन अप करें और अपनी API key प्राप्त करें।

npx से चलाएँ

रिपॉज़िटरी क्लोन किए बिना, npm पैकेज से सीधे CLI चलाएँ:

SCREENSHOTONE_API_KEY=your_api_key npx --yes @screenshotone/mcp

Claude for Desktop के साथ

अपने ~/Library/Application\ Support/Claude/claude_desktop_config.json में निम्नलिखित जोड़ें:

{
    "mcpServers": {
        "screenshotone": {
            "command": "npx",
            "args": ["--yes", "@screenshotone/mcp"],
            "env": {
                "SCREENSHOTONE_API_KEY": "<your api key>"
            }
        }
    }
}

स्टैंडअलोन या अन्य प्रोजेक्ट के लिए

SCREENSHOTONE_API_KEY=your_api_key node build/index.js

लाइसेंस

ScreenshotOne MCP Server MIT License के अंतर्गत लाइसेंस प्राप्त है।