ScreenshotOne

ScreenshotOne MCP Sunucusu

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

Neden oluşturulduğu ve MCP'nin geleceği hakkında birkaç söz daha.

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

Araçlar

• render-website-screenshot: Bir web sitesi ekran görüntüsü oluşturun ve istendiği gibi geçici ekran görüntüsü, içerik ve dilim URL'lerini döndürün.
• extract-website-markdown: Bir web sitesi oluşturun ve temizlenmiş Markdown'ı doğrudan metin olarak döndürün.
• get-usage: ScreenshotOne API kotasını ve eşzamanlılık kullanımını alın.

Ekran görüntüsü aracı şu odaklanmış 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 eşleşir. Araç, yanıt türü veya önbellek kontrollerini açığa çıkarmaz; her zaman API önbelleğe alma devre dışı bırakılmış bir JSON yanıtı ister.

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 zeka aracısının tek bir büyük görüntü olarak güvenilir şekilde 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 en fazla dört saat boyunca kullanılabilirken, meta veri içeriği tam sona erme süresini içerir. Saklamanız gereken herhangi bir dosyayı indirin.

extract-website-markdown yalnızca url kabul eder. ScreenshotOne'ın format=markdown API isteği için odaklanmış bir kısayoldur ve ortaya çıkan Markdown'ı doğrudan tek bir MCP metin yanıtında 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ı kurun ve derleyin:

npm install && npm run build

ScreenshotOne API anahtarınızı alın

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

npx ile çalıştırın

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

SCREENSHOTONE_API_KEY=your_api_key npx --yes @screenshotone/mcp

Claude for Desktop ile

Aşağıdakini ~/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 veya diğer projeler için

SCREENSHOTONE_API_KEY=your_api_key node build/index.js

Lisans

ScreenshotOne MCP Server MIT Lisansı altında lisanslıdır.