ScreenshotOne

Server MCP ScreenshotOne

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

Beberapa kata lagi tentang alasan dibuatnya dan beberapa pemikiran tentang masa depan MCP.

ScreenshotOne juga menawarkan server MCP yang di-hosting secara resmi. Lihat integrasi MCP ScreenshotOne untuk petunjuk pengaturan dan pembaruan terbaru.

Alat

• render-website-screenshot: Render tangkapan layar situs web dan kembalikan URL tangkapan layar sementara, konten, dan irisan sesuai permintaan.
• extract-website-markdown: Render situs web dan kembalikan Markdown yang telah dibersihkan langsung sebagai teks.
• get-usage: Dapatkan kuota API ScreenshotOne dan penggunaan konkurensi.

Alat tangkapan layar mengekspos opsi yang terfokus ini:

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

Nama opsi dan nilai untuk konten metadata dan irisan halaman penuh sesuai dengan API ScreenshotOne. Alat ini tidak mengekspos kontrol tipe respons atau cache; alat ini selalu meminta respons JSON dengan caching API dinonaktifkan.

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

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

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

Penggunaan

Bangun

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 yang berikut 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>"
            }
        }
    }
}

Berdiri sendiri atau untuk proyek lain

SCREENSHOTONE_API_KEY=your_api_key node build/index.js

Lisensi

ScreenshotOne MCP Server dilisensikan di bawah Lisensi MIT.