> ## Documentation Index
> Fetch the complete documentation index at: https://docs.toolip.io/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Set Up Toolip With Puppeteer

> Discover how to enhance Puppeteer’s browser automation with Toolip. This guide will walk you through setting up secure, anonymous proxies for smoother web scraping and data retrieval.

<img src="https://mintcdn.com/toolip-d3ca8ce9/jm4qNwxMk9v2AMyx/integration-guides/img/toolip_integrations/Puppeteer.png?fit=max&auto=format&n=jm4qNwxMk9v2AMyx&q=85&s=0e5c735e48e319b4fc5f392f8ed71979" alt="title" width="720" height="200" data-path="integration-guides/img/toolip_integrations/Puppeteer.png" />

## What is Puppeteer?

Think of Puppeteer as a remote control for headless browsers. With just a few lines of Node.js code, you can direct browsers to gather information, run tests, and automate routine actions. It’s all about turning tough, time-consuming workflows into quick, manageable steps.

Prefer an enterprise-grade guide? Learn more about Oculus Proxies <a href="https://docs.oculusproxies.com/integration-guides/puppeteer" target="_blank" rel="noopener">Puppeteer Integration Guide</a>.

<Tip>
  Targeting search engines like Google, Bing, or Yandex requires a specialized proxy to ensure stable access and avoid blocks. **Toolip’s Search Engine ISP Proxies** are designed specifically for this, providing reliable performance where standard proxies may fail. If your proxy test isn't working on search engines, switching to **Search Engine ISP Proxies** can resolve the issue.
</Tip>

## How to Integrate Toolip With Puppeteer

<Steps>
  <Step title="Set Up Your Environment">
    1\. Install **Node.js** from [nodejs.org](https://nodejs.org/).

    2\. Use a code editor like VS Code and initialize a Node.js project.

    3\. Install Puppeteer by running:

    ```bash theme={null}
    npm install puppeteer
    ```
  </Step>

  <Step title="Retrieve Your Toolip Credentials">
    1\. Log in to your [Toolip dashboard](https://toolip.io/dashboard/page/plans) and note the following details: **Host**, **Port**, **Username**, **Password**.

    You'll need these credentials to route Puppeteer's traffic through Toolip’s secure proxy network.
  </Step>

  <Step title="Configure Puppeteer to Use Toolip">
    1\. **Set the Proxy Server**: Add `--proxy-server=[HOST]:[PORT]` to Puppeteer’s launch arguments.

    2\. **Authenticate**: Use `page.authenticate()` to enter your Toolip **username** and **password**.
  </Step>

  <Step title="Use This Example Code">
    Copy and run this Puppeteer script:

    ```javascript theme={null}
    const puppeteer = require('puppeteer');

    (async () => {
      // Launch Puppeteer with Toolip proxy
      const browser = await puppeteer.launch({
        headless: false,  // Change to true for headless mode
        args: ['--proxy-server=[HOST]:[PORT]'] // Replace with Toolip host and port
      });

      const page = await browser.newPage();

      // Authenticate with Toolip credentials
      await page.authenticate({
        username: '[USERNAME]',   // Replace with your Toolip username
        password: '[PASSWORD]'    // Replace with your Toolip password
      });

      // Test the proxy setup by visiting an IP-checking site
      await page.goto('http://httpbin.org/ip');
      
      // Capture a screenshot for verification
      await page.screenshot({ path: 'example.png' });

      await browser.close();
    })();
    ```
  </Step>
</Steps>

By integrating **Toolip** with **Puppeteer**, you ensure secure and private browsing for all your automated tasks. Enjoy smoother data collection, reduced detection risks, and a more reliable workflow—so you can focus on insights and results, not on technical roadblocks.