ScreenshotOne

ScreenshotOne MCP Server

Một bản triển khai chính thức của máy chủ MCP (Model Context Protocol) dành cho ScreenshotOne.

Một vài lời nữa về lý do xây dựng máy chủ này và một số suy nghĩ về tương lai của MCP.

ScreenshotOne cũng cung cấp một máy chủ MCP được lưu trữ chính thức. Xem tích hợp ScreenshotOne MCP để biết hướng dẫn thiết lập và các cập nhật mới nhất.

Công cụ

• render-website-screenshot: Chụp ảnh màn hình trang web và trả về các URL tạm thời của ảnh chụp màn hình, nội dung và các phần ảnh theo yêu cầu.
• render-website-screenshot-as-file: Chụp ảnh màn hình trang web hoặc PDF và trả về chính tệp đó, được nhúng trong phản hồi dưới dạng tài nguyên MCP, kèm theo URL tạm thời.
• extract-website-markdown: Truy xuất trang web và trả về Markdown đã được làm sạch dưới dạng văn bản.
• get-usage: Lấy thông tin về hạn mức API và mức sử dụng đồng thời của ScreenshotOne.

Công cụ chụp ảnh màn hình cung cấp các tùy chọn chuyên biệt sau:

• url
• block_banners (mặc định là true)
• block_ads (mặc định là true)
• image_quality (mặc định là 80)
• full_page (mặc định là false)
• full_page_slices (mặc định là false; yêu cầu full_page=true)
• metadata_content (mặc định là false)
• metadata_content_format (html hoặc markdown; yêu cầu metadata_content=true)

Tên và giá trị tùy chọn cho nội dung siêu dữ liệu và các phần ảnh toàn trang khớp với API ScreenshotOne. Công cụ không cung cấp tùy chọn kiểm soát kiểu phản hồi hoặc bộ nhớ đệm; công cụ luôn yêu cầu phản hồi JSON và tắt bộ nhớ đệm API.

Đặt metadata_content=true và metadata_content_format=markdown để nhận URL nội dung Markdown tạm thời cùng với ảnh chụp màn hình. Đặt full_page=true và full_page_slices=true để nhận các URL ảnh chụp màn hình dọc có kích thước nhỏ hơn. Nên dùng các phần ảnh khi tác tử AI cần phân tích một trang dài mà có thể không được xử lý đáng tin cậy dưới dạng một ảnh lớn duy nhất.

Lần chụp thành công sẽ trả về các URL được yêu cầu dưới dạng văn bản và nội dung có cấu trúc:

{
    "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>/..."
        }
    ]
}

Các URL chỉ có hiệu lực tạm thời. URL ảnh chụp màn hình có thể truy cập trong tối đa bốn giờ, còn nội dung siêu dữ liệu bao gồm thời điểm hết hạn chính xác. Hãy tải xuống mọi tệp cần lưu giữ.

render-website-screenshot-as-file dành cho các ứng dụng cần chính tệp đó, chẳng hạn để lưu hoặc đính kèm, hoặc không thể tải xuống từ liên kết. Công cụ chấp nhận url, format (mặc định là jpg, png, webp, gif, jp2, tiff, avif, heif hoặc pdf), block_banners, block_ads, image_quality, full_page và full_page_max_height (yêu cầu full_page=true). Công cụ trả về tệp dưới dạng tài nguyên được nhúng (type: "resource" với blob được mã hóa base64 và kiểu MIME của tệp), cùng với tên, URI, kiểu MIME, kích thước và URL tạm thời của tệp dưới dạng văn bản và nội dung có cấu trúc. Các tệp lớn hơn 5 MB sẽ không được nhúng; công cụ trả về lỗi đề xuất định dạng, chất lượng hoặc chiều cao nhỏ hơn, đồng thời cung cấp URL tạm thời.

extract-website-markdown chỉ chấp nhận url. Đây là lối tắt chuyên biệt cho yêu cầu API format=markdown của ScreenshotOne và trả về Markdown thu được trực tiếp trong một phản hồi văn bản MCP. Hãy dùng công cụ này khi tác tử cần đọc hoặc phân tích nội dung trang mà không cần ảnh chụp màn hình.

Cách sử dụng

Xây dựng

Luôn cài đặt các phần phụ thuộc và xây dựng trước:

npm install && npm run build

Lấy khóa API ScreenshotOne

Đăng ký tại ScreenshotOne và lấy khóa API.

Chạy bằng npx

Chạy trực tiếp CLI từ gói npm mà không cần sao chép kho lưu trữ:

SCREENSHOTONE_API_KEY=your_api_key npx --yes @screenshotone/mcp

Với Claude for Desktop

Thêm nội dung sau vào ~/Library/Application\ Support/Claude/claude_desktop_config.json:

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

Dùng độc lập hoặc cho các dự án khác

SCREENSHOTONE_API_KEY=your_api_key node build/index.js

Giấy phép

ScreenshotOne MCP Server được cấp phép theo Giấy phép MIT.