Deep Research
End-to-end research workflow that searches the web in parallel tabs, persists raw content and notes to disk as it goes (instead of holding everything in memory), synthesizes findings, and delivers a polished HTML report plus PDF.
When to Apply
Activate when the user asks to research a topic, compare information across sources, investigate something thoroughly, or compile findings from the web.
Workflow
Phase 1 — Clarify & Plan
- Clarify the research question. If the query is vague, ask the user for specifics: scope, depth, preferred sources, and where to save output (default:
research-<topic-slug>/ in your working directory).
- Plan search queries. Break the topic into 3–5 search angles. Example for "best standing desks":
best standing desks 2025 reviewsstanding desk comparison redditergonomic standing desk featuresstanding desk health benefits studies
- Create the output directory. Use
evaluate_script to create the target folder structure:research-<topic-slug>/
├── sources/ ← raw page content per source
├── findings.md ← running synthesis
├── report.html ← final HTML report
└── report.pdf ← final PDF report
Phase 2 — Parallel Research & Persistence
For each search query, open a parallel research tab and persist results to disk immediately:
| Step |
Tool |
Detail |
| Open tab |
new_hidden_page |
Opens a background tab so research doesn't disrupt the user |
| Search |
navigate_page |
Navigate to https://www.google.com/search?q=<encoded-query> (or the user's preferred search engine) |
| Pick results |
get_page_content / get_page_links |
Read the search results page; identify the 2–3 most relevant links |
| Visit source |
navigate_page |
Navigate to each selected result |
| Extract content |
get_page_content |
Pull the full page text |
| Save raw content |
evaluate_script |
Write a markdown file to sources/<n>-<slug>.md containing the page title, source URL, extraction date, and full text. Always include the source URL so every fact is traceable. |
| Close tab |
close_page |
Free resources after extraction |
Repeat across all search angles. Run multiple tabs concurrently where possible.
Source File Format (sources/<n>-<slug>.md)
# <Page Title>
- **URL:** <source-url>
- **Retrieved:** <date-time>
---
<extracted page content>
Phase 3 — Synthesize Findings
After all sources are saved:
- Read each source file and extract key facts, data points, expert opinions, and areas of agreement or disagreement.
- Write
findings.md in the output directory using the format below. Every claim must reference the source file and URL it came from.
- Continuously append to
findings.md as you process each source — do not hold all content in memory.
Findings File Format (findings.md)
# Research Findings: <Topic>
**Date:** <current date>
**Sources consulted:** <count>
**Output directory:** <path>
## Key Findings
1. **<Finding title>**
<Detail with supporting evidence>
_Source: [<source name>](<url>) — sources/<n>-<slug>.md_
2. **<Finding title>**
...
## Source Summary
| # | Source | URL | Key Insight | Credibility |
|---|--------|-----|-------------|-------------|
| 1 | <name> | <url> | <insight> | high / med / low |
## Agreements & Disagreements
- **Consensus:** ...
- **Conflicting views:** ...
## Conclusion
<Synthesis of findings with actionable recommendation>
Phase 4 — HTML Report
Generate a self-contained report.html in the output directory with the following requirements:
| Requirement |
Detail |
| Theme |
Light background (#ffffff), clean sans-serif typography, generous whitespace |
| Sections |
Title banner, executive summary, key findings (numbered cards), source table, conclusion |
| Source links |
Every finding must hyperlink to its original source URL. The source table must include clickable links. |
| Self-contained |
All styles inline or in a <style> block — no external CSS or JS dependencies |
| Responsive |
Readable on both desktop and mobile viewports |
| Footer |
"Generated by BrowserOS Deep Research" with the current date |
Use evaluate_script to write the HTML string to report.html in the output directory.
Phase 5 — Open, Export & Notify
| Step |
Tool |
Detail |
| Open report |
new_page |
Open file://<path>/report.html so the user sees the finished report |
| Export PDF |
save_pdf |
Save the currently open report page as report.pdf in the same output directory |
| Notify user |
— |
Tell the user research is complete and provide paths to both report.html and report.pdf |
Tool Reference
| Category |
Tools Used |
| Tab management |
new_hidden_page, new_page, close_page |
| Navigation |
navigate_page |
| Content extraction |
get_page_content, get_page_links |
| File I/O & scripting |
evaluate_script |
| Export |
save_pdf |
Tips
- 4–6 sources is the sweet spot for balanced coverage. More isn't always better.
- Prioritize recent sources — check publication dates and prefer current information.
- Note disagreements between sources rather than hiding them; surface conflicting data.
- Always record the source URL next to every fact so the report is fully traceable.
- For product research, include pricing and availability.
- For technical topics, prefer official documentation and peer-reviewed sources.
- If a Google search returns unhelpful results, try alternative queries or go directly to known authoritative sites.
1---2name: deep-research3description: Research a topic across multiple sources using parallel tabs, save raw content and findings to files, then produce an HTML report and PDF. Use when the user asks to research, investigate, or gather information on a topic.4---56# Deep Research78End-to-end research workflow that searches the web in parallel tabs, persists raw content and notes to disk as it goes (instead of holding everything in memory), synthesizes findings, and delivers a polished HTML report plus PDF.910## When to Apply1112Activate when the user asks to research a topic, compare information across sources, investigate something thoroughly, or compile findings from the web.1314## Workflow1516### Phase 1 — Clarify & Plan17181. **Clarify the research question.** If the query is vague, ask the user for specifics: scope, depth, preferred sources, and where to save output (default: `research-<topic-slug>/` in your working directory).192. **Plan search queries.** Break the topic into 3–5 search angles. Example for "best standing desks":20 - `best standing desks 2025 reviews`21 - `standing desk comparison reddit`22 - `ergonomic standing desk features`23 - `standing desk health benefits studies`243. **Create the output directory.** Use `evaluate_script` to create the target folder structure:25 ```26 research-<topic-slug>/27 ├── sources/ ← raw page content per source28 ├── findings.md ← running synthesis29 ├── report.html ← final HTML report30 └── report.pdf ← final PDF report31 ```3233### Phase 2 — Parallel Research & Persistence3435For **each** search query, open a parallel research tab and persist results to disk immediately:3637| Step | Tool | Detail |38|------|------|--------|39| Open tab | `new_hidden_page` | Opens a background tab so research doesn't disrupt the user |40| Search | `navigate_page` | Navigate to `https://www.google.com/search?q=<encoded-query>` (or the user's preferred search engine) |41| Pick results | `get_page_content` / `get_page_links` | Read the search results page; identify the 2–3 most relevant links |42| Visit source | `navigate_page` | Navigate to each selected result |43| Extract content | `get_page_content` | Pull the full page text |44| **Save raw content** | `evaluate_script` | Write a markdown file to `sources/<n>-<slug>.md` containing the page title, source URL, extraction date, and full text. **Always include the source URL** so every fact is traceable. |45| Close tab | `close_page` | Free resources after extraction |4647Repeat across all search angles. Run multiple tabs concurrently where possible.4849#### Source File Format (`sources/<n>-<slug>.md`)5051```markdown52# <Page Title>5354- **URL:** <source-url>55- **Retrieved:** <date-time>5657---5859<extracted page content>60```6162### Phase 3 — Synthesize Findings6364After all sources are saved:65661. **Read each source file** and extract key facts, data points, expert opinions, and areas of agreement or disagreement.672. **Write `findings.md`** in the output directory using the format below. Every claim must reference the source file and URL it came from.683. Continuously append to `findings.md` as you process each source — do not hold all content in memory.6970#### Findings File Format (`findings.md`)7172```markdown73# Research Findings: <Topic>7475**Date:** <current date>76**Sources consulted:** <count>77**Output directory:** <path>7879## Key Findings80811. **<Finding title>**82 <Detail with supporting evidence>83 _Source: [<source name>](<url>) — sources/<n>-<slug>.md_84852. **<Finding title>**86 ...8788## Source Summary8990| # | Source | URL | Key Insight | Credibility |91|---|--------|-----|-------------|-------------|92| 1 | <name> | <url> | <insight> | high / med / low |9394## Agreements & Disagreements9596- **Consensus:** ...97- **Conflicting views:** ...9899## Conclusion100101<Synthesis of findings with actionable recommendation>102```103104### Phase 4 — HTML Report105106Generate a self-contained `report.html` in the output directory with the following requirements:107108| Requirement | Detail |109|-------------|--------|110| **Theme** | Light background (`#ffffff`), clean sans-serif typography, generous whitespace |111| **Sections** | Title banner, executive summary, key findings (numbered cards), source table, conclusion |112| **Source links** | Every finding must hyperlink to its original source URL. The source table must include clickable links. |113| **Self-contained** | All styles inline or in a `<style>` block — no external CSS or JS dependencies |114| **Responsive** | Readable on both desktop and mobile viewports |115| **Footer** | "Generated by BrowserOS Deep Research" with the current date |116117Use `evaluate_script` to write the HTML string to `report.html` in the output directory.118119### Phase 5 — Open, Export & Notify120121| Step | Tool | Detail |122|------|------|--------|123| Open report | `new_page` | Open `file://<path>/report.html` so the user sees the finished report |124| Export PDF | `save_pdf` | Save the currently open report page as `report.pdf` in the same output directory |125| Notify user | — | Tell the user research is complete and provide paths to both `report.html` and `report.pdf` |126127## Tool Reference128129| Category | Tools Used |130|----------|-----------|131| Tab management | `new_hidden_page`, `new_page`, `close_page` |132| Navigation | `navigate_page` |133| Content extraction | `get_page_content`, `get_page_links` |134| File I/O & scripting | `evaluate_script` |135| Export | `save_pdf` |136137## Tips138139- **4–6 sources** is the sweet spot for balanced coverage. More isn't always better.140- **Prioritize recent sources** — check publication dates and prefer current information.141- **Note disagreements** between sources rather than hiding them; surface conflicting data.142- **Always record the source URL** next to every fact so the report is fully traceable.143- For product research, include pricing and availability.144- For technical topics, prefer official documentation and peer-reviewed sources.145- If a Google search returns unhelpful results, try alternative queries or go directly to known authoritative sites.
browseros-ai