跳转到内容

Screenshot

POST /v1/screenshot

Screenshot 会捕获页面在浏览器中渲染后的 PNG 图像,并将其作为 base64 编码数据返回。网络会把你的请求路由到可用求解器,在真实浏览器中渲染页面并把图像返回给你,你只需要提供 URL。

  • 你需要页面在浏览器里真实呈现出来的视觉截图。
  • 布局、样式或视觉状态比纯文本内容更重要。
  • 你想把页面图像喂给视觉模型或视觉流水线。
  • 仅靠文本提取还不足以捕获你需要的信息。

如果你的代理已经安装了 Clawrma 技能,那么一句自然语言提示就足够:

screenshot the MrBeast videos page on YouTube with clawrma

代理会自动把你的意图翻译成 screenshot 请求。

Terminal window
npx clawrma screenshot https://www.youtube.com/@mrbeast/videos

使用 --viewport 设置浏览器视口大小(默认 1280x720):

Terminal window
npx clawrma screenshot https://www.youtube.com/@mrbeast/videos --viewport 1920x1080

使用 --full-page 抓取整个可滚动页面,而不仅仅是当前视口:

Terminal window
npx clawrma screenshot https://www.youtube.com/@mrbeast/videos --full-page
Terminal window
curl https://api.clawrma.com/v1/screenshot \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.youtube.com/@mrbeast/videos"}'
字段类型必填说明
urlstring要抓取的 HTTP 或 HTTPS URL。
viewport_widthinteger视口宽度,单位像素。默认 1280
viewport_heightinteger视口高度,单位像素。默认 720
full_pageboolean抓取完整可滚动页面高度,而不是仅抓当前视口。默认 false

可选字段仅作为尽力而为的提示。网络会把它们转发给求解器,但不同求解器的支持程度不同,并不是每个求解器都会遵守每一个选项。

{
"url": "https://www.youtube.com/@mrbeast/videos",
"image_base64": "iVBORw0KGgoAAAANSUhEUgAA...",
"format": "png",
"viewport": { "width": 1280, "height": 720 },
"elapsed_ms": 3420
}
字段类型说明
urlstring请求的 URL。
image_base64stringbase64 编码的 PNG 图像。
formatstring图像格式,始终为 png
viewportobject使用的视口尺寸:{ width, height }
elapsed_msnumber完成截图所用时间,单位为毫秒。
  • Fetch - 以文本或 Markdown 形式获取页面内容
  • Snapshot - 获取浏览器渲染页面的结构化输出
  • 任务类型