brd-browser-debug

Diagnose Bright Data browser sessions using Browser Sessions API data.

245|35|Updated Jan 28, 2026
One-click install
npx skills add https://github.com/brightdata/skills --skill brd-browser-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brd-browser-debug
Source: https://github.com/brightdata/skills/tree/main/skills/brd-browser-debug
Command: npx skills add https://github.com/brightdata/skills --skill brd-browser-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose Bright Data browser sessions to identify why a session failed, where performance drops occur, or where unexpected results arise, by interpreting live Browser Sessions API data.

Core Features & Use Cases

  • Smart triage of browser sessions: group failures, highlight the most recent session, and surface root causes.
  • Bandwidth analysis and pattern detection: compute medians per domain and flag outliers; detect repeated error codes.
  • Captcha reporting and flow insights: report captcha hits and solve rates, and suggest enabling captcha solving on zone.
  • Zero-config operation: reads BRIGHTDATA_API_KEY from environment, no zone setup.
  • Use case: Real-time debugging of scraping sessions to rapidly identify whether issues are client-side or proxy-related.

Quick Start

Invoke brd-browser-debug to fetch and triage your most recent Bright Data browser sessions.

Frequently Asked Questions about brd-browser-debug

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose a failed Bright Data browser session?

Debug Puppeteer browser sessions by fetching and triaging recent Bright Data browser sessions to identify performance drops, captchas, or unexpected results. It uses structured signals from the Browser Sessions API to provide actionable triage insights.

Why am I getting captchas in my scraping sessions and how do I fix it?

Captcha issues in scraping sessions are reported by analyzing captcha hits and solve rates from session data. The tool suggests enabling captcha solving on your zone to address repeated captcha encounters during browser sessions.

Do I need a Bright Data API key to debug browser sessions?

You need a Bright Data API key to debug browser sessions, which the tool reads directly from the BRIGHTDATA_API_KEY environment variable. Zero-config operation requires no additional zone setup to start diagnosing sessions.

What's the best way to analyze bandwidth issues across browser sessions?

Analyze bandwidth issues by computing medians per domain and flagging outliers to detect performance drops across browser sessions. This pattern detection approach identifies repeated error codes and bandwidth anomalies in recent sessions.

Does this browser session debugger require any zone setup or dependencies?

The browser session debugger requires no zone setup and has zero dependencies. It operates with zero-config by reading the BRIGHTDATA_API_KEY from your environment to fetch and triage recent Bright Data browser sessions.