ScreenshotOne

ScreenshotOne MCP Server

Implementasi resmi server MCP (Model Context Protocol) untuk ScreenshotOne.

Beberapa kata lagi tentang alasan pembuatannya dan pemikiran tentang masa depan MCP.

ScreenshotOne juga menawarkan server MCP resmi yang di-host. Lihat integrasi ScreenshotOne MCP untuk petunjuk penyiapan dan pembaruan terbaru.

Alat

• render-website-screenshot: Merender tangkapan layar situs web dan mengembalikan URL sementara untuk tangkapan layar, konten, dan potongan sesuai permintaan.
• render-website-screenshot-as-file: Merender tangkapan layar atau PDF situs web dan mengembalikan file itu sendiri, disematkan dalam respons sebagai resource MCP, beserta URL sementara.
• extract-website-markdown: Merender situs web dan mengembalikan Markdown yang telah dibersihkan secara langsung sebagai teks.
• get-usage: Mendapatkan kuota API ScreenshotOne dan penggunaan konkurensi.

Alat tangkapan layar menyediakan opsi-opsi khusus berikut:

• url
• block_banners (defaultnya true)
• block_ads (defaultnya true)
• image_quality (defaultnya 80)
• full_page (defaultnya false)
• full_page_slices (defaultnya false; memerlukan full_page=true)
• metadata_content (defaultnya false)
• metadata_content_format (html atau markdown; memerlukan metadata_content=true)

Nama dan nilai opsi untuk konten metadata dan potongan halaman penuh sesuai dengan API ScreenshotOne. Alat ini tidak menyediakan kontrol jenis respons atau cache; alat ini selalu meminta respons JSON dengan cache API dinonaktifkan.

Atur metadata_content=true dan metadata_content_format=markdown untuk menerima URL konten Markdown sementara bersama tangkapan layar. Atur full_page=true dan full_page_slices=true untuk menerima URL tangkapan layar vertikal yang lebih kecil. Potongan lebih disarankan ketika agen AI perlu menganalisis halaman panjang yang mungkin tidak dapat ditangani dengan andal sebagai satu gambar besar.

Pengambilan yang berhasil mengembalikan URL yang diminta sebagai teks dan konten terstruktur:

{
    "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 tersebut bersifat sementara. URL tangkapan layar tersedia hingga empat jam, sedangkan konten metadata menyertakan waktu kedaluwarsa yang tepat. Unduh artefak apa pun yang ingin Anda simpan.

render-website-screenshot-as-file ditujukan bagi klien yang memerlukan file itu sendiri, misalnya untuk menyimpan atau melampirkannya, atau yang tidak dapat mengunduh tautan. Alat ini menerima url, format (jpg secara default, png, webp, gif, jp2, tiff, avif, heif, atau pdf), block_banners, block_ads, image_quality, full_page, dan full_page_max_height (memerlukan full_page=true). Alat ini mengembalikan file sebagai resource yang disematkan (type: "resource" dengan blob base64 dan jenis MIME-nya), serta nama, URI, jenis MIME, ukuran, dan URL sementara sebagai teks dan konten terstruktur. File yang lebih besar dari 5 MB tidak disematkan; alat ini mengembalikan kesalahan yang menyarankan format, kualitas, atau tinggi yang lebih kecil, serta menyertakan URL sementara.

extract-website-markdown hanya menerima url. Ini adalah pintasan khusus untuk permintaan API format=markdown ScreenshotOne dan mengembalikan Markdown yang dihasilkan secara langsung dalam satu respons teks MCP. Gunakan alat ini ketika agen perlu membaca atau menganalisis konten halaman tanpa tangkapan layar.

Penggunaan

Membangunnya

Selalu instal dependensi dan bangun terlebih dahulu:

npm install && npm run build

Dapatkan kunci API ScreenshotOne Anda

Daftar di ScreenshotOne dan dapatkan kunci API Anda.

Jalankan dengan npx

Jalankan CLI langsung dari paket npm tanpa mengkloning repositori:

SCREENSHOTONE_API_KEY=your_api_key npx --yes @screenshotone/mcp

Dengan Claude for Desktop

Tambahkan berikut ini ke ~/Library/Application\ Support/Claude/claude_desktop_config.json Anda:

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

Mandiri atau untuk proyek lain

SCREENSHOTONE_API_KEY=your_api_key node build/index.js

Lisensi

ScreenshotOne MCP Server dilisensikan di bawah Lisensi MIT.