跳到主内容
智客 ZICQ

技能库 智客分类:媒体内容 brightdata-cli

Brightdata Cli

使用Bright Data CLI( " Brightdata " / " bdata " )来刮去网站、搜索网站、从40+平台提取结构化数据、管理代理区并检查账户预算的指南。 当用户想要刮取一个URL,搜索Google/Bing/Yandex,从Amazon/LinkedIn/Instagram/TikTok/YouTube/Reddit或任何其他平台取取出数据,检查他们的亮度数据平衡或区域,或做任何涉及从终端收集网络数据的事情时,使用这一技能. 当用户提到亮数据,bdata,网络刮取CLI,SERP API,或想将亮数据技能安装到他们的编码代理时,也会触发.

1919 安装量

官方网址:skills.sh

技能介绍

先看中文介绍;官方 description 原文单独保留,不改写 SKILL.md。

做什么

使用Bright Data CLI( " Brightdata " / " bdata " )来刮去网站、搜索网站、从40+平台提取结构化数据、管理代理区并检查账户预算的指南。 当用户想要刮取一个URL,搜索Google/Bing/Yandex,从Amazon/LinkedIn/Instagram/TikTok/YouTube/Reddit或任何其他平台取取出数据,检查他们的亮度数据平衡或区域,或做任何涉及从终端收集网络数据的事情时,使用这一技能. 当用户提到亮数据,bdata,网络刮取CLI,SERP API,或想将亮数据技能安装到他们的编码代理时,也会触发.

何时用

官方 description 未单独写出 Use when。按规范,代理会在用户任务与这段 description 的关键词匹配时激活本技能。

代理如何加载

按 Agent Skills 渐进披露:启动时只加载 name 与 description(约 100 token);任务匹配后才读入整份 SKILL.md 正文;scripts/、references/、assets/ 仅在需要时再读。 本文件正文结构:Bright Data CLI、Installation、First-Time Setup、One-time login — opens the browser for OAuth, then everything is automatic、Command Reference、Quick Command Overview。

文件分析

文件分析:除 SKILL.md 外,正文引用了 references/commands.md、references/pipelines.md,属于带资源的技能包,这些文件按需再读。

官方 description(原文)

Guide for using the Bright Data CLI (`brightdata` / `bdata`) to scrape websites, search the web, extract structured data from 40+ platforms, manage proxy zones, and check account budget. Use this skill whenever the user wants to scrape a URL, search Google/Bing/Yandex, extract data from Amazon/LinkedIn/Instagram/TikTok/YouTube/Reddit or any other platform, check their Bright Data balance or zones, or do anything involving web data collection from the terminal. Also trigger when the user mentions brightdata, bdata, web scraping CLI, SERP API, or wants to install Bright Data skills into their coding agent.

Bright Data CLIInstallationFirst-Time SetupOne-time login — opens the browser for OAuth, then everything is automaticCommand ReferenceQuick Command OverviewHow to Use Each CommandScrapingDefault: returns clean markdownGet raw HTMLGet structured JSONTake a screenshot

来源分类:skills.sh agent-skill

SKILL.md 与 Agent 调用

官方规范 ↗
name
brightdata-cli
description
Guide for using the Bright Data CLI (`brightdata` / `bdata`) to scrape websites, search the web, extract structured data from 40+ platforms, manage proxy zones, and check account budget. Use this skill whenever the user wants to scrape a URL, search Google/Bing/Yandex, extract data from Amazon/LinkedIn/Instagram/TikTok/YouTube/Reddit or any other platform, check their Bright Data balance or zones, or do anything involving web data collection from the terminal. Also trigger when the user mentions brightdata, bdata, web scraping CLI, SERP API, or wants to install Bright Data skills into their coding agent.
  1. 发现技能客户端向 Agent 提供名称与描述目录。
  2. 匹配与调用用户指定或任务匹配后,载入 SKILL.md 指令。
  3. 按需加载按步骤读取参考文档、使用脚本与素材。
指令中引用的文件 · 2
  • references/commands.md
  • references/pipelines.md

以下路径提取自原文;文件是否齐全请以来源仓库中的完整目录为准。

具体调用语法与可用工具以目标 Agent 客户端为准。 查看调用机制说明 ↗

安装这个技能

Skills CLI ↗

先选择目标 Agent 和安装范围,保留技能包的附属文件,安装后检查客户端能否发现该技能。

该技能引用了附属文件,请从来源获取完整目录;仅复制 SKILL.md 可能缺少依赖。

交给 Agent 安装

复制安装指令给支持 Agent Skills 的代理,确认其中的目标目录与客户端匹配。

把 Agent Skill「brightdata-cli」安装到我的项目:SKILL.md 原文与官方 description 见 https://zicq.com/zh/skills/skl-269b57204715b061-%E4%BA%AE%E6%95%B0%E6%8D%AE-Cli.html
请存为 .cursor/skills/brightdata-cli/SKILL.md 或 .claude/skills/brightdata-cli/SKILL.md,frontmatter 的 name 与 description 保持原样,不要改写。
该技能还带 scripts/、references/、assets/ 等文件,请从 https://github.com/brightdata/skills 取完整目录,不要只建一个 SKILL.md。

GitHub 完整包 ↗

终端安装 · Skills CLI

需要 Node.js 与 npx。先查看仓库技能列表,确认实际名称。

npx skills add 'https://github.com/brightdata/skills' --list

npx skills add 'https://github.com/brightdata/skills' --skill 'brightdata-cli'

CLI 会交互选择目标 Agent,默认安装到项目;用户级安装使用 -g。先通过查看命令核对仓库内容,再用 npx skills list 检查已安装技能。

阅读排版
--- name: brightdata-cli description: Guide for using the Bright Data CLI (`brightdata` / `bdata`) to scrape websites, search the web, extract structured data from 40+ platforms, manage proxy zones, and check account budget. Use this skill whenever the user wants to scrape a URL, search Google/Bing/Yandex, extract data from Amazon/LinkedIn/Instagram/TikTok/YouTube/Reddit or any other platform, check their Bright Data balance or zones, or do anything involving web data collection from the terminal. Also trigger when the user mentions brightdata, bdata, web scraping CLI, SERP API, or wants to install Bright Data skills into their coding agent. --- # Bright Data CLI The Bright Data CLI (`brightdata` or `bdata`) gives you full access to Bright Data's web data platform from the terminal. It handles authentication, proxy zones, anti-bot bypass, CAPTCHA solving, and JavaScript rendering automatically — the user just needs to log in once. ## Installation If the CLI is not installed yet, guide the user: **macOS / Linux:** ```bash curl -fsSL https://cli.brightdata.com/install.sh | bash ``` **Windows or manual install (any platform):** ```bash npm install -g @brightdata/cli ``` **Without installing (one-off usage):** ```bash npx --yes --package @brightdata/cli brightdata ``` Requires Node.js >= 20. After install, both `brightdata` and `bdata` (shorthand) are available. ## First-Time Setup Before anything else, check if the user is authenticated. If they haven't logged in yet, guide them through the one-time setup: ```bash # One-time login — opens the browser for OAuth, then everything is automatic bdata login ``` This single command: 1. Opens the browser for secure OAuth authentication 2. Saves the API key locally (never needs to be entered again) 3. Auto-creates required proxy zones (`cli_unlocker`, `cli_browser`) 4. Sets default configuration After login, every subsequent command works without any manual intervention. For headless/SSH environments where no browser is available: ```bash bdata login --device ``` For direct API key authentication (non-interactive): ```bash bdata login --api-key ``` To verify setup is complete, run: ```bash bdata config ``` ## Command Reference Read [references/commands.md](references/commands.md) for the full command reference with all flags, options, and examples for every command. Read [references/pipelines.md](references/pipelines.md) for the complete list of 40+ pipeline types (Amazon, LinkedIn, Instagram, TikTok, YouTube, Reddit, and more) with their specific parameters. ## Quick Command Overview `bdata` is the shorthand for `brightdata`. Both work identically. | Command | Purpose | |---------|---------| | `bdata scrape ` | Scrape any URL as markdown, HTML, JSON, or screenshot | | `bdata search ""` | Search Google/Bing/Yandex with structured results | | `bdata pipelines [params]` | Extract structured data from 40+ platforms | | `bdata pipelines list` | List all 40+ available pipeline types | | `bdata status ` | Check async job status | | `bdata zones` | List proxy zones | | `bdata budget` | View account balance and costs | | `bdata skill add` | Install AI agent skills | | `bdata skill list` | List available skills | | `bdata config` | View/set configuration | | `bdata login` | Authenticate with Bright Data | | `bdata version` | Show CLI version and system info | ## How to Use Each Command ### Scraping Scrape any URL with automatic bot bypass, CAPTCHA handling, and JS rendering: ```bash # Default: returns clean markdown bdata scrape https://example.com # Get raw HTML bdata scrape https://example.com -f html # Get structured JSON bdata scrape https://example.com -f json # Take a screenshot bdata scrape https://example.com -f screenshot -o page.png # Geo-targeted scrape from the US bdata scrape https://amazon.com --country us # Save to file bdata scrape https://example.com -o page.md # Async mode for heavy pages bdata scrape https://example.com --async ``` ### Searching Search engines with structured JSON output (Google returns parsed organic results, ads, People Also Ask, and related searches): ```bash # Google search with formatted table bdata search "web scraping best practices" # Get raw JSON for piping bdata search "typescript tutorials" --json # Search Bing bdata search "bright data pricing" --engine bing # Localized search bdata search "restaurants berlin" --country de --language de # News search bdata search "AI regulation" --type news # Extract just URLs bdata search "open source tools" --json | jq -r '.organic[].link' ``` ### Pipelines (Structured Data Extraction) Extract structured data from 40+ platforms. These trigger async jobs that poll until results are ready: ```bash # LinkedIn profile bdata pipelines linkedin_person_profile "https://linkedin.com/in/username" # Amazon product bdata pipelines amazon_product "https://amazon.com/dp/B09V3KXJPB" # Instagram profile bdata pipelines instagram_profiles "https://instagram.com/username" # Amazon search bdata pipelines amazon_product_search "laptop" "https://amazon.com" # YouTube comments (top 50) bdata pipelines youtube_comments "https://youtube.com/watch?v=..." 50 # Google Maps reviews (last 7 days) bdata pipelines google_maps_reviews "https://maps.google.com/..." 7 # Output as CSV bdata pipelines amazon_product "https://amazon.com/dp/..." --format csv -o product.csv # List all available pipeline types bdata pipelines list ``` ### Checking Status For async jobs (from `--async` scrapes or pipelines): ```bash # Quick status check bdata status # Wait until complete bdata status --wait # With custom timeout bdata status --wait --timeout 300 ``` ### Budget & Zones ```bash # Quick account balance bdata budget # Detailed balance with pending charges bdata budget balance # All zones cost/bandwidth bdata budget zones # Specific zone costs bdata budget zone my_zone # Date range filter bdata budget zones --from 2024-01-01T00:00:00 --to 2024-02-01T00:00:00 # List all zones bdata zones # Zone details bdata zones info cli_unlocker ``` ### Configuration ```bash # View all config bdata config # Set defaults bdata config set default_zone_unlocker my_zone bdata config set default_format json ``` ### Installing AI Agent Skills ```bash # Interactive picker — choose skills and target agents bdata skill add # Install a specific skill bdata skill add scrape # List available skills bdata skill list ``` ## Output Modes Every command supports multiple output formats: | Flag | Effect | |------|--------| | *(none)* | Human-readable formatted output with colors | | `--json` | Compact JSON to stdout | | `--pretty` | Indented JSON to stdout | | `-o ` | Write to file (format auto-detected from extension) | When piped (stdout is not a TTY), colors and spinners are automatically disabled. ## Chaining Commands The CLI is pipe-friendly: ```bash # Search → extract first URL → scrape it bdata search "top open source projects" --json \ | jq -r '.organic[0].link' \ | xargs bdata scrape # Scrape and view with markdown reader bdata scrape https://docs.github.com | glow - # Amazon product data to CSV bdata pipelines amazon_product "https://amazon.com/dp/xxx" --format csv > product.csv ``` ## Environment Variables These override stored configuration: | Variable | Purpose | |----------|---------| | `BRIGHTDATA_API_KEY` | API key (skips login entirely) | | `BRIGHTDATA_UNLOCKER_ZONE` | Default Web Unlocker zone | | `BRIGHTDATA_SERP_ZONE` | Default SERP zone | | `BRIGHTDATA_POLLING_TIMEOUT` | Polling timeout in seconds | ## Troubleshooting | Error | Fix | |-------|-----| | CLI not found | Install with `npm i -g @brightdata/cli` or `curl -fsSL https://cli.brightdata.com/install.sh \| bash` | | "No Web Unlocker zone specified" | `bdata config set default_zone_unlocker ` or re-run `bdata login` | | "Invalid or expired API key" | `bdata login` | | "Access denied" | Check zone permissions in the Bright Data control panel | | "Rate limit exceeded" | Wait and retry, or use `--async` for large jobs | | Async job timeout | Increase with `--timeout 1200` or `BRIGHTDATA_POLLING_TIMEOUT=1200` | ## Key Design Principles - **One-time auth**: After `bdata login`, everything is automatic. No tokens to manage, no keys to pass. - **Zones auto-created**: Login creates `cli_unlocker` and `cli_browser` zones automatically. - **Smart defaults**: Markdown output, auto-detected formats from file extensions, colors only in TTY. - **Pipe-friendly**: JSON output + jq for automation. Colors/spinners disabled in pipes. - **Async support**: Heavy jobs can run in background with `--async` + `status --wait`. - **npm package**: `@brightdata/cli` — install globally or use via `npx`.

相关技能

媒体内容

Nano Banana Pro

以纳米·香蕉Pro(Gemini 3 Pro Image)来生成/编辑图像. 用于创建/修改请求,包括编辑。 支持文本到图像+图像到图像; 1K/2K/4K; 使用 -- input-image.

媒体内容

Youtube Watcher

从YouTube视频中获取并读取文字记录. 需要汇总视频时使用,回答有关视频内容的问题,或者从中提取信息.

媒体内容

Atxp

Access ATXP支付API工具用于网页搜索,AI图像生成,音乐创建,视频生成,X/Twitter搜索,电子邮件,代理账户管理. 当用户需要实时网络搜索时使用,AI生成的媒体(图像,音乐,视频),X/Twitter搜索,发送/接收电子邮件,或创建和资助代理账户. 需要通过“ …

媒体内容

Youtube

YouTube Data API与管理的OAuth的集成. 搜索视频,管理播放列表,访问频道数据,并与评论互动. 用户想与YouTube互动时使用此技能. 对于其他第三方应用,使用api-gateway技能(https://clawhub.ai/byungkyu/api-gate…