JavaScript SDK

​

安装包

打开终端并运行：

npm install @brightdata/sdk

在你的代码文件中，导入包并发起你的第一次请求：

import { bdclient } from '@brightdata/sdk';

const client = new bdclient({
    apiKey: '[your_api_key_here]' // 也可以通过 BRIGHTDATA_API_KEY 环境变量定义
});
const result = await client.search('pizza restaurants');

console.log(result);

​

发起抓取和网络搜索

尝试这些示例，从你的 IDE 搜索或抓取互联网数据

search(...)

import { bdclient } from '@brightdata/sdk';

const client = new bdclient({
    apiKey: '[your_api_key_here]' // 也可以通过 BRIGHTDATA_API_KEY 环境变量定义
});
const result = await client.search('pizza restaurants');

console.log(result);

​

访问我们的 Linkedin 数据集

尝试这些示例，从你的 IDE 使用 Bright Data 的 Linkedin 数据集

discoverCompanyPosts(...)

import { bdclient } from '@brightdata/sdk';

const client = new bdclient({
    apiKey: 'YOUR_API_KEY_HERE',
    logLevel: 'INFO',
    structuredLogging: true,
    verbose: false
});

const res = await client.datasets.linkedin.discoverCompanyPosts([
    { url: 'https://www.linkedin.com/company/bright-data' },
]);

// 如果快照准备好，它将轮询，并下载
const filePath = await client.datasets.snapshot.download(res.snapshot_id, {
    filename: './brd_posts.jsonl',
    format: 'jsonl',
});

console.log(`内容已保存到: ${filePath}`);

客户端

添加客户端参数

const client = new bdclient({
    apiKey: 'string', // 你的 API key
    autoCreateZones: true, // 如果不存在则自动创建 zone
    webUnlockerZone: 'string', // 自定义 Web Unlocker zone 名称
    serpZone: 'string', // 自定义 SERP zone 名称
    logLevel: 'INFO', // 日志等级
    structuredLogging: true, // 使用结构化 JSON 日志
    verbose: false, // 启用详细日志
});

搜索

添加高级搜索参数

使用 SERP API 搜索网络

名称	类型	描述	默认值
query	`string	string[]`	搜索查询字符串或查询数组	—
options.searchEngine	`“google"	"bing"	"yandex”`	搜索引擎	"google"
options.zone	string	区域标识符（如果为空则自动配置）	—
options.format	`“json"	"raw”`	响应格式	"raw"
options.method	string	HTTP 方法	"GET"
options.country	string	两位国家代码	""
options.dataFormat	`“markdown"	"screenshot"	"html”`	返回内容格式	"html"
options.concurrency	number	最大并行任务数	10
options.timeout	number (ms)	请求超时	30000

抓取

添加高级抓取参数

使用 Web Unlocker API 抓取单个 URL 或 URL 列表

名称	类型	描述	默认值
url	`string	string[]`	单个 URL 字符串或 URL 数组	—
options.zone	string	区域标识符（如果为空则自动配置）	—
options.format	`“json"	"raw”`	响应格式	"raw"
options.method	string	HTTP 方法	"GET"
options.country	string	两位国家代码	""
options.dataFormat	`“markdown"	"screenshot"	"html”`	返回内容格式	"html"
options.concurrency	number	最大并行任务数	10
options.timeout	number (ms)	请求超时	30000

保存结果

保存内容到本地文件

参数:

名称	类型	描述	默认值
content	any	要保存的内容	—
options.filename	string	输出文件名（如果为空则自动生成）	—
options.format	`“json"	"csv"	"txt”`	文件格式	—

​

错误处理

日志记录

启用高级日志

在客户端中启用 VERBOSE 以进行高级日志记录（参见客户端参数） 使用 listZones() 函数检查可用 zone

认证

Bright Data 认证

创建一个 Bright Data 账户并复制你的 API key，前往 账户设置，确保你的 API key 具有 管理员权限

​

资源

GitHub

访问 Bright Data SDK GitHub 仓库