ScreenshotOne

Máy chủ MCP ScreenshotOne

Bản triển khai chính thức của máy chủ MCP (Model Context Protocol) cho ScreenshotOne.

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

ScreenshotOne cũng cung cấp máy chủ MCP lưu trữ chính thức. Xem tích hợp MCP ScreenshotOne để 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: Kết xuất ảnh chụp màn hình trang web và trả về các URL ảnh chụp màn hình, nội dung và lát cắt tạm thời theo yêu cầu.
• extract-website-markdown: Kết xuất một trang web và trả về Markdown đã được làm sạch trực tiếp dưới dạng văn bản.
• get-usage: Lấy hạn mức API ScreenshotOne và mức sử dụng đồng thời.

Công cụ chụp màn hình hiển thị các tùy chọn tập trung 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à lát cắt toàn trang khớp với API ScreenshotOne. Công cụ không hiển thị các điều khiển loại phản hồi hoặc bộ nhớ đệm; nó luôn yêu cầu phản hồi JSON với bộ nhớ đệm API bị tắt.

Đặt metadata_content=true và metadata_content_format=markdown để nhận URL nội dung Markdown tạm thời kèm ả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 nhỏ hơn. Các lát cắt được ưu tiên khi một tác nhân AI cần phân tích một trang dài có thể không được xử lý đáng tin cậy dưới dạng một hình ảnh lớn.

Việc chụp thành công 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 là tạm thời. URL ảnh chụp màn hình có sẵn trong tối đa bốn giờ, trong khi nội dung siêu dữ liệu bao gồm thời gian hết hạn chính xác của nó. Tải xuống bất kỳ tệp nào bạn cần giữ lại.

extract-website-markdown chỉ chấp nhận url. Đây là phím tắt tập trung cho yêu cầu API format=markdown của ScreenshotOne và trả về Markdown kết quả trực tiếp trong một phản hồi văn bản MCP. Sử dụng nó khi tác nhân 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 nó

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

npm install && npm run build

Lấy khóa API ScreenshotOne của bạn

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

Chạy với npx

Chạy CLI trực tiếp 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 của bạn:

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

Độ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.