# AdsCrawl for agents

AdsCrawl provides hosted browser execution for dynamic pages. Choose browser tasks for HTML, screenshots and field extraction, temporary CDP sessions for Playwright or Puppeteer, and a persistent Cloud Browser for saved profiles. For static content, start with an ordinary HTTP request.

## Make a first request

1. Register at https://app.adscrawl.net/register/ and create an API key in the dashboard. For agent-assisted onboarding, follow https://api.adscrawl.net/auth.md and obtain account-owner approval.
2. Keep the key on your server. POST JSON to https://api.adscrawl.net/html with the target URL in the body and the key in the x-api-key header.
3. To control a temporary browser instead, POST /cdp/sessions, use the returned connection information, and DELETE /cdp/sessions/:sessionId when finished. For a persistent Cloud Browser supply the required proxy on API launch and confirm that stop completed.

## Costs and limits

Free provides 500 one-time credits for supported tasks. Free can save a Cloud Browser profile but cannot start it. Paid monthly plans are Hobby ($9 for 3,000 credits), Starter ($49 for 100,000) and Pro ($199 for 500,000). Cloud Browser uses one credit per started minute until confirmed stop. If all monthly credits go to runtime, the effective hourly rates are $0.18, $0.0294 and $0.02388 respectively. Credits also pay for browser tasks. Session rounding, concurrency, billing periods and any external proxy charges affect practical capacity.

- Pricing examples: https://www.adscrawl.net/pricing/#browser-hour-pricing
- Billing and limits: https://docs.adscrawl.net/credits-and-limits
- API specification: https://www.adscrawl.net/openapi.yaml

## Find documentation

- Full text: https://www.adscrawl.net/llms-full.txt
- Maintained source: https://docs.adscrawl.net/llms-full.txt
- Documentation search MCP (streamable HTTP): https://docs.adscrawl.net/mcp
- Documentation MCP card: https://www.adscrawl.net/.well-known/mcp/server-card.json
- Documentation agent card: https://www.adscrawl.net/.well-known/agent-card.json

Use the MCP for documentation search and retrieval. Browser execution uses the authenticated REST APIs described above.