Skip to content
Back to search

brightdata-plugins

SkillGitHubIncomplete

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/brightdata--skills/badge.svg)](/listings/brightdata--skills)

HTML

<a href="/listings/brightdata--skills"><img src="/api/listings/brightdata--skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Get Your Credentials

1. Sign up at [brightdata.com](https://brightdata.com) if you haven't already 2. Go to the [Bright Data Dashboard](https://brightdata.com/cp) 3. Create a **Web Unlocker zone**: Click "Add" → Select "Unlocker zone" 4. Copy your **API Key** from the dashboard

2. Set Environment Variables

export BRIGHTDATA_API_KEY="your-api-key"
export BRIGHTDATA_UNLOCKER_ZONE="your-zone-name"

3. Start Using

# Search Google
bash skills/search/scripts/search.sh "artificial intelligence trends"

# Scrape a webpage
bash skills/scrape/scripts/scrape.sh "https://example.com/article"

# Get structured data (Bright Data CLI): find a scraper, then run it
bdata pipelines search "<site or data type>"
bdata pipelines run <dataset_id> <method> "<url>"

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 108 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <img src="https://brightdata.com/wp-content/themes/brightdata/assets/images/favicon.png" alt="Bright Data" width="80" height="80">
  3. </p>
  4. <h1 align="center">Bright Data Skills</h1>
  5. <p align="center">
  6. <strong>Teach any coding agent to get web data: scrape, fetch, search, browse, and watch the bill</strong>
  7. </p>
  8. <p align="center">
  9. <a href="https://brightdata.com"><img src="https://img.shields.io/badge/Powered%20by-Bright%20Data-3D7FFC?style=for-the-badge" alt="Powered by Bright Data"></a>
  10. <a href="#license"><img src="https://img.shields.io/badge/License-MIT-10b981?style=for-the-badge" alt="MIT License"></a>
  11. <a href="#the-skills"><img src="https://img.shields.io/badge/Skills-11-9D97F4?style=for-the-badge" alt="11 Skills"></a>
  12. </p>
  13. <p align="center">
  14. <a href="#quick-start">Quick Start</a> •
  15. <a href="#the-skills">Skills</a> •
  16. <a href="#agent-onboarding">Agent Onboarding</a> •
  17. <a href="#scrape">Scrape</a> •
  18. <a href="#datasets">Datasets</a> •
  19. <a href="#fetch">Fetch</a> •
  20. <a href="#search">Search</a> •
  21. <a href="#browser">Browser</a> •
  22. <a href="#billing">Billing</a> •
  23. <a href="#the-interface-guides">CLI, MCP, SDK</a>
  24. </p>
  25. ---
  26. ## Overview
  27. A skill is a folder with a SKILL.md and, where needed, reference files and scripts. Any agent that reads SKILL.md files can use these: Claude Code, Codex, Cursor, and others. Nothing here is tied to one agent.
  28. With the skills installed, an agent can:
  29. - **Scrape any site for structured data** with ready scrapers, or build a new scraper in Scraper Studio when none fits
  30. - **Find a ready dataset** when the data is already collected, and hand the purchase to a person instead of scraping it
  31. - **Fetch a blocked page** through Web Unlocker as markdown, HTML, or a screenshot
  32. - **Search Google and other engines** and get structured JSON, including the AI answer engines
  33. - **Drive a cloud browser** with the user's own Playwright, Puppeteer, or Selenium code
  34. - **Check balance and costs** before and after every job
  35. - **Pick the right surface** for the task: CLI for the terminal, MCP for agents that decide at run time, SDK for code the user keeps
  36. ## Quick Start
  37. Add the skills to your project, for any coding agent (needs Node.js and git):
  38. ```
  39. npx -y skills add brightdata/skills -y
  40. ```
  41. For one skill, add `--skill <name>`, for example `--skill scrape`. In Windows PowerShell, use `npx.cmd` if scripts are blocked. No Node? Clone this repo and copy the folders under `skills/` into the folder where your agent reads skills (many agents use `.agents/skills`).
  42. Then start with `agent-onboarding`: it installs the Bright Data CLI (needs Node.js 20 or later) and logs in once. The user approves in a browser, on this machine or any other device, and the key never touches the chat. Without Node it falls back to the REST API with `BRIGHTDATA_API_KEY`.
  43. ## The Skills
  44. | Skill | What it does |
  45. |-------|-------------|
  46. | [`agent-onboarding`](skills/agent-onboarding/SKILL.md) | Start here. Installs the CLI and the skills, logs in once, and routes every ask to the right skill |
  47. | [`scrape`](skills/scrape/SKILL.md) | Structured data from any site: ready scrapers, Scraper Studio, and scripts that look scrapers up in the catalogue |
  48. | [`instagram`](skills/instagram/SKILL.md) | Instagram profiles, posts, reels and comments as JSON, by URL or for an account's recent posts |
  49. | [`datasets`](skills/datasets/SKILL.md) | Check whether the Dataset Marketplace already sells the data, and route the purchase to a person |
  50. | [`fetch`](skills/fetch/SKILL.md) | One URL in, unblocked page out: markdown, HTML, or a screenshot |
  51. | [`search`](skills/search/SKILL.md) | Anything that starts from a query: SERP API, Google verticals, the top-100 job, answer engines |
  52. | [`browser`](skills/browser/SKILL.md) | Point Playwright, Puppeteer, or Selenium code at the cloud browser |
  53. | [`billing`](skills/billing/SKILL.md) | Balance, charges, and what a job will cost |
  54. | [`brightdata-cli`](skills/brightdata-cli/SKILL.md) | The bdata command line |
  55. | [`brightdata-mcp`](skills/brightdata-mcp/SKILL.md) | The MCP server, for agents that decide at run time |
  56. | [`brightdata-sdk`](skills/brightdata-sdk/SKILL.md) | The Python and Node.js SDKs, for code the user keeps |
  57. ## Agent Onboarding
  58. The entry point. It installs everything, handles the one-time login without ever pasting a key into chat, registers an account by email when the user has none, fixes the common Windows and PATH problems, and routes the task to the right skill. The other ten assume it ran once.
  59. ## Scrape
  60. Structured data from any site. The skill checks what already exists before spending anything: a bundled top-25 table costs zero calls, and one free call searches the live scraper catalogue. When a ready scraper fits, it runs it. When none fits, Scraper Studio builds one from a plain-language prompt, heals it when the site changes, and runs single URLs synchronously or whole URL lists as one batch.
  61. ## Datasets
  62. Not scraping. When the data is already collected and sold as a download, a huge generic corpus, needed once, where a few months old is fine, the agent checks coverage with free reads (plus, for an id the catalogue does not list, one probe that can start a billed job) and hands the purchase to a person in the control panel.
  63. ## Fetch
  64. One URL in, unblocked page out through Web Unlocker: markdown for reading, HTML for parsing, or a screenshot, with `bdata scrape`.
  65. ## Search
  66. Anything that starts from a query. SERP API for structured results (web, news, images and shopping tabs), the Google verticals with a scraper of their own (Maps, Shopping, Flights, Hotels, Images), the top-100 job for deep rank tracking in one request, and the AI answer engines (ChatGPT, Perplexity, Gemini, Google AI Mode) with their verified dataset ids.
  67. ## Browser
  68. For the user's own browser automation code. The skill hands Playwright, Puppeteer, or Selenium the right connect string for the cloud browser, which does the unblocking, and explains the errors that only show up in cloud sessions.
  69. ## Billing
  70. Balance, charges by product and by zone, and what a job will cost before it runs. REST first; the reference marks which facts were checked against the live cost APIs.
  71. ## The Interface Guides
  72. Three thin skills answer "which door do I use": [`brightdata-cli`](skills/brightdata-cli/SKILL.md) for one-off checks typed at a shell, [`brightdata-mcp`](skills/brightdata-mcp/SKILL.md) for AI apps that pick tools at run time, and [`brightdata-sdk`](skills/brightdata-sdk/SKILL.md) for code the user keeps and schedules.
  73. ## License
  74. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.