Skip to main content
官方 AdsCrawl SDK 可以将 URL 转换为渲染后的 HTML、Markdown、结构化数据或 PNG 截图。当你的工作流需要交互时,可以通过 Playwright 或 Puppeteer 连接远程浏览器。所有 SDK 遵循相同的设计原则:零运行时依赖、显式 HTTP 超时、类型化错误,并且不会对计费的请求或浏览器创建自动重试。

支持的语言

核心能力

  • 渲染内容和截图 — 从任意 URL 获取 HTML、Markdown 或文章对象,或通过指定视口、整页及元素级别的方式截取 PNG 截图。
  • 结构化提取和模板 — 使用 DOM 选择器或网络响应从页面提取命名字段,或使用内置的 SPA 模板如 google-trends-explore。
  • 远程 CDP 会话 — 创建短期浏览器会话,并将你自己的 Playwright、Puppeteer 或 CDP 兼容库连接到 cdpBaseUrl。
  • 持久化云浏览器 — 创建长期浏览器配置文件,按需启动和停止,并在会话之间保留 Cookie、标签页和配置。
  • 代理和指纹 — 通过自定义 HTTP 或 SOCKS5 代理进行路由,或使用托管的 countryCode 路由。应用经过 BrowserScan、Pixelscan 和 IPhey 验证的连贯浏览器指纹。

通用配置

所有 SDK 按照相同的顺序解析配置:
  • API 密钥:默认读取 ADSCRAWL_API_KEY 环境变量。你也可以在初始化客户端时显式传入。
  • Base URL:依次为 ADSCRAWL_BASE_URL、ADSCRAWL_API_URL,最后默认使用 https://api.adscrawl.net。
  • HTTP 超时:大多数调用默认 90 秒。cloudBrowsers.launch() 使用更长的默认值,以便启动和服务器清理。
所有 SDK 仅限服务器端使用。请勿将 API 密钥暴露在前端打包文件中。

快速示例

以下代码片段展示了如何在每种支持的语言中获取 AdsCrawl 首页的 Markdown 版本。

下一步

JavaScript SDK

TypeScript 类型、ESM/CommonJS 支持、原生 fetch。Node.js 20+。

Python SDK

同步和异步客户端,零运行时依赖。Python 3.9+。

Go SDK

上下文感知超时、类型化模型、标准库 HTTP。Go 1.21+。

Ruby SDK

关键字和哈希参数,仅依赖标准库。Ruby 3.1+。

PHP SDK

仅需 JSON 和 cURL 扩展。PHP 8.1+。

Codex 插件

OpenAI Codex MCP 集成,通过自然语言实现浏览器自动化。