CONNECT APP
Build with Bright Data
All in One Platform for Proxies and Web Scraping
Data Analytics
- API key
MCP
Give your agent Bright Data tools
Every Bright Data action is exposed as an MCP tool on Pipedream's remote server. Point a client at it with your end user's ID and Connect resolves that user's Bright Data account for each tool call — you store no tokens.
// accessToken: mint a short-lived token with the Connect SDK — see the MCP guide
const transport = new StreamableHTTPClientTransport(
new URL("https://remote.mcp.pipedream.net/v3"),
{
requestInit: {
headers: {
Authorization: `Bearer ${accessToken}`,
"x-pd-project-id": "{project_id}",
"x-pd-environment": "production",
"x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
"x-pd-app-slug": "bright_data",
},
},
},
)
const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)
const { tools } = await mcp.listTools()
// e.g. run List Dataset ID Options:
const result = await mcp.callTool({
name: "bright_data-list-dataset-id-options",
arguments: {},
})# access_token: mint a short-lived token with the Connect SDK — see the MCP guide
headers = {
"Authorization": f"Bearer {access_token}",
"x-pd-project-id": "{project_id}",
"x-pd-environment": "production",
"x-pd-external-user-id": "{external_user_id}", # any stable ID for this user in your system
"x-pd-app-slug": "bright_data",
}
async with streamablehttp_client("https://remote.mcp.pipedream.net/v3", headers=headers) as (read, write, _):
async with ClientSession(read, write) as session:
await session.initialize()
tools = await session.list_tools()
# e.g. run List Dataset ID Options:
result = await session.call_tool("bright_data-list-dataset-id-options", {})SDK
Run Bright Data actions from your backend
Connect a user's Bright Data account once, then run List Dataset ID Options on their behalf from your own code — TypeScript, Python, or plain HTTP.
import { PipedreamClient } from "@pipedream/sdk"
const pd = new PipedreamClient({
projectId: process.env.PIPEDREAM_PROJECT_ID!,
clientId: process.env.PIPEDREAM_CLIENT_ID!,
clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
projectEnvironment: "production",
})
const result = await pd.actions.run({
id: "bright_data-list-dataset-id-options",
externalUserId: "{external_user_id}", // any stable ID for this user in your system
configuredProps: {
bright_data: { authProvisionId: "apn_xxxxxxx" },
},
})from pipedream import Pipedream
pd = Pipedream(
client_id="{oauth_client_id}",
client_secret="{oauth_client_secret}",
project_id="{project_id}",
project_environment="production",
)
result = pd.actions.run(
id="bright_data-list-dataset-id-options",
external_user_id="{external_user_id}", # any stable ID for this user in your system
configured_props={
"bright_data": {"authProvisionId": "apn_xxxxxxx"},
},
)curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
-H "Content-Type: application/json" \
-H "X-PD-Environment: production" \
-H "Authorization: Bearer {access_token}" \
-d '{
"external_user_id": "{external_user_id}",
"id": "bright_data-list-dataset-id-options",
"configured_props": {
"bright_data": { "authProvisionId": "apn_xxxxxxx" }
}
}'TOOLS
Bright Data actions
On-demand operations your product or agent can configure and run on behalf of a connected user.
-
List Dataset ID Options
actionRetrieves available options for the Dataset ID field.Read-onlyv0.0.1 -
Scrape SERP
actionExtract search engine results using Bright Data SERP API. See the documentationRead-onlyv0.0.2 -
Scrape Website
actionScrape a website and return the HTML. See the documentationWritev0.0.2 -
Unlock Website
actionSend an API call to a URL and get the HTML back. Enables you to bypass anti-bot measures, manages proxies, and solves CAPTCHAs automatically for easier web data collection. See the documentationWritev0.0.2
EVENTS
Bright Data triggers
Event sources your backend can deploy for users and receive through a webhook.
No Bright Data triggers are available yet.
- App slug
- bright_data
- Authentication
- API key
- Categories
- Data Analytics
- Actions
- 4
- Triggers
- 0
- API proxy
- Not available