ScreenshotOne

ScreenshotOne MCP सर्वर

ScreenshotOne के लिए MCP (मॉडल कॉन्टेक्स्ट प्रोटोकॉल) सर्वर का एक आधिकारिक कार्यान्वयन।

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

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

उपकरण

• render-website-screenshot: वेबसाइट का स्क्रीनशॉट रेंडर करें और अनुरोध के अनुसार अस्थायी स्क्रीनशॉट, सामग्री और स्लाइस URL लौटाएँ।
• 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 चार घंटे तक उपलब्ध रहता है, जबकि मेटाडेटा सामग्री में उसकी सटीक समाप्ति समय शामिल होता है। जो भी आर्टिफैक्ट आपको रखना हो उसे डाउनलोड करें।

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

उपयोग

इसे बनाएँ

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

npm install && npm run build

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

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

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 लाइसेंस के अंतर्गत लाइसेंस प्राप्त है।