Scrapfly Screenshot for Openclaw

A Python-based integration utilizing the Scrapfly API to capture high-quality, Javascript-rendered, and geo-targeted screenshots of any web page.

scrapfly
v1.0.0
Jul 9, 2026
0
572
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install scrapfly-screenshot

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install scrapfly-screenshot using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Scrapfly Screenshot?

The scrapfly-screenshot tool provides developers with a robust mechanism for capturing web pages dynamically. Built on top of the Scrapfly SDK, this integration allows applications running with Openclaw Skills to bypass anti-bot protections, render complex JavaScript, and capture the precise visual states of modern web applications. Developers can specify exact screen resolutions, trigger dynamic scrolling, and simulate user vision settings.

By incorporating this utility into your Openclaw Skills workflow, you gain programmatic control over image generation in multiple formats, including PNG, JPG, WebP, and GIF. It serves as an essential tool for automated visual testing, remote UI monitoring, and capturing complex single-page applications.

Scrapfly Screenshot Use Cases

  • Programmatic visual regression testing of responsive layouts across various custom viewports.
  • Capturing high-fidelity screenshots of dynamic web content that requires custom JavaScript execution.
  • Generating screenshots of pages behind anti-bot protections or geographical restrictions using proxy targeting.
  • Running automated accessibility testing by simulating color vision deficiencies on captured pages.
  • Isolating and capturing specific DOM elements dynamically via CSS selectors or XPath expressions.

How Scrapfly Screenshot Works

  1. The application initializes the ScrapflyClient using a configured API key.
  2. A ScreenshotConfig object is compiled with target parameters such as the URL, format, and rendering delay.
  3. The request is dispatched to the Scrapfly Screenshot API, routing through local proxies and applying anti-bot bypass technologies.
  4. The API waits for any specified CSS selector to render and processes requested DOM modifications.
  5. The tool retrieves the raw binary image stream, which can then be saved locally or fed directly into other Openclaw Skills for further automated tasks.

Scrapfly Screenshot Setup

To deploy this module within your Openclaw Skills projects, install the official Scrapfly Python SDK:

pip install scrapfly-sdk

Configure the required environment variable with your API credentials:

export SCRAPFLY_API_KEY="your_scrapfly_api_key_here"

Ensure that this environment variable is accessible by the execution context of your automation framework.

Scrapfly Screenshot Data Schema & Taxonomy

The scrapfly-screenshot tool manages configuration options via structured parameters in the Python SDK. Below is the metadata organization:

Parameter Type Required Description
url string Yes The target web page URL to be captured.
format string No Image file format: jpg, png, webp, or gif (Default: jpg).
capture string No Scope of capture: viewport, fullpage, or custom CSS selector/XPath.
resolution string No Screen size configuration (e.g., 1920x1080 or 375x812).
country string No ISO country code for geo-targeted proxy routing.
rendering_wait integer No Wait time in milliseconds after loading before taking the screenshot.
options array No Behavioral flags such as block_banners or dark_mode.

All generated outputs are processed as binary streams, with hosted storage URLs accessible in the transaction metadata.

Scrapfly Screenshot Advanced Features

  • CSS and XPath Target Capture: Isolate specific visual modules on a web page instead of capturing the entire viewport.
  • Headless DOM Manipulation: Inject custom, base64-encoded JavaScript code to hide elements or simulate user interaction before rendering.
  • Geo-Targeted Proxies: Capture region-specific designs and localized landing pages by routing traffic through specific country endpoints.
  • Automatic Scroll Actions: Scroll through the document height to trigger lazy-loaded images prior to image creation.
  • Accessibility Verification: Apply rendering overlays to test page compliance against protanopia, deuteranopia, and other vision conditions.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*