Urlbox Full Page Screenshots
chính thứcMột máy chủ MCP cho API chụp ảnh màn hình Urlbox. Nó cho phép ứng dụng khách của bạn chụp ảnh màn hình, tạo PDF, trích xuất HTML/markdown, và nhiều hơn nữa từ các trang web.
Bạn có thể làm gì với Urlbox Full Page Screenshots MCP?
- Chụp ảnh màn hình toàn trang — Yêu cầu chụp ảnh màn hình của bất kỳ URL nào, với tùy chọn chặn quảng cáo hoặc biểu ngữ cookie.
- Tạo PDF và video — Yêu cầu PDF có đánh dấu mục lục hoặc kết xuất video của một trang, lưu cục bộ qua
save_render. - Trích xuất nội dung trang — Chuyển đổi bất kỳ bài viết hoặc trang web nào thành markdown sạch, HTML hoặc văn bản bài viết thuần túy.
- So sánh phiên bản trang — Yêu cầu so sánh trực quan hai URL hoặc chụp cách một trang web hiển thị trên khung nhìn điện thoại.
- Quản lý tài nguyên Urlbox — Với khóa tổ chức, tạo hoặc cập nhật dự án, kiểm tra webhook và xem lại mức sử dụng tài khoản.
Tài liệu
Máy chủ MCP Urlbox Screenshot
Cung cấp cho trợ lý AI của bạn một trình duyệt thực để chụp ảnh màn hình trang web. Máy chủ MCP Urlbox chụp ảnh màn hình, tạo PDF và video, trích xuất HTML, markdown và văn bản bài viết, so sánh các trang, đồng thời quản lý các dự án, webhook và mức sử dụng Urlbox của bạn.
Sử dụng máy chủ lưu trữ (khuyến nghị)
Kết nối máy khách của bạn với https://api.urlbox.com/mcp. Không cần cài đặt gì.
-
Claude (claude.ai và máy tính để bàn): Cài đặt, Trình kết nối, Thêm trình kết nối tùy chỉnh, nhập
https://api.urlbox.com/mcp, sau đó đăng nhập vào Urlbox. -
ChatGPT: thêm trình kết nối với URL
https://api.urlbox.com/mcp, sau đó đăng nhập vào Urlbox. -
Claude Code:
claude mcp add --transport http urlbox https://api.urlbox.com/mcp, sau đó chạy/mcpđể đăng nhập. -
Codex:
codex mcp add urlbox --url https://api.urlbox.com/mcp, sau đócodex mcp login urlboxđể đăng nhập. -
Cursor: thêm phần này vào
~/.cursor/mcp.json:{ "mcpServers": { "urlbox": { "url": "https://api.urlbox.com/mcp", "headers": { "Authorization": "Bearer YOUR_URLBOX_API_KEY" } } } }
Các máy khách không thể đăng nhập có thể gửi khóa API dưới dạng Authorization: Bearer <key>. Khóa API tổ chức (ubx_org_...) mở khóa mọi công cụ. Khóa bí mật dự án chỉ hoạt động cho các công cụ kết xuất. Tìm khóa của bạn trong bảng điều khiển Urlbox.
Cầu nối cục bộ (gói này)
Một số máy khách chỉ có thể khởi động máy chủ cục bộ. Gói này là một cầu nối cục bộ nhỏ: nó chạy trên máy của bạn qua stdio và chuyển tiếp mọi thứ đến máy chủ lưu trữ, để bạn có được chính xác các công cụ tương tự, luôn được cập nhật.
{
"mcpServers": {
"urlbox": {
"command": "npx",
"args": ["-y", "@urlbox/screenshot-mcp"],
"env": {
"URLBOX_API_KEY": "your_api_key_here"
}
}
}
}
Yêu cầu Node.js 20 trở lên.
| Biến | Mô tả |
|---|---|
URLBOX_API_KEY | Khóa API tổ chức hoặc khóa bí mật dự án của bạn. |
SECRET_KEY | Cũng được chấp nhận, cho các cấu hình được viết cho 1.x. URLBOX_API_KEY được ưu tiên nếu cả hai được đặt. |
URLBOX_DOWNLOAD_DIR | Nơi save_render lưu tệp. Mặc định là ~/Downloads. |
Cầu nối thêm một công cụ cục bộ, save_render, tải xuống URL kết xuất được trả về bởi bất kỳ công cụ Urlbox nào và lưu vào máy tính của bạn. Chỉ cần yêu cầu, ví dụ "chụp ảnh màn hình example.com và lưu vào máy tính của tôi". Các tệp hiện có không bao giờ bị ghi đè.
Nâng cấp từ 1.x
Cấu hình hiện tại của bạn vẫn hoạt động: SECRET_KEY vẫn được đọc và tên gói cũng như lệnh không thay đổi.
- Các công cụ hiện đến từ máy chủ lưu trữ, vì vậy có nhiều công cụ hơn và chúng tiếp tục được cải thiện mà không cần cập nhật.
rendervẫn ở đó. Tùy chọnstore_renderscủa nó và công cụdownloadđược thay thế bằngsave_render.- Các tệp được lưu vào
~/Downloadsthay vì~/Downloads/urlbox-renders. ĐặtURLBOX_DOWNLOAD_DIRđể giữ vị trí cũ. - Với khóa bí mật dự án, bạn có các công cụ kết xuất. Sử dụng khóa API tổ chức để cũng quản lý dự án, webhook và mức sử dụng.
- Yêu cầu Node.js 20 trở lên.
Ví dụ về lời nhắc
- Chụp ảnh màn hình https://example.com mà không có quảng cáo hoặc biểu ngữ cookie.
- Lưu https://urlbox.com dưới dạng PDF có đánh dấu với mục lục và tải xuống máy tính của tôi.
- Chuyển bài viết này thành markdown: https://example.com/blog/post
- https://example.com trông như thế nào trên điện thoại?
Phát triển
npm install
npm test
Các bài kiểm tra chạy cầu nối với một máy chủ giả cục bộ, vì vậy chúng không cần tài khoản Urlbox.
Giấy phép
MIT
