定价
插件可免费安装,浏览器请求使用所连接的 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 会话进行交互式浏览器操作。
前置要求
- Python 3.9 或更高版本。
- 拥有 API 密钥的 AdsCrawl 账户。
安装
从公共 GitHub 仓库安装插件:adscrawl-codex on GitHub
查看源代码和发布版本。
认证
安装插件后,你可以让 Codex 连接你的 AdsCrawl 账户,或直接运行认证命令: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 积分。详见 积分与限制。