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

# How to Set Up Oculus Proxies With Norconex

> Need flexible, region-aware, and reliable web crawling? Norconex + Oculus Proxies has you covered.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/oculus/integration-guides/img/oculus_integrations/Norconex.png" alt="title" />

## What is Norconex?

**Norconex** is a powerful, Java-based open-source web crawler designed for flexibility and deep customization. It supports a wide range of file types, integrates easily with third-party tools, and uses XML-based configuration. Key capabilities include data extraction, parsing, OCR, JavaScript rendering, and full compliance with robots.txt—making it perfect for indexing, content aggregation, and SEO optimization. When paired with **Oculus Proxies**, you can bypass geo-restrictions, prevent IP bans, and ensure stable, region-specific access for large-scale, reliable web crawling.

<Tip>
  If you're using **Oculus** to access search engines like **Google, Bing, or Yandex** and facing connection issues, the proxy type could be the reason. **ISP Premium Proxies** ensure stable and unrestricted access, preventing blocks that standard proxies might encounter. Switching to **ISP Premium Proxies** can help maintain smooth and reliable performance.
</Tip>

## How to Integrate Oculus Proxies with Norconex

<Steps>
  <Step title="Set up Java">
    Download and set up the correct version of the **Java Development Kit(JDK)** that matches your operating system.

    <Frame as="div">
      <img src="https://mintcdn.com/oculus/wLHiz8O2S_4OIGGs/integration-guides/img/norconex1.png?fit=max&auto=format&n=wLHiz8O2S_4OIGGs&q=85&s=da3d9f9fa2436dde6f74e6f58e9b9671" alt="" width="1161" height="824" data-path="integration-guides/img/norconex1.png" />
    </Frame>
  </Step>

  <Step title="Configure Environment Settings">
    In the Windows search bar, type **Environment Variables** and select **Edit the system environment variables**. Under **User variables for \[USERNAME]**, click **New** to add a new variable.

    <Frame as="div">
      <img src="https://mintcdn.com/oculus/wLHiz8O2S_4OIGGs/integration-guides/img/norconex2.png?fit=max&auto=format&n=wLHiz8O2S_4OIGGs&q=85&s=7f6f82e076578a6d59622ec90b969759" alt="" width="627" height="592" data-path="integration-guides/img/norconex2.png" />
    </Frame>
  </Step>

  <Step title="Set JAVA_HOME">
    In the **Variable name** field, input `JAVA_HOME`. For the **Variable value**, provide the `full path to your installed JDK directory`.
    Confirm by clicking **OK**.

    <Frame as="div">
      <img src="https://mintcdn.com/oculus/wLHiz8O2S_4OIGGs/integration-guides/img/norconex3.png?fit=max&auto=format&n=wLHiz8O2S_4OIGGs&q=85&s=85b1feba7b184c4acde3ed54fab01b06" alt="" width="659" height="170" data-path="integration-guides/img/norconex3.png" />
    </Frame>
  </Step>

  <Step title="Set up Norconex">
    Visit the official **Norconex website** and download the most recent release of the software.

    <Frame as="div">
      <img src="https://mintcdn.com/oculus/wLHiz8O2S_4OIGGs/integration-guides/img/norconex4.png?fit=max&auto=format&n=wLHiz8O2S_4OIGGs&q=85&s=29333e21de92b7cc36b9bc0b10777b75" alt="" width="1538" height="723" data-path="integration-guides/img/norconex4.png" />
    </Frame>
  </Step>

  <Step title="Configuration">
    Create a dedicated folder for Norconex (e.g., C:\Norconex). Locate the downloaded .zip archive, right-click it, and extract the contents into the folder you just created.

    Then go to: `Norconex → Examples → collector-http-config-reference.xml`.
    Open this file using a text editor such as Notepad for example.

    Within the file find the `<httpFetchers>` and `</httpFetchers>` tags, and place the necessary configuration code between them.

    ```bash theme={null}
    <httpFetcherFactory class="com.norconex.collector.http.fetch.impl.GenericHttpFetcherFactory">
    <proxySettings>
    <host>proxy.oculus-proxy.com</host>
    <port>12321</port> <-Replace with your port
    <scheme>http</scheme> <-or “https” if you bought TLS exits
    <credentials>
    <username>your-username</username> <-Replace with your username
    <password>your-password</password> <-Replace with your password
    </credentials>
    <urlFilter>.sample\.co\.jp.</urlFilter> <-Apply proxy only for matching URLs
    </proxySettings>
    </httpFetcherFactory>
    ```
  </Step>

  <Step title="Verify Configuration">
    Double-check that the XML file structure is properly updated with your changes. It should resemble the provided example:

    <Frame as="div">
      <img src="https://mintcdn.com/oculus/wLHiz8O2S_4OIGGs/integration-guides/img/norconex5.png?fit=max&auto=format&n=wLHiz8O2S_4OIGGs&q=85&s=10ca0c4972303f3c9e4f19c4d1b3d672" alt="" width="943" height="327" data-path="integration-guides/img/norconex5.png" />
    </Frame>
  </Step>
</Steps>
