Grasp 文档Grasp 文档
GitHub
  • English
  • 简体中文
  • 日本語
GitHub
  • English
  • 简体中文
  • 日本語
  • 快速开始

    • Grasp SDK
    • 身份验证
  • SDK 文档

    • TypeScript/Node.js SDK
    • Python SDK

身份验证

您可以通过两种方式使用 Grasp 进行身份验证:

1. 环境变量(推荐)

设置 GRASP_KEY 环境变量:

export GRASP_KEY=your_api_key_here

2. 直接在代码中使用

在代码中直接传递 API 密钥:

TypeScript/Node.js
const connection = await grasp.launchBrowser({
  key: 'your_api_key_here',
  // 其他选项...
});
Python
async with GraspServer({
    'key': 'your_api_key_here',
    # 其他选项...
}) as connection:
    # 您的代码

配置参数

创建 SDK 实例时,您可以设置以下配置参数:

参数类型必需默认值描述
keystring是*$GRASP_KEYAPI 密钥(如果设置了 GRASP_KEY 环境变量则可选)
typeenum否chromium远程浏览器类型:chromium 或 chrome-stable
headlessboolean否true无头模式(无头模式节省资源但可能更容易被检测为机器人)
timeoutinteger否900000 (15分钟)Grasp 服务超时时间(毫秒)(最大值:86400000 - 24小时)
adblockboolean否false启用广告拦截(实验性功能)
debugboolean否false启用调试模式以获得更详细的终端输出

最佳实践

  1. 使用环境变量:通过使用环境变量而不是硬编码来保护您的 API 密钥安全
  2. 超时配置:根据您的用例设置适当的超时时间(最大 24 小时)
  3. 资源管理:始终正确关闭浏览器和页面以避免资源泄漏
Prev
Grasp SDK