For the complete documentation index, see llms.txt. This page is also available as Markdown.

In-Bot (Shape Generation)

The in-bot harvester generates Target Shape cookies from inside Refract, no extension needed. It has been passing Shape better than the extension, so this is the recommended place to start. You can also run both at the same time.

New to Shape? Read the general Target guide first. It explains what cookies are, why you need about 3 per running task, and why generating more is not better.

General Target Release Guide

Harvesters live in the bot under Settings > Harvesters. The toolbar buttons, left to right: the cookie button opens Shape Harvester Settings, + adds a harvester, the play button starts your harvesters, the square button stops them, the pencil edits, and the red X deletes.

The Harvesters tab in bot Settings with the toolbar buttons
The Harvesters tab. Toolbar, left to right: Shape settings, add, start, stop, edit, delete.

Create a harvester

1

Add a harvester

Click + on the Harvesters tab. Leave Type set to Shape, give the harvester a name, and set the Quantity you want.

The Add Harvester window
Leave Type on Shape. Blank Browser Path means Chrome.
2

Set the browser path

Leave Browser Path blank to use Chrome. To harvest on Brave, Edge, or any other Chromium browser instead, you must link that browser's executable file. See below for how to find it on Windows and Mac.

3

Pick a proxy list

Ideally select a residential (resi) proxy list. Resis have been passing Shape far better than ISPs. If you are on a local machine, you can run up to 2 harvesters with no proxies at all, generating on your home IP.

4

Leave Show Browser off

There is no need to turn on Show Browser. Click Add and your harvester appears in the list.

Finding the browser executable

Only needed if you are not using Chrome. The Browser Path must point at the browser's actual executable file. A desktop shortcut itself will not work, but a shortcut is the easiest way to find where the real file lives.

1

Find the browser's shortcut

Look on your desktop for the browser's icon. If it is not there, open the Start menu, type the browser's name, right-click it in the results, and choose Open file location.

2

Open its Properties

Right-click the shortcut and choose Properties. A window opens on the Shortcut tab.

3

Copy the Target path

The Target field contains the full path to the executable, ending in .exe. Select the whole thing and copy it. If the path is wrapped in quotation marks, do not include them.

4

Paste it into Refract

Paste the path into the Browser Path box in the Add Harvester window. The most common paths:

You can also click the Browser Path box and browse to the .exe at that location directly instead of copying from Properties.

Configure the Shape settings

Click the cookie button on the toolbar to open Shape Harvester Settings.

The Shape Harvester Settings window
Expiry between 300 and 600 seconds. Max Cookie Count: 3x your running tasks.
  • Current Cookie Count: how many cookies the in-bot harvesters have banked right now. This counts in-bot cookies only, not the extension's.

  • Cookie Expiry (seconds): set between 300 and 600. From our testing, most Shape cookies last a maximum of about 10 minutes, so there is no point keeping them longer.

  • Max Cookie Count: set this to 3x your running tasks. 20 tasks need 60 cookies. 20 tasks duplicated across 3 groups need 180. Remember from the general guide: generating far beyond what you need raises your flag risk, so 3 per task is the target, not the floor.

Click Save Changes when done.

Start and stop harvesting

  • The play button starts your harvesters, and the square button stops them.

  • Use the pencil to edit a harvester, or right-click it for the same options.

  • While generating, tasks show a Harvesting status. Once your Max Cookie Count is reached, they switch to Sleeping (Max Cookies Reached). Both are normal.

  • While the in-bot harvester is generating, your current cookie count also shows next to the cookie icon in the top bar of the bot, so you can watch your bank without opening Settings.

The bot top bar showing the cookie icon with the current count
Your in-bot cookie bank, always visible in the top bar while generating.

Schedule harvesters

You can have harvesters start themselves on a schedule instead of babysitting them.

1

Open the scheduler

Select the harvester or harvesters you want, right-click, and click Schedule.

The Schedule Harvester window with the Startup checkbox, days, and time slots
The Startup checkbox at the top is Auto start on app launch.
2

Decide on auto start

The Startup section at the top has an Auto start on app launch checkbox. Tick it and these harvesters start generating as soon as you open the bot, no schedule or manual start needed. This is the easiest way to never forget to start your harvesters.

3

Choose your days

Select days of the week to repeat weekly on those days. With no days selected, the schedule runs once at the next occurrence.

4

Add time slots

Click + Add Slot and set the start and stop times. You can add multiple slots. All times are your device's local time.

A schedule with a day selected and a start and stop time slot
Selected days repeat weekly. Times are always your device's local time.
5

Save

Click Save to apply the schedule.

How many harvesters do I need?

There is no task-to-harvester ratio. It takes as many harvesters as it takes to generate the cookies you need, which depends on your machine, your proxies, and the product's current security level. Watch your Current Cookie Count against your target of 3 cookies per running task, and scale the harvester count until you hold it comfortably.

FAQ

Extension or in-bot: which should I run?

The in-bot harvester has been passing Shape better than the extension, so start there. Both are viable, and you can run them at the same time. Test each on your setup and keep what generates best for you.

Why does my harvester status say "Error"?

This usually means the browser path is wrong. Double-check it points at the browser's executable, then try again. If it persists with a correct path, open a support ticket.

Which sites need Shape harvesters?

Only Target. Shape is Target's anti-bot system, and no other supported site uses these cookies.

Should my harvesters use proxies?

On a local machine, up to 2 harvesters run fine with no proxies on your home IP. Beyond that, or on a server, use a residential (resi) proxy list. Resis have been passing Shape far better than ISP proxies.

Last updated

Was this helpful?