Skip to main content
The AdsCrawl Codex plugin lets you ask Codex to read a JavaScript-rendered page as Markdown, HTML or article JSON, or save the page as a PNG screenshot.

Pricing

The plugin is free to install. AdsCrawl bills the connected account for browser requests. Free includes 500 credits once at USD 0. Monthly plans are Hobby at USD 9 for 3,000 credits, Starter at USD 49 for 100,000 and Pro at USD 199 for 500,000. A render or screenshot request costs 1 credit after validation, including when execution subsequently fails. Plan prices · Credit rules

Limits

The bundled command requires Python 3.9+ and an AdsCrawl API key. It reads one URL per invocation. Its default timeout is 60 seconds and --timeout-ms accepts up to 3,600,000 ms. For a sequence of clicks or form submissions, use a remote CDP session with your browser automation library. Sites can require login or return a verification page. Remote CDP

Features

  • Render a URL as Markdown, HTML, or structured article JSON.
  • Capture a full-page or viewport PNG screenshot.
  • Select a managed country route and navigation wait strategy.
  • Use AdsCrawl CDP sessions for interactive browser work through your project’s browser automation library.

Requirements

Install

Install the plugin from the public GitHub repository:
Start a new Codex task after installation so the bundled skill is loaded. To add a local checkout while developing:

adscrawl-codex on GitHub

View source and releases.

Authenticate

After installing the plugin, ask Codex to connect your AdsCrawl account, or run the auth command directly:
The command asks for your account email and a project name, then prints a link for you to approve. It never asks for your password or prints the resulting API key. Alternatively, set ADSCRAWL_API_KEY in your environment. The plugin will reuse an existing environment variable. The auth flow saves your key privately at ~/.config/adscrawl/codex.env with 0600 permissions.

Direct commands

The skill invokes plugins/adscrawl/scripts/adscrawl.py. You can also run it directly:

Render a page

--format accepts markdown, html, or article (structured article JSON).

Capture a screenshot

Run python3 plugins/adscrawl/scripts/adscrawl.py <command> --help for the available options. API failures are not retried automatically.

CDP sessions

For interactive browser work (clicking, filling forms, multi-step flows), use AdsCrawl CDP sessions through your project’s browser automation library. See Remote CDP browsers and Playwright automation.
Plugin requests can consume AdsCrawl credits. See Credits and limits.