1. Installation Guide

Getting started with NS Browser is quick and straightforward. The software runs locally on your desktop to ensure maximum browsing speed and complete data privacy.

System Requirements

Requirement	Minimum	Recommended
Operating System	Windows 10 (64-bit), macOS 11+, Linux	Windows 11, macOS 13+, Ubuntu 22.04+
Processor	Intel Core i3 / Apple M1	Intel Core i5 / Apple M2 or better
RAM Memory	4 GB RAM	8 GB or 16 GB RAM
Disk Space	500 MB free space	1 GB free space (SSD preferred)

Installation Steps

Download the Installer

Go to our Downloads section and select your OS. For Windows, download the .exe file. For macOS and Linux, follow the corresponding download options.

Run Setup Package

Double-click the downloaded setup file. On Windows, the installer will install NS Browser to your local application directory and add a shortcut to your desktop.

Launch Application

Open NS Browser from the desktop icon or start menu. You will immediately see the clean agent execution dashboard, ready for your commands.

info

First-run Security Warning (Windows SmartScreen)

Because NS Browser is a specialized, newly released Electron application, Windows Defender SmartScreen might show a warning. Click "More Info" and then "Run Anyway" to complete installation safely.

2. Your First Agent Task

The AI Agent in NS Browser understands regular English instructions. It interprets your request, builds a sequential search and extraction plan, navigates directories, bypasses blocks, and collects data into a spreadsheet.

Starting a Task

Enter your Prompt

In the main query input bar, enter what you want the AI to extract. For example:

Example Prompt

                Find all dental clinics in Noida with contact number, rating, and addresses from business directories.

Review the Plan

The AI will analyze the prompt and generate an execution plan showing exactly which websites it will search, what selectors it will crawl, and how it will clean the data.

Execute Plan

Click the Execute Plan button. The agent launches a background webview container and starts running. You can watch live logs in the console panel.

warning

Bypassing Bot Detection & CAPTCHAs

NS Browser uses random mouse movements, human-like typing delays, and session persistence to avoid bot blocks. If a directory throws a CAPTCHA, you can solve it manually in the active active tab view or let the agent handle it.

3. Understanding the Workspace

The workspace container is divided into three main sections designed to make reviewing your extracted data as easy as possible:

smart_toy

Live Execution Panel

Displays real-time logs, step-by-step progress, current status of background crawlers, and diagnostic warnings as the AI visits target sites.

table_view

Spreadsheet View

Once data is extracted, it is organized into a clean interactive grid. You can filter rows, search columns, and inspect individual cells directly inside the browser.

trending_up

Analytics Dashboard

Shows summarized data: total records found, distribution by city or category, average ratings, and visual metrics that give you instant insight into the scraped database.

4. Exporting Data

NS Browser features a native SpreadsheetML XML export engine. This generates professional, styled Excel sheets without relying on external libraries or server-side calls.

Export Types

XLS (SpreadsheetML XML): Generates a multi-sheet spreadsheet containing:
- Database Sheet: Raw extracted listings with bold purple headers.
- Analytics Sheet: Tabulated summaries, record counts, and metrics.
- Sources Sheet: Web URLs where each listing was found (helps verify data integrity).
CSV (Comma Separated Values): Standard, lightweight format for importing into database tools, CRMs, or analytics software.
PDF Report (Coming Soon): Printable document summarizing the analytics graphs and top listings.

check_circle

No Excel Formatting Errors

Our export engine produces true SpreadsheetML files that open directly in Microsoft Excel, Google Sheets, or LibreOffice Calc without the common "File format does not match extension" warning.

5. API Integration & Advanced Features

For power users, NS Browser allows configuring custom API keys to run advanced agentic logic using the latest AI models from Google and OpenAI.

Using Custom API Keys

By default, NS Browser runs on a local heuristics engine. To unlock intelligent planning, semantic classification, and advanced scraping of complex sites:

Navigate to Settings (Gear icon in bottom-left).
Select the AI Configuration tab.
Enter your Gemini API key (recommended) or OpenAI API key.
Select your model: gemini-1.5-pro, gpt-4o-mini, etc.
Click Save. The browser will run diagnostics to confirm connection.

Custom Workflow Scripts

You can write custom JavaScript automation recipes to automate tasks that require specific button clicks, complex form submissions, or login checks.

javascript (Custom Scraper Recipe)

// Custom step recipe to click and extract custom details
async function runRecipe(tab) {
  await tab.click('#show-contact-button');
  await tab.waitForTimeout(1000);
  const phone = await tab.evaluate(() => {
    return document.querySelector('.phone-number')?.textContent || '';
  });
  return { phone };
}
        

6. Keyboard Shortcuts

Maximize your efficiency inside NS Browser with built-in desktop keyboard shortcuts.

Shortcut	Action	Description
`Ctrl + N`	New Task	Clears active workspace and focuses query input
`Ctrl + Enter`	Execute Task	Instantly runs the current plan
`Ctrl + S`	Export XLS	Triggers Excel spreadsheet export
`Ctrl + [1, 2, 3]`	Switch Tabs	Switch between Console, Grid, and Analytics tabs
`F12`	DevTools	Opens background Electron chrome dev tools

7. Troubleshooting FAQ

The agent is stuck on a step. What should I do? +

If the agent is stuck loading a slow website or solving a script block, you can click the "Stop Task" button. You can then resume the task or modify your prompt to target a different directory. Ensuring a stable internet connection also helps.

How do I verify the sources of the extracted data? +

When you export the data as XLS, refer to the "Sources" tab. It lists the exact URLs visited by the agent for each record, allowing you to manually verify the authenticity of the information.

Why are some phone numbers or emails missing? +

Some listings on business directories do not display contact details publicly, or protect them with interactive buttons. NS Browser attempts to click them, but if they are protected by dynamic scripts or are absent, the field remains empty.

Is there a limit on how many rows I can extract? +

No! The local workspace engine has no hard row limits. You can scrape thousands of listings. However, very large queries (e.g. 5000+ records) may take longer to compile and require sufficient RAM memory.

How do I update NS Browser to the latest version? +

Simply download the newest installer from the homepage and run it. Your previous settings, workspaces, and API keys are preserved automatically.