全部集成
MCP 与 API
在 HTTP API 中使用 AdsCrawl
从任意服务端 HTTP 客户端调用 AdsCrawl。通过 REST API 获取渲染内容、PNG 截图和远程浏览器会话,无需引入语言 SDK。
能做什么
01
渲染后的网页内容
读取经过 JavaScript 渲染的网页,返回 Markdown、HTML 或文章 JSON。
02
网页截图
通过截图 API 保存首屏或完整网页。
03
浏览器工作流
通过 Remote CDP 执行导航、点击、表单输入等多步操作。
准备工作
- AdsCrawl 账号和 API Key。
- 此示例需要 cURL,也可使用任意服务端 HTTP 客户端。
- 在运行客户端的进程环境中设置 ADSCRAWL_API_KEY,不要写入前端代码或提交到代码仓库。
接入方式 01
HTTP API
发送 JSON 请求,并通过 x-api-key 请求头认证。
准备密钥
在运行客户端的进程环境中设置 ADSCRAWL_API_KEY,不要写入前端代码或提交到代码仓库。
请求渲染后的 Markdown
向 /html 发送 POST 请求,将 contentMode 设为 markdown。此示例将响应保存为 page.md。
curl --fail-with-body -sS https://api.adscrawl.net/html \ -H "content-type: application/json" \ -H "x-api-key: $ADSCRAWL_API_KEY" \ -d '{"url":"https://example.com","contentMode":"markdown"}' \ --output page.md检查返回结果
打开 page.md,检查是否包含 Example Domain。解析其他响应类型前,先检查 HTTP 状态。PNG 截图使用 POST /screenshot,交互式任务使用 POST /cdp/sessions。
用量与限制
- API 请求和浏览器会话消耗 AdsCrawl 账号积分,安装客户端不会额外赠送调用额度。
- 使用后关闭远程会话。客户端断开连接或关闭查看窗口,不代表服务端会话已经停止。
- 按端点设置超时与重试策略。本地请求超时,不代表远程任务已经停止。