TL;DR

Bright Data의 공식 TypeScript CLI로 Node ≥20 환경에서 브라우저 제어, 페이지 스크레이핑, SERP 검색, 플랫폼별 데이터 파이프라인, AI 기반 스크레이퍼 생성·치유 기능을 터미널에서 바로 사용할 수 있습니다. 설치는 npm 전역 설치 또는 제공된 설치 스크립트로 가능하고 npx로 비설치 실행도 지원합니다. 신규 계정에 매월 5,000 무료 크레딧이 제공되며 대부분의 CLI 명령이 1 크레딧/요청으로 청구되지만 Browser API와 프록시 제품은 무료 크레딧에 포함되지 않으므로 도입 전 비용 항목을 확인해야 합니다.

핵심 포인트

• Bright Data CLI는 npm 패키지(@brightdata/cli)로 제공되는 TypeScript 기반 명령줄 도구이며 Node.js 20 이상을 요구합니다. 설치하면 brightdata (별칭 bdata) 명령이 추가되어 Bright Data의 다양한 API(스크레이프, SERP, Scraper Studio, Browser 등)를 터미널에서 직접 호출할 수 있습니다. GitHub 메타데이터상 스타 1,298개와 포크 38개로 공개 사용자 기반이 확인됩니다.
• 주요 기능은 원격 API 호출을 감싼 일련의 서브커맨드로 구현되어 있으며 각 명령은 입력(예: URL 또는 쿼리)→요청 전송→폴링 또는 즉시 응답의 흐름을 따릅니다. 예를 들어 scrape은 Web Unlocker로 CAPTCHA와 JS 렌더링, anti-bot을 우회해 페이지를 가져오고, scraper create/run/heal은 AI 기반 생성·실행·자체수정 플로우를 트리거해서 collector_id와 view_url을 반환하는 JSON 앵벌로를 출력합니다. 이런 구조 덕분에 파이프라인(jq·xargs)이나 자동화 스크립트에서 stdout/파일(-o)과 --json/--pretty 플래그로 결과를 연동하기 쉽습니다.
• 요금·인증·제한 관련 구현 세부가 README에 명확히 적혀 있어 도입 전 비용 제어가 가능합니다. 신규 계정에는 매월 5,000 무료 크레딧(약 $7.50)이 자동으로 부여되고 주요 CLI 명령들(scrape, search, pipelines, scraper create/run/heal)은 보통 1 크레딧/요청으로 청구되며 Browser API와 프록시 제품들은 무료 크레딧에 포함되지 않습니다. scraper create/heal의 AI-Flow는 계정당 동시 생성 상한(현재 3)을 두고 있으며 CLI는 지수적 백오프+지터로 기본 최대 재시도 4회를 수행해 429 에러를 다루는 방식이 문서에 기술되어 있습니다.
• 로컬 통합과 개발자 친화성 측면에서 실무에 바로 쓸 수 있는 편의성이 많고, 비설치(npx) 실행과 플랫폼별 설치 스크립트(curl | sh, npm -g)가 제공됩니다. 브라우저 서브커맨드는 가벼운 로컬 데몬을 띄워 세션을 유지하고 snapshot/get text/get html/interaction(ref 기반 click/type 등) API로 에이전트 워크플로에서 토큰 효율적인 페이지 표현을 반환하도록 설계되어 있습니다. 또한 add mcp 명령으로 Claude Code, Cursor, Codex 같은 에이전트 구성에 MCP 서버 항목을 자동으로 삽입해 에이전트 통합을 간소화합니다.