支持的语言
核心能力
- 渲染内容和截图 — 从任意 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()使用更长的默认值,以便启动和服务器清理。
快速示例
以下代码片段展示了如何在每种支持的语言中获取 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 集成,通过自然语言实现浏览器自动化。