Skip to main content
All integrations

AI agents

AdsCrawl for Claude Code

Connect Claude Code to AdsCrawl's MCP browser tools, or use a setup prompt to add the API to your project. Choose MCP for agent-operated browsing and the prompt for code integration.

01MCP02Setup prompt

What you can do

01

Read a live page

Open a hosted browser and inspect rendered content with browser_open and browser_read.

02

Work across steps

Navigate, click and fill forms while keeping related work in one session.

03

Inspect and close

Inspect the result, optionally share a screenshot, and release the session with browser_close.

Before you start

  • An AdsCrawl account and API key.
  • Claude Code installed or accessible with a project that can run server-side code.

SETUP METHOD 01

MCP

Connect directly to AdsCrawl's hosted browser tools. No local browser server is required.

  1. Make your key available

    Set ADSCRAWL_API_KEY in the environment of the process running your client. Keep it out of browser code and source control. Restart your client after setting the variable so it inherits the environment.

  2. Add the server to .mcp.json

    Merge this entry into your existing configuration, keeping other servers. Approve the project server if your client asks.

    JSON
    {
  "mcpServers": {
    "adscrawl": {
      "type": "http",
      "url": "https://api.adscrawl.net/mcp",
      "headers": {
        "x-api-key": "${ADSCRAWL_API_KEY}"
      }
    }
  }
}

  3. Connect and verify tools

    Check the client's MCP status and confirm browser_open, browser_read and browser_close are available. Then try the example below.

SETUP METHOD 02

Setup prompt

Let your agent add AdsCrawl to a project using the account authorization and quickstart guides.

  1. Open Claude Code

    Open a project where the agent can edit files and run commands. Use the launch button below, or copy this prompt into a new conversation.

    Prompt
    Set up AdsCrawl in this codebase. Use https://api.adscrawl.net/auth.md to help me create an account and authorize an API key, then follow https://api.adscrawl.net/docs/agent-quickstart.md to complete the integration.

  2. Review and authorize

    Send the prompt after reviewing it. Complete account authorization in your browser; let the agent configure the key in the project environment.

  3. Verify the project integration

    Ask the agent to fetch https://example.com as Markdown, save the result, and show the code change. The expected heading is Example Domain.

Open setup prompt in Claude Code

Try it

After setup, send this to your agent to check that the integration works.

Prompt
Open https://example.com with AdsCrawl, read the page heading, then close the browser. Confirm that the session has stopped.

Usage & limits

  • Opening the setup link only pre-fills a prompt. Review and send it to begin; paste the copied prompt if your client does not pre-fill it.
  • Close remote sessions after use. A disconnected client or closed viewer does not confirm that the server-side session has stopped.
  • MCP browser_screenshot creates a publicly accessible JPEG link; use it only for content you intend to share. The HTTP screenshot API and script fallback return PNG data instead.
  • API requests and browser sessions use your AdsCrawl account credits. Installing a client does not include a separate usage allowance.
See pricing and credit conversion

Further reading

Agent quickstartAdsCrawl MCP guideClaude Code MCP

Explore more integrations