In-Bot (Shape Generation)

Setting Up an In-Bort Shape Harvester

  • Follow these steps to configure and launch a Shape Harvester within your bot:

Step 1: Access Harvester Settings

  1. Go to the Settings tab of the bot.

  1. Navigate to the Harvesters tab.

Step 2: Add a New Harvester

  1. Click the Add button.

  1. Under Type, select Shape.

  1. Name your Harvester for easy identification.

  2. Optional - Click the Browser Path box:

  • Navigate to the browser executable you want to use.

  • If left blank, the bot will use Chrome as a default.

  1. Optional - Select the Proxy List

  • Select your proxy list you would like to use for Shape generation in browser. When left blank, the bot will use your local IP to generate. Many users have found this to be the ideal setup in passing Shape.

  1. Optional - Display Browser

  • You can enable Show Browser if you prefer the browser window to be visible while the Harvester runs.

  • This setting is optional and does not impact performance.

  1. Auto Start On Bot Start

  • You can enable Auto Start On Bot Start if you prefer the browser to startup and begin to generate cookies as soon as the bot is opened.

  • This setting is optional and does not impact performance. Is there as an ease of use feature.

Step 4: Finalize Harvester Creation

  • Click the Add button to create the Harvester.

Step 5: Adjust Shape Settings (Optional)

  • Click the Shape button next to the Add button to configure additional parameters:

  • Shape Harvester Settings Defaults:

    • Cookie Expiry (seconds): 300 (default)

    • Max Cookie Count: 30 (default)

      • While 30 is the default, users should aim to have 2-3 cookies per task in the cookie bank at the time a restock occurs. I.e. if you have 20 tasks, this should be adjusted to 60 or 90 to ensure you have an adequate number of cookies.

Step 6: Start Harvesting

  1. Right-click your configured Harvester.

  2. Select Start Harvesting.

Behavior to Expect

  • Tasks will display “Harvesting” status while cookies are being generated - this is normal.

  • Once the Max Cookie Count is reached (e.g., 30), tasks will switch to “Sleeping (Max Cookies Reached)” status.

FAQ

What is the difference between running the extension and running in-bot harvesters?

There’s a nominal difference in performance. Running in-bot harvesters is generally easier to set up and maintain.

How many harvesters do I need?

This depends on how many tasks you’re running. Each task should have 2–3 cookies available at all times. Multiply the number of tasks by 2–3 to estimate how many harvesters you need. Most users will only need 1–3 harvesters.

What does Shape Block mean?

Please see our Shape Guide for more details.

Why does my harvester status say "Error"?

This usually indicates an incorrect browser path. Double-check that you've set the path correctly. If the issue persists after confirming, please open a support ticket.

What sites require in-bot Shape harvesters?

Only Target currently requires in-bot Shape harvesters.

Should I use a proxy list for my harvester?

  • Local device: If you're running Refract on your personal machine (not a server or VM), you don’t need a proxy list for up to 2 harvesters.

  • Server/VM or more than 2 harvesters: Use a proxy list with ISP proxies for optimal stability and performance.

How do I find my browser path on Mac?

  1. Click the browser path box and go to the Applications folder.

  2. Locate the Brave Browser icon for example, and click it.

  3. For Brave, it the path will looks like this:

    /Applications/Brave Browser.app

How do I find my browser path on Windows?

  1. Locate the Brave browser shortcut on your desktop or Start menu.

  2. Right-click it and choose Properties.

  3. In the Target field, you'll find the path. For Brave, it usually looks like this:

    C:\Program Files\BraveSoftware\Brave-Browser\Application\brave.exe
PreviousTargetNextExtension (Shape Generation)

Last updated

Was this helpful?