跳转到主要内容
AdsCrawl Codex 插件让你用自然语言在 Codex 中读取 JavaScript 渲染后的页面,获取 Markdown、HTML、文章 JSON 或 PNG 截图。

定价

插件可免费安装,浏览器请求使用所连接的 AdsCrawl 账户额度。Free 为 0 美元,一次性获得 500 credits。付费套餐按月计费,Hobby 为 9 美元含 3,000 credits,Starter 为 49 美元含 100,000 credits,Pro 为 199 美元含 500,000 credits。每次 render 或 screenshot 请求通过校验后扣 1 credit,随后执行失败也会消耗这笔额度。套餐定价 · 计费规则

限制

插件命令需要 Python 3.9 或更新版本及 AdsCrawl API key,每次处理一个 URL。默认超时为 60 秒,--timeout-ms 的上限为 3,600,000 毫秒。需要连续点击或提交表单时,请通过浏览器自动化库操作远程 CDP 会话。目标站点可能要求登录或返回验证页。远程 CDP

功能

  • 将 URL 渲染为 Markdown、HTML 或结构化 article JSON。
  • 捕获整页或视口范围内的 PNG 截图。
  • 选择托管的国家/地区路由和导航等待策略。
  • 通过项目中的浏览器自动化库使用 AdsCrawl CDP 会话进行交互式浏览器操作。

前置要求

安装

从公共 GitHub 仓库安装插件:
安装完成后,启动一个新的 Codex 任务以加载捆绑的 skill。在开发过程中添加本地 checkout:

adscrawl-codex on GitHub

查看源代码和发布版本。

认证

安装插件后,你可以让 Codex 连接你的 AdsCrawl 账户,或直接运行认证命令:
该命令会询问你的账户邮箱和项目名称,然后打印一个链接供你授权批准。它不会要求输入密码,也不会打印生成的 API 密钥。 或者,你也可以直接在环境中设置 ADSCRAWL_API_KEY。如果该环境变量已存在,插件会直接复用。 认证流程会将你的密钥以 0600 权限私密保存在 ~/.config/adscrawl/codex.env 中。

直接命令

skill 通过调用 plugins/adscrawl/scripts/adscrawl.py 执行操作。你也可以直接运行它:

渲染页面

--format 支持 markdown、html 或 article(结构化文章 JSON)。

捕获截图

运行 python3 plugins/adscrawl/scripts/adscrawl.py <command> --help 查看可用选项。API 失败不会自动重试。

CDP 会话

对于交互式浏览器操作(点击、填写表单、多步骤流程),请通过项目中的浏览器自动化库使用 AdsCrawl CDP 会话。详见 远程 CDP 浏览器 和 Playwright 自动化。
插件请求会消耗 AdsCrawl 积分。详见 积分与限制。