能做什么
渲染后的网页内容
读取经过 JavaScript 渲染的网页，返回 Markdown、HTML 或文章 JSON。
网页截图
通过截图 API 保存首屏或完整网页。
浏览器工作流
通过 Remote CDP 执行导航、点击、表单输入等多步操作。
准备工作
- AdsCrawl 账号和 API Key。
- 支持所选接入方式的 Codex 版本。
- 使用 Skill 的备用脚本需要 Python 3.9+；手动安装 Skill 需要 Git。
接入方式 01
插件
一次安装，包含工作流 Skill、MCP 连接和 Python 备用脚本。
从 Git 插件市场安装
在已安装 Codex CLI 的终端中执行。
codex plugin marketplace add AdsCrawl/adscrawl-codex codex plugin add adscrawl@adscrawl连接账号
兼容包通过 ADSCRAWL_API_KEY 读取密钥，请在启动 Codex 前设置。支持便携插件的客户端也可以通过安全连接界面收集密钥。
新建任务
新建 Codex 任务以加载 adscrawl-browser Skill，然后让 Codex 使用 AdsCrawl，按下方示例验证结果。
接入方式 02
Skill
单独加载工作流指令，调用已连接的 MCP，或使用仓库内的 Python 脚本。
保留完整包并注册 Skill
在 macOS/Linux 上克隆源码，并将 Skill 目录链接到用户技能目录。保留完整仓库，Skill 还会使用上级包内的脚本；若已经安装，复用现有仓库和链接。
mkdir -p "$HOME/.local/share" "$HOME/.agents/skills" git clone https://github.com/AdsCrawl/adscrawl-codex.git \ "$HOME/.local/share/adscrawl-codex" ln -s "$HOME/.local/share/adscrawl-codex/plugins/adscrawl/skills/adscrawl-browser" \ "$HOME/.agents/skills/adscrawl-browser"授权脚本或连接 MCP
单独安装 Skill 不会注册 MCP 服务。可按本页 MCP 方式连接，或运行备用脚本授权命令，在浏览器中打开返回的链接并批准。
python3 "$HOME/.local/share/adscrawl-codex/plugins/adscrawl/scripts/adscrawl.py" auth使用 Skill
新建任务并选择 adscrawl-browser。Skill 优先使用可用 MCP 工具，否则调用原仓库路径中的脚本。
使用 $adscrawl-browser 读取 https://example.com 的 Markdown，保存结果并核对页面标题。
接入方式 03
MCP
直接连接 AdsCrawl 托管浏览器工具，无需在本地运行浏览器服务。
配置密钥环境变量
在运行客户端的进程环境中设置 ADSCRAWL_API_KEY，不要写入前端代码或提交到代码仓库。 设置后重启客户端，确保它能读取该环境变量。
在 ~/.codex/config.toml 中添加服务
将此项合并到现有配置，保留其他服务；客户端提示时，审核并启用项目服务。
[mcp_servers.adscrawl] url = "https://api.adscrawl.net/mcp" env_http_headers = { "x-api-key" = "ADSCRAWL_API_KEY" }连接并检查工具
查看客户端 MCP 状态，确认可以发现 browser_open、browser_read 和 browser_close，再尝试下方示例。
试一次
完成接入后，将这段指令发给 Agent，确认功能可用。
使用 AdsCrawl 打开 https://example.com，读取页面标题，然后关闭浏览器并确认会话已停止。也可以让 Agent 帮你接入
请在此代码库中接入 AdsCrawl。使用 https://api.adscrawl.net/auth.md 帮我创建账号并授权 API Key，然后按照 https://api.adscrawl.net/docs/agent-quickstart.md 完成集成。用量与限制
- 插件和手动 Skill 安装任选其一，避免重复出现 adscrawl-browser。直接接入 MCP 提供工具，Skill 则提供使用这些工具的工作流指令。
- API 请求和浏览器会话消耗 AdsCrawl 账号积分，安装客户端不会额外赠送调用额度。
- 使用后关闭远程会话。客户端断开连接或关闭查看窗口，不代表服务端会话已经停止。
- MCP 的 browser_screenshot 会生成可公开访问的 JPEG 链接，适用于可以分享的内容；HTTP 截图 API 和脚本备用方式则返回 PNG 数据。