Traffic Bot

A Windows desktop app for automated Google France traffic generation. Built with Electron + Playwright.

---

Features

• Search Google France with any keyword and click your target URL from results
• Detects both organic results and sponsored ads
• Human-like behavior — realistic mouse movement, reading-pace scrolling, random delays
• Profile system — save browser identity (UA, proxy, viewport) and warm up cookies manually before running campaigns
• Engine uses a snapshot of your saved profile — automation never modifies your original profile data
• Clears only target landing page cookies after each session
• Direct launches use English locale defaults, while proxy profiles can use manual locale/timezone overrides
• Full proxy support (HTTP/SOCKS5) with France residential proxy targeting
• Session history with success/fail tracking
• Live console log

---

Requirements

• Windows 10/11 x64
• Google Chrome installed
• Node.js 20+ (for development only)

---

Installation

Option A — Run the installer

1. Run Traffic Bot Setup 1.0.0.exe from the release/ folder
2. Follow the installer steps
3. Launch from the desktop shortcut or Start Menu

Option B — Run portable (no install)

1. Open release/win-unpacked/
2. Double-click Traffic Bot.exe

Windows Smart App Control: If Windows blocks the exe, go to Windows Security → App & browser control → Smart App Control → Off, then run again.

---

How to Build

Prerequisites

• Node.js 20+ installed
• Inno Setup installed (for installer only)
• Google Chrome installed

1. Install dependencies

npm install

2. Run in development mode

npm start

3. Build the portable exe

npm run build:exe

Output: release/Traffic Bot 1.0.0.exe (portable, no install needed)

4. Build the installer (optional)

First build the exe:

npm run build:exe

Then open installer.iss in Inno Setup and press F9. Output: release/Traffic Bot Setup 1.0.0.exe

Other commands

npm run build        # Dev build only (no exe, readable code)
npm run dist:dir     # Production build to folder only (faster, no exe)
npm run typecheck    # TypeScript type check without building

---

How to Use

Step 1 — Create a Profile

Go to Profile Manager → + CREATE NEW and fill in:

Field	Description
Display Name	Any name (e.g. "Desktop FR")
Browser Engine	Chrome or Edge
Device Simulation	Desktop or Mobile viewport
Proxy	http://user:pass@host:port (optional)
Locale Override	Optional locale for proxy-backed regional testing (example: en-GB)
Timezone Override	Optional IANA timezone (example: Europe/London)
Bookmarks	URLs to visit on first launch (optional)
User-Agent	Leave empty for browser default

Step 2 — Warm Up the Profile

Click Launch on your profile card. A real Chrome window opens with your profile settings.

• Accept Google consent / cookies
• Browse naturally to build cookies
• Close the browser when done — all data is saved

The card shows a Running badge while the browser is open.

Step 3 — Configure Campaign

In the left panel:

Setting	Description
Target Identity	Select the profile to use
Engine	Google / Bing / DuckDuckGo
Primary Keyword	Search term to type
Target Landing Page	URL to find and click
Visits	Total number of sessions to run
Parallel Sessions	Keep at 1 for Google (avoid bans)
Idle Range (ms)	Random wait time on SERP before clicking
Stealth Warm-up	Visits a random French news site first

Step 4 — Launch Engine

Click LAUNCH ENGINE. The engine:

1. Copies your saved profile to a temp location
2. Opens Chrome or Edge with the selected profile settings
3. Goes to Google France, types the keyword
4. Scrolls SERP naturally, finds your target (organic or ad)
5. Clicks the link, reads the page (scroll down + up)
6. Clears target page cookies
7. Closes browser, discards temp copy
8. Repeats for next session

The original profile is never modified by the engine.

---

Proxy Setup

Format: http://username:password@gateway:port

If you use a proxy and want browser region settings to match that test region, set the profile's Locale Override and Timezone Override manually. Without a proxy, the app uses English locale defaults and keeps the local system timezone.

Recommended providers (France residential):

Provider	Speed	Price
Smartproxy	Fast	~$7/GB
Bright Data	Fastest	~$4/GB
Data Impulse	Slow	Cheaper

Use sticky sessions (same IP for full session) to avoid Google CAPTCHA mid-session. Look for session duration of at least 10 minutes.

---

Building the Installer

Requires Inno Setup.

1. Run npm run build:exe to generate release/win-unpacked/
2. Open installer.iss in Inno Setup
3. Press F9 to compile
4. Output: release/Traffic Bot Setup 1.0.0.exe

---

Project Structure

src/
  main.ts                  # Electron main process + IPC handlers
  preload.ts               # Context bridge (renderer ↔ main)
  db.ts                    # JSON database (profiles, settings, history)
  types.ts                 # Shared TypeScript types
  automation/
    engine.ts              # Campaign runner (sequential session loop)
    session.ts             # Single session logic (search → click → scroll)
    browser-manager.ts     # Profile launch + temp copy management
    profile-manager.ts     # Playwright persistent context management
  renderer/
    index.html             # UI layout + styles
    renderer.ts            # UI logic (tabs, forms, live log)

release/                   # Build output (gitignored)
installer.iss              # Inno Setup installer script
build.mjs                  # esbuild build script

---

Notes

• Sessions run one at a time (concurrency 1) — running multiple parallel sessions on the same Google account triggers CAPTCHA
• If Google shows a CAPTCHA, the session is skipped and the next one starts
• The engine will not start if the manual browser is still open for the selected profile