Search
中文
English中文
Get started免费开始
浏览器自动化api集成网页抓取开发者指南
7 min

AdsCrawl 下载：浏览器自动化 API 设置指南

了解如何下载、安装并开始使用 AdsCrawl 进行浏览器自动化、HTML 提取、截图和 CDP 控制。包含代码示例的设置指南。

AAnonymous

AdsCrawl 下载：如何安装并开始使用浏览器自动化 API

如果您正在搜索“AdsCrawl 下载”，您可能想尽快开始使用 AdsCrawl。AdsCrawl 不是传统的桌面应用程序，需要下载并安装。它是一个基于云的浏览器自动化和数据提取 API 平台。您通过 HTTP 请求、官方客户端示例和 Web 仪表盘访问它，这意味着“下载”步骤实际上是设置您的环境、获取 API 密钥并运行您的第一个请求。

本指南介绍了 AdsCrawl 到底是什么、开始之前需要什么、如何在 cURL、Node.js 和 Python 中设置它，以及如何避免常见的设置错误。

什么是 AdsCrawl？

AdsCrawl 通过统一的 API 提供真实的浏览器功能。您无需维护自己的无头浏览器集群，而是向 AdsCrawl 发送请求并接收渲染后的页面数据。该平台专为 AI 代理、监控、SEO 工作流和一般自动化任务而构建。

核心功能包括：

  • 捕获整页或元素级截图
  • 提取渲染后的 HTML 和 Markdown
  • 控制远程 Chrome DevTools 协议 (CDP) 会话
  • 使用指纹配置文件运行云浏览器会话
  • 并发执行多个浏览器会话
  • 将可重复的 Web 操作包装成可靠的 API

由于 AdsCrawl 基于积分并提供免费增值模式，您可以在承诺付费计划之前测试基本工作流。

“下载”对 API 平台意味着什么

AdsCrawl 不提供可安装的二进制文件或浏览器扩展。最接近下载的是：

  1. 创建帐户并从仪表盘获取 API 密钥
  2. 在您的机器上安装 HTTP 客户端或语言运行时
  3. 将官方的 cURL、Node.js 或 Python 示例复制到您的项目中
  4. 可选地使用仪表盘进行密钥管理、使用跟踪和调试

这种架构在爬取和浏览器自动化 API 中很常见。它消除了在本地管理 Chrome 二进制文件、驱动程序或服务器基础设施的需要。

开始之前的先决条件

在发出第一个 AdsCrawl 请求之前，请确认您具备：

  • 具有有效 API 密钥的 AdsCrawl 帐户
  • 稳定的互联网连接
  • 在本地安装以下之一：
    • cURL，在大多数 macOS 和 Linux 系统上可用
    • Node.js 18 或更高版本
    • Python 3.8 或更高版本
  • 用于运行示例的代码编辑器或终端

如果您计划将 AdsCrawl 集成到现有的自动化堆栈中，请查看 AdsCrawl 评论，了解真实世界性能的实践评估，然后再做决定。

步骤 1：获取您的 API 密钥

创建 AdsCrawl 帐户后，打开仪表盘并导航到密钥管理部分。创建新的 API 密钥并安全存储。将密钥视为密码：不要将其提交到公共存储库或在客户端代码中共享。

大多数示例使用环境变量将密钥保留在源文件之外：

export ADSCRAWL_API_KEY="your_api_key_here"

步骤 2：使用 cURL 发出您的第一个请求

cURL 是验证您的密钥有效并理解请求结构的最快方式。基本的 HTML 提取请求如下所示：

curl -X POST https://api.adscrawl.com/v1/scrape \
  -H "Authorization: Bearer $ADSCRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "output": "html"
  }'

成功的响应包括渲染后的 HTML 和关于会话的元数据。如果您收到身份验证错误，请仔细检查环境变量是否已设置以及密钥是否未过期。

步骤 3：设置 Node.js 客户端

对于 JavaScript 或 TypeScript 项目，首先创建一个新目录并初始化一个包：

mkdir adscrawl-test && cd adscrawl-test
npm init -y

AdsCrawl 使用标准 HTTP 请求，因此您可以在 Node.js 18+ 中使用内置的 fetch 函数，无需额外依赖：

const response = await fetch("https://api.adscrawl.com/v1/scrape", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.ADSCRAWL_API_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    url: "https://example.com",
    output: "markdown"
  })
});

const data = await response.json();
console.log(data.content);

此模式非常适合更大的自动化管道、无服务器功能或 AI 代理工具定义。

步骤 4：设置 Python 客户端

Python 用户可以使用 requests 库执行相同的工作流：

import os
import requests

response = requests.post(
    "https://api.adscrawl.com/v1/scrape",
    headers={
        "Authorization": f"Bearer {os.environ['ADSCRAWL_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "url": "https://example.com",
        "output": "html",
    },
)

print(response.json())

如果尚未安装 requests，请先安装：

pip install requests

对于截图工作流，更改输出类型或使用截图端点。仪表盘提供调试工具来检查失败的请求、查看响应负载并跟踪积分使用情况。

步骤 5：捕获截图并控制 CDP 会话

除了 HTML 提取之外，AdsCrawl 还支持截图捕获和直接 Chrome DevTools 协议控制。截图请求遵循与提取相同的模式，但指定截图输出：

body: JSON.stringify({
  url: "https://example.com",
  output: "screenshot",
  viewport: { width: 1280, height: 800 }
})

对于高级工作流，您可以打开 CDP 会话并发送原始协议命令。这对于需要与页面交互、检查网络活动或在提取数据之前验证渲染状态的 AI 代理非常有用。

常见设置问题和修复

身份验证失败

确保 Authorization 头使用确切的格式 Bearer YOUR_KEY。缺少空格或多余引号会导致 401 响应。

空或部分 HTML

某些页面异步加载内容。如果初始 HTML 不完整，请使用渲染等待选项或 CDP 会话等待特定选择器，然后再提取。

积分耗尽

AdsCrawl 使用基于积分的系统。在仪表盘中监控使用情况，以避免意外失败。免费增值层适合测试，而生产工作负载通常需要付费计划。

指纹或阻止问题

如果目标站点阻止通用浏览器会话，请使用指纹配置文件使云浏览器看起来更像真实用户环境。

AdsCrawl 与其他浏览器自动化工具的比较

AdsCrawl 介于低级框架和无代码工具之间。如果您正在决定选项，这些比较可能会有所帮助：

一般来说，当您想要一个具有 CDP 访问权限的托管云浏览器并且不想维护自己的浏览器集群时，请选择 AdsCrawl。当您需要完全本地控制并且愿意管理基础设施时，请选择 Playwright。当您的团队需要可视化工作流构建器而不是代码时，请选择无代码工具。

相关阅读

来源和进一步阅读

常见问题解答

是否有 AdsCrawl 桌面应用程序可以下载？

没有。AdsCrawl 是一个 API 平台。您通过 HTTP 请求、Web 仪表盘以及 cURL、Node.js 和 Python 中的官方代码示例与之交互。

我需要安装 Chrome 或浏览器驱动程序吗？

不需要。AdsCrawl 在云中运行真实浏览器，因此您无需在本地安装 Chrome、Chromium 或任何驱动程序。

如何获取我的 AdsCrawl API 密钥？

创建帐户，打开仪表盘，并从密钥管理部分生成密钥。将其存储在环境变量或安全的机密管理器中。

我可以使用 CDP 会话做什么？

您可以发送原始 Chrome DevTools 协议命令来控制页面行为、检查网络流量、等待元素以及自动化基本提取请求无法处理的交互。

AdsCrawl 是否提供免费层？

是的。该平台使用基于积分的免费增值模式，因此您可以在升级之前测试基本请求。

我可以同时运行多个浏览器会话吗？

可以。AdsCrawl 支持并发浏览器执行，这对于批量爬取、监控和 AI 代理工作流非常有用。

结论

“AdsCrawl 下载”不是您安装的单个文件。这是一个简短的设置过程：创建帐户、获取 API 密钥、选择您的语言并运行您的第一个请求。一旦您完成了基本的 HTML 提取，您就可以扩展到截图、Markdown 输出、指纹配置文件和 CDP 控制的会话。

这种 API 优先方法的主要优势是您完全跳过浏览器维护。对于构建 AI 代理、监控管道或数据收集工作流的团队，这意味着更快的迭代和更少的基础设施麻烦。从 cURL 示例开始验证您的密钥，然后转向 Node.js 或 Python 进行生产集成。

Related Articles

Browse all articles