Utility Blocks

Logging, webhooks, websockets, file operations, and helper utilities

Overview

Utility blocks provide supporting functionality:

• Log: Debug output and message logging
• Script: Custom JavaScript execution
• Plugin: Load custom plugin blocks
• Webhook: Send HTTP webhooks
• WebSocket: WebSocket communication
• FileSystem: File and folder operations
• RandomUserAgent: Generate realistic user agents
• RandomData: Generate random test data
• ClearCookies: Clear cookie jar
• Constants: Define constant values
• Dictionary: Key-value storage operations
• GenerateGUID: Generate UUIDs
• PhoneCountry: Extract country from phone numbers

Log

Output messages to the console for debugging.

Settings

message · string · required

Message to log (supports variable interpolation)

Example

{
  "block_type": "Log",
  "label": "Debug Output",
  "settings": {
    "type": "Log",
    "message": "User: <input.USER>, Response: <data.RESPONSECODE>, Token: <data.TOKEN>"
  }
}

Webhook

Send HTTP webhook notifications.

Settings

url · string · required

Webhook URL

method · string · default: "POST"

HTTP method (GET, POST, PUT)

headers · array

Custom headers as [name, value] tuples

body_template · string

Request body with variable interpolation

content_type · string · default: "application/json"

Content-Type header value

custom_cookies · string

Custom cookies (one per line: name=value)

Example

{
  "block_type": "Webhook",
  "label": "Discord Notification",
  "settings": {
    "type": "Webhook",
    "url": "https://discord.com/api/webhooks/...",
    "method": "POST",
    "body_template": "{\"content\":\"Found valid account: <input.USER>\"}",
    "content_type": "application/json"
  }
}

WebSocket

Communicate via WebSocket connections.

Settings

url · string · required

WebSocket URL (ws:// or wss://)

action · string · required

WebSocket action:

• connect - Open connection
• send - Send message
• receive - Receive message
• close - Close connection

message · string

Message to send (for send action)

output_var · string · default: "WS_RESPONSE"

Variable name to store received data

timeout_ms · number · default: "10000"

Operation timeout

Example

{
  "block_type": "WebSocket",
  "label": "Connect to WS",
  "settings": {
    "type": "WebSocket",
    "url": "wss://stream.example.com/feed",
    "action": "connect"
  }
}

FileSystem

Perform file and folder operations.

Settings

op · FileSystemOp · required

File operation:

• FileRead - Read file contents
• FileWrite - Write file
• FileAppend - Append to file
• FileDelete - Delete file
• FileExists - Check if file exists
• FileCopy - Copy file
• FileMove - Move/rename file
• FileReadBytes - Read as binary
• FileWriteBytes - Write binary data
• FileReadLines - Read as line array
• FileWriteLines - Write line array
• FileAppendLines - Append lines
• CreatePath - Create directory
• FolderDelete - Delete directory
• FolderExists - Check if folder exists
• GetFilesInFolder - List files

path · string · required

File or folder path

dest_path · string

Destination path (for Copy/Move operations)

content · string

Content to write (for Write/Append operations)

encoding · string · default: "utf8"

Text encoding (utf8, ascii, etc.)

output_var · string · default: "RESULT"

Variable name to store result

capture · boolean · default: "false"

Capture as user-visible variable

Example

{
  "block_type": "FileSystem",
  "label": "Save Results",
  "settings": {
    "type": "FileSystem",
    "op": "FileAppendLines",
    "path": "./results/valid.txt",
    "content": "<input.USER>:<input.PASS>"
  }
}

RandomUserAgent

Generate realistic user agent strings.

Settings

mode · UserAgentMode · default: "Random"

Generation mode:

• Random - Generate from browser database
• CustomList - Pick from custom list

browser_filter · array · default: "[Chrome, Firefox, Safari, Edge]"

Browser types to include in random generation

platform_filter · array · default: "[Desktop, Mobile]"

Platform types to include

custom_list · string

Custom user agent list (one per line)

output_var · string · default: "USER_AGENT"

Variable name to store generated user agent

capture · boolean · default: "false"

Capture as user-visible variable

match_tls · boolean · default: "false"

Match TLS fingerprint to user agent (when using AzureTLS)

Example

{
  "block_type": "RandomUserAgent",
  "label": "Generate UA",
  "settings": {
    "type": "RandomUserAgent",
    "mode": "Random",
    "browser_filter": ["Chrome", "Firefox"],
    "platform_filter": ["Desktop"],
    "output_var": "USER_AGENT"
  }
}

RandomData

Generate random test data.

Settings

data_type · RandomDataType · required

Type of data to generate:

• String - Random string
• Uuid - UUID v4
• Number - Random number
• Email - Random email address
• FirstName - Random first name
• LastName - Random last name
• FullName - Random full name
• StreetAddress - Random address
• City - Random city
• State - Random state/province
• ZipCode - Random ZIP/postal code
• PhoneNumber - Random phone number
• Date - Random date

output_var · string · default: "RANDOM"

Variable name to store generated value

capture · boolean · default: "false"

Capture as user-visible variable

string_length · number · default: "16"

String length (for String type)

string_charset · string · default: "alphanumeric"

Character set: alphanumeric, alpha, numeric, hex, custom

custom_chars · string

Custom character set (when charset is “custom”)

number_min · number · default: "0"

Minimum number (for Number type)

number_max · number · default: "100"

Maximum number (for Number type)

number_decimal · boolean · default: "false"

Generate decimal numbers

date_format · string · default: "%Y-%m-%d"

Date format string (for Date type)

date_min · string

Minimum date

date_max · string

Maximum date

Examples

{
  "block_type": "RandomData",
  "label": "Generate Email",
  "settings": {
    "type": "RandomData",
    "data_type": "Email",
    "output_var": "RANDOM_EMAIL",
    "capture": true
  }
}

{
  "block_type": "RandomData",
  "label": "Random String",
  "settings": {
    "type": "RandomData",
    "data_type": "String",
    "string_length": 32,
    "string_charset": "hex",
    "output_var": "RANDOM_TOKEN"
  }
}

Plugin

Load and execute custom plugin blocks.

Settings

plugin_block_type · string · required

Name of the plugin block type to execute

settings_json · string · default: "{}"

JSON settings for the plugin (as string)

output_var · string · default: "PLUGIN_RESULT"

Variable name to store plugin output

capture · boolean · default: "false"

Capture as user-visible variable

Example

{
  "block_type": "Plugin",
  "label": "Custom Plugin",
  "settings": {
    "type": "Plugin",
    "plugin_block_type": "MyCustomBlock",
    "settings_json": "{\"param1\":\"value1\"}",
    "output_var": "PLUGIN_OUTPUT"
  }
}

Constants

Define constant values used throughout the pipeline.

Settings

constants · array · required

Array of constant entries with name and value

Example

{
  "block_type": "Constants",
  "label": "Define Constants",
  "settings": {
    "type": "Constants",
    "constants": [
      {"name": "API_URL", "value": "https://api.example.com"},
      {"name": "API_VERSION", "value": "v2"}
    ]
  }
}

Dictionary

Perform key-value storage operations.

Settings

operation · DictOp · required

Dictionary operation:

• Get - Get value by key
• Set - Set key-value pair
• Remove - Remove key
• Exists - Check if key exists
• Keys - Get all keys
• Values - Get all values

dict_var · string · default: "DICT"

Variable containing dictionary

key · string

Dictionary key

value · string

Value to set (for Set operation)

output_var · string · default: "RESULT"

Variable name to store result

capture · boolean · default: "false"

Capture as user-visible variable

GenerateGUID

Generate UUID/GUID values.

Settings

guid_version · GUIDVersion · default: "V4"

UUID version:

• V1 - Time-based
• V4 - Random
• V5 - Name-based (SHA-1)

namespace · string

Namespace UUID (for V5)

name · string

Name string (for V5)

output_var · string · default: "GUID"

Variable name to store UUID

capture · boolean · default: "false"

Capture as user-visible variable

Example

{
  "block_type": "GenerateGUID",
  "label": "Generate UUID",
  "settings": {
    "type": "GenerateGUID",
    "guid_version": "V4",
    "output_var": "REQUEST_ID"
  }
}

PhoneCountry

Extract country information from phone numbers.

Settings

input_var · string · required

Variable containing phone number

output_var · string · default: "COUNTRY"

Variable name to store result

output_format · PhoneOutputFormat · default: "CountryCode"

Output format:

• CountryCode - Numeric code (e.g., “1”)
• CountryName - Full name (e.g., “United States”)
• ISO2 - 2-letter code (e.g., “US”)
• ISO3 - 3-letter code (e.g., “USA”)

capture · boolean · default: "false"

Capture as user-visible variable

Example

{
  "block_type": "PhoneCountry",
  "label": "Detect Country",
  "settings": {
    "type": "PhoneCountry",
    "input_var": "input.PHONE",
    "output_format": "ISO2",
    "output_var": "COUNTRY_CODE",
    "capture": true
  }
}