Utility Commands
comment
Section titled “comment”Add a descriptive comment to the automation logs.
| Parameter | Type | Required | Description |
|---|---|---|---|
text |
string | ✅ | Comment text |
save_as_pdf
Section titled “save_as_pdf”Save the current page as a PDF file.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
path |
string | ✅ | — | Output file path |
screenshot
Section titled “screenshot”Take a screenshot of the page.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
path |
string | ✅ | — | Output file path |
fullPage |
boolean | ❌ | true | Capture the full page |
set_viewport_size
Section titled “set_viewport_size”Set the browser viewport size.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
width |
number | ✅ | — | Viewport width in pixels |
height |
number | ✅ | — | Viewport height in pixels |
set_geolocation
Section titled “set_geolocation”Set the browser’s geographic location.
| Parameter | Type | Required | Description |
|---|---|---|---|
latitude |
number | ✅ | Latitude |
longitude |
number | ✅ | Longitude |
context_set_offline
Section titled “context_set_offline”Simulate the browser being offline.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
offline |
boolean | ❌ | true | Set offline status |
clear_cookies
Section titled “clear_cookies”Clear all cookies for the current site.
No parameters.
execute_script
Section titled “execute_script”Run JavaScript in the browser page context.
| Parameter | Type | Required | Description |
|---|---|---|---|
script |
string | ✅ | JavaScript code to execute |
output_variable |
string | ❌ | Variable to store the return value |
Example:
script: return document.title;output_variable: page_titlerun_script
Section titled “run_script”Run a Deno script on the server side (full access to file system, network, etc.).
| Parameter | Type | Required | Description |
|---|---|---|---|
script |
string | ✅ | Deno script code |
⚠️ Note:
run_scriptruns on the server side with full system access. Useexecute_scriptfor browser-side JavaScript.
switch_to_tab
Section titled “switch_to_tab”Switch to a specific browser tab.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
index |
number | ❌ | 0 | Tab index (0-based) |
fallback_url |
string | ❌ | — | URL to open if tab doesn’t exist |
process_image
Section titled “process_image”Manipulate an image file.
| Parameter | Type | Required | Description |
|---|---|---|---|
input_path |
string | ✅ | Input image path |
output_path |
string | ✅ | Output image path |
action |
string | ✅ | Action: resize, crop, convert, compress |
options |
object | ❌ | Action-specific options |
Options
Section titled “Options”| Action | Options |
|---|---|
resize |
width, height |
crop |
x, y, width, height |
convert |
format (jpeg, png), quality (1-100) |
compress |
quality (1-100) |
file_operation
Section titled “file_operation”Perform file system operations.
| Parameter | Type | Required | Description |
|---|---|---|---|
action |
string | ✅ | Action: move, rename, copy, delete, zip, unzip |
source |
string | ✅ | Source file/directory path |
destination |
string | ✅ | Destination path |
audit_accessibility
Section titled “audit_accessibility”Run an accessibility audit on the page.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
scope |
string | ❌ | html |
CSS selector for audit scope |
rules |
array | ❌ | — | Specific rules to run |
output_variable |
string | ❌ | — | Variable to store results |
output_filename |
string | ❌ | — | File path for results |
detect_tech_stack
Section titled “detect_tech_stack”Detect technologies used on the page.
| Parameter | Type | Required | Description |
|---|---|---|---|
output_variable |
string | ❌ | Variable to store detected technologies |
audit_links
Section titled “audit_links”Check all links on the page for broken URLs.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
selector |
string | ❌ | a[href] |
Selector for links to check |
concurrency |
number | ❌ | 5 | Parallel checks |
timeout |
number | ❌ | 10000 | Timeout per link (ms) |
output_filename |
string | ❌ | — | File path for results |