ScreenshotOne

ScreenshotOne MCP Sunucusu

ScreenshotOne için resmi bir MCP (Model Context Protocol) sunucusu uygulaması.

Neden geliştirildiğine ve MCP'nin geleceğine dair bazı düşüncelere ilişkin birkaç söz.

ScreenshotOne ayrıca resmi olarak barındırılan bir MCP sunucusu da sunar. Kurulum talimatları ve en son güncellemeler için ScreenshotOne MCP entegrasyonu sayfasına bakın.

Araçlar

• render-website-screenshot: Bir web sitesinin ekran görüntüsünü oluşturur ve istendiği şekilde geçici ekran görüntüsü, içerik ve dilim URL'lerini döndürür.
• render-website-screenshot-as-file: Bir web sitesinin ekran görüntüsünü veya PDF'sini oluşturur ve geçici bir URL ile birlikte dosyanın kendisini yanıta MCP kaynağı olarak ekler.
• extract-website-markdown: Bir web sitesini işler ve temizlenmiş Markdown içeriğini doğrudan metin olarak döndürür.
• get-usage: ScreenshotOne API kota ve eşzamanlı kullanım bilgilerini alır.

Ekran görüntüsü aracı, aşağıdaki amaca yönelik seçenekleri sunar:

• url
• block_banners (varsayılan: true)
• block_ads (varsayılan: true)
• image_quality (varsayılan: 80)
• full_page (varsayılan: false)
• full_page_slices (varsayılan: false; full_page=true gerektirir)
• metadata_content (varsayılan: false)
• metadata_content_format (html veya markdown; metadata_content=true gerektirir)

Meta veri içeriği ve tam sayfa dilimleri için seçenek adları ve değerleri ScreenshotOne API ile aynıdır. Araç, yanıt türü veya önbellek denetimlerini sunmaz; API önbelleği devre dışı bırakılmış bir JSON yanıtı ister.

Ekran görüntüsüyle birlikte geçici bir Markdown içerik URL'si almak için metadata_content=true ve metadata_content_format=markdown değerlerini ayarlayın. Daha küçük dikey ekran görüntüsü URL'leri almak için full_page=true ve full_page_slices=true değerlerini ayarlayın. Bir yapay zekâ aracısının tek bir büyük görüntü olarak güvenilir biçimde işlenemeyebilecek uzun bir sayfayı analiz etmesi gerektiğinde dilimler tercih edilir.

Başarılı bir yakalama, istenen URL'leri metin ve yapılandırılmış içerik olarak döndürür:

{
    "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'ler geçicidir. Ekran görüntüsü URL'si dört saate kadar kullanılabilir; meta veri içeriğinde ise tam sona erme zamanı yer alır. Saklamanız gereken tüm dosyaları indirin.

render-website-screenshot-as-file, örneğin dosyayı kaydetmesi veya eklemesi gereken ya da bağlantıları indiremeyen istemciler içindir. url, format (varsayılan olarak jpg; ayrıca png, webp, gif, jp2, tiff, avif, heif veya pdf), block_banners, block_ads, image_quality, full_page ve full_page_max_height (full_page=true gerektirir) değerlerini kabul eder. Dosyayı gömülü bir kaynak olarak (type: "resource", base64 biçiminde bir blob ve MIME türüyle birlikte) döndürür; ayrıca adını, URI'sini, MIME türünü, boyutunu ve geçici URL'sini metin ve yapılandırılmış içerik olarak sunar. 5 MB'tan büyük dosyalar gömülmez; araç daha küçük bir biçim, kalite veya yükseklik öneren bir hata döndürür ve geçici URL'yi de içerir.

extract-website-markdown yalnızca url kabul eder. ScreenshotOne'ın format=markdown API isteği için amaca yönelik bir kısayoldur ve elde edilen Markdown'ı tek bir MCP metin yanıtında doğrudan döndürür. Aracının ekran görüntüsü olmadan sayfa içeriğini okuması veya analiz etmesi gerektiğinde kullanın.

Kullanım

Derleyin

Önce bağımlılıkları yükleyip derleyin:

npm install && npm run build

ScreenshotOne API anahtarınızı alın

ScreenshotOne adresinde kaydolun ve API anahtarınızı alın.

npx ile çalıştırın

Depoyu klonlamadan CLI'ı doğrudan npm paketinden çalıştırın:

SCREENSHOTONE_API_KEY=your_api_key npx --yes @screenshotone/mcp

Claude for Desktop ile

Aşağıdakileri ~/Library/Application\ Support/Claude/claude_desktop_config.json dosyanıza ekleyin:

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

Bağımsız kullanım veya diğer projeler için

SCREENSHOTONE_API_KEY=your_api_key node build/index.js

Lisans

ScreenshotOne MCP Server, MIT Lisansı kapsamında lisanslanmıştır.