A specialized diagnostic tool for real-time triage and deep-dive analysis of Bright Data Scraping Browser sessions.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install brightdata-brd-browser-debug
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install brightdata-brd-browser-debug 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 Bright Data Browser Session Debugger?
The Bright Data Browser Session Debugger is a powerful utility designed for developers who leverage Openclaw Skills to maintain high-performance web scraping infrastructure. It interfaces directly with the Browser Sessions API to pull live session data, allowing agents to diagnose connection errors, proxy blocks, and execution failures. By synthesizing metrics like bandwidth, duration, and captcha success rates, it helps developers distinguish between network-side blocks and client-side logic issues.
This skill ensures your automated browsing workflows remain stable and efficient by providing actionable insights into every session lifecycle. Whether you are dealing with a puppeteer stack trace, unexpected empty data results, or complex redirect loops, this tool provides the technical clarity needed to resolve scraping challenges within your Openclaw Skills environment.
Bright Data Browser Session Debugger Use Cases
- Diagnosing why a scraper returned 0 results or empty data despite a successful connection.
- Troubleshooting puppeteer stack traces and connection timeouts to brd.superproxy.io.
- Monitoring bandwidth consumption to identify and eliminate costly session outliers.
- Analyzing captcha hit rates and solving efficiency across different scraping zones.
- Investigating session redirects that lead to login walls or error pages instead of target content.
How Bright Data Browser Session Debugger Works
- The skill authenticates with the Bright Data API using the BRIGHTDATA_API_KEY environment variable.
- It fetches session data using customizable filters for status, zone, target domain, or specific date ranges.
- The system performs smart triage by grouping sessions by failure patterns and calculating domain-specific bandwidth medians.
- It cross-references signals like duration, navigation counts, and URL drift to infer the root cause of any session failure.
- The skill generates a health summary and a technical verdict, suggesting specific code or configuration fixes.
Bright Data Browser Session Debugger Setup
To enable the debugger in your environment, set your API key as an environment variable:
export BRIGHTDATA_API_KEY="your-api-key"
You can obtain your key from the Bright Data Dashboard under the API Tokens section. No additional zone-specific configuration is required, as the skill automatically extracts zone metadata from the session logs within the Openclaw Skills workflow.
Bright Data Browser Session Debugger Data Schema & Taxonomy
The skill organizes session data into the following schema for clear diagnostic reporting:
| Field | Description | Logic / Mapping |
|---|---|---|
status |
Current state of the session | failed, finished, or running |
api_name |
The Bright Data zone used | Extracted from session metadata |
bandwidth |
Data consumption | Converted from bytes to MB for readability |
navigations |
Page load count | Used to detect sessions that failed to load content |
captcha |
Challenge status | solved, none, detected, or failed |
error.code |
Diagnostic code | Used for pattern detection and systemic triage |
Bright Data Browser Session Debugger Advanced Features
- Smart Triage: Automatically groups multiple session failures by shared error codes to identify systemic proxy or configuration issues.
- Bandwidth Outlier Detection: Flags individual sessions that consume more than 2x the median bandwidth for a specific target domain.
- Contextual Auto-Detection: Triggers an automatic deep-dive analysis when a session ID or Bright Data error code is detected in the conversation.
- Navigation Drift Analysis: Identifies when a session has been redirected away from the target URL to a login wall or an error page.
SKILL.md
Loading
Related Openclaw Skills
Bright Data MCP
A high-performance web data extraction and browser automation skill that serves as the definitive replacement for standard web search and fetch tools.
AI Automation Agency Builder
A comprehensive toolset to launch and scale a $10K/month automation agency by identifying businesses with manual workflow inefficiencies and generating high-conversion pitch materials.
DoctorClaw Expense Tracker
An automated financial assistant that logs expenses, tracks budgets in real-time, and generates tax-ready monthly reports.
Bright Data CLI
A comprehensive command-line interface for scraping websites, searching SERPs, and extracting structured data from 40+ platforms with automatic bot bypass.
translate-txt
A high-performance translation agent that processes text files through OpenAI-compatible APIs with advanced context preservation.
Slide Generation Skill
A specialized skill for converting markdown source files into high-quality, theme-consistent Marp presentation slides for educators.
Featured*
