Bright Data Agent Toolkit

CLI, catalog, and agent skills for Bright Data scrapers and APIs — optimized for Codex, Claude, and Hermes.

Install CLI

cd cli/brightdata
go install ./cmd/brightdata-pp-cli/
export BRIGHT_DATA_API_TOKEN="your-key"   # https://brightdata.com/cp/setting/users
brightdata-pp-cli doctor

Catalog

Machine-readable library indexed from Bright Data docs:

File	Contents
catalog/brightdata-library.json	Merged catalog (805 entries)
catalog/scrapers.json	Scraper API doc pages (172)
catalog/apis.json	Core REST endpoints (10)

Sources: https://docs.brightdata.com/llms.txt, https://docs.brightdata.com/api-reference/, https://brightdata.com/pricing

Browse offline: brightdata-pp-cli catalog --query amazon

Key CLI commands

brightdata-pp-cli which "scrape linkedin profiles"
brightdata-pp-cli datasets list
brightdata-pp-cli datasets trigger --dataset-id ID --input '[...]'
brightdata-pp-cli workflow scrape-and-wait --dataset-id ID --input-file urls.json
brightdata-pp-cli unlock --url https://example.com
brightdata-pp-cli serp --query "search terms"
brightdata-pp-cli collector trigger --collector-id ID

Agent skills

Platform	Path
Repo (canonical)	skills/brightdata/SKILL.md
Printing Press	cli/brightdata/SKILL.md
Codex	~/.codex/skills/brightdata/SKILL.md (symlink or copy)
Claude / Cursor	~/.claude/skills/brightdata/SKILL.md
Hermes	~/hermes-super-agent/vault/skills/active/brightdata/SKILL.md

Auth

• BRIGHT_DATA_API_TOKEN — required API key (never commit)
• BRIGHT_DATA_UNLOCKER_ZONE — Web Unlocker zone
• BRIGHT_DATA_SERP_ZONE — SERP API zone

License

Apache-2.0