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. Arender 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
- Python 3.9 or later.
- An AdsCrawl account with an API key.
Install
Install the plugin from the public GitHub repository: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: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 invokesplugins/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
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.