Research Agent
A multi-tool research methodology with automatic depth routing. Start cheap,
escalate when needed, cache everything, cite every claim.
Hard Rules
- Never fabricate research findings. Every claim needs a source.
- Check the cache before starting. Don't re-research what's already fresh.
- Start with free tools. Only escalate to paid tools when free results are thin.
- Present findings by relevance, not by tool. The user doesn't care which
backend produced the answer.
- Disclose uncertainty. If you couldn't verify a claim, say so explicitly.
Depth Routing
Assess the query and pick the right tool. Always start with the cheapest
tool that can plausibly answer.
"WebSearch" and "WebFetch" below mean your agent's built-in web search and
page fetch tools. Those are the Claude Code names; other agents have
equivalents, so substitute whatever your environment provides.
| Depth |
Tool |
When to use |
Speed |
Cost |
| Quick |
WebSearch (built-in) |
Single fact, recent news, quick lookup |
Seconds |
Free |
| Scrape |
WebFetch (built-in) |
Read a specific URL the user provides |
Seconds |
Free |
| Better scrape |
Firecrawl (MCP) |
JS-heavy pages, structured extraction, WebFetch fails |
Seconds |
~$0.01 |
| Broader |
Brave Search (MCP) |
WebSearch results thin, need more results or domain filtering |
Seconds |
Free tier |
| Medium |
Perplexity Ask (MCP) |
AI-synthesized answer with citations, multi-faceted questions |
5-10s |
Small |
| Deep |
Perplexity Research (MCP) |
Comprehensive multi-source investigation, company profiles |
~30s |
Moderate |
| Ultra-deep |
Gemini Deep Research (API) |
Market landscapes at extreme breadth, when Perplexity is thin |
10-20 min |
$2-5 |
Tool Priority
- WebSearch -- built-in web search, free, always try first
- WebFetch -- built-in page fetch, free, for reading specific URLs
- Brave Search -- MCP, when WebSearch is insufficient
- Firecrawl -- MCP, when WebFetch fails (JS rendering, structured extraction)
- Perplexity Ask -- MCP, quick AI-synthesized answers with citations
- Perplexity Research -- MCP, the workhorse for deep research (best quality-to-cost ratio)
- Gemini Deep Research -- API, last resort for extreme breadth
Routing Signals
Use Quick (WebSearch/Brave) when:
- Simple factual question
- Looking up a single data point (funding round, CEO name, HQ location)
- Checking recent news
- Verifying a claim
Use Medium (Perplexity Ask) when:
- Need a synthesized answer from multiple sources
- Comparing a few options
- Getting a topic overview with decent depth
Use Deep (Perplexity Research) when:
- Full company profile or due diligence
- Preparing for a demo, pitch, or advisory engagement
- Need strategic initiatives, financials, leadership, tech stack
Escalation pattern: Start with the cheapest tool that can plausibly answer.
If results are thin, escalate one level. Tell the user before escalating to
paid tiers.
Supplemental Source Checks
After the primary research call, run targeted follow-ups to fill gaps. These
are cheap/free and take about a minute total. Run as many in parallel as possible.
| Source |
Tool |
What it fills |
| Financial filings |
WebSearch |
Revenue, assets, employee count from statutory accounts |
| Recent news (3mo) |
WebSearch |
Press coverage, events the primary call missed |
| Careers page |
Firecrawl |
Hiring priorities, tech stack confirmation, growth signals |
| Customer reviews |
WebSearch (site:trustpilot.com, g2.com) |
Customer sentiment, pain points |
| Competitive moves |
WebSearch per competitor |
What competitors are doing |
When to run supplementals:
- Always for company research or due diligence
- Always for demo or advisory prep
- Skip for quick lookups or general topic questions
How to use findings: Merge into the primary output organized by section
(not by source). Flag anything that contradicts the primary research. Note
gaps that remain even after supplementals.
Caching
Cache research results to avoid redundant queries.
Cache file format
Filename: {slugified-subject}-{date}.md
# Research: {Subject}
Researched: {date}
Depth: {quick|medium|deep}
Tools used: {list}
## Findings
{content}
## Sources
- {url} -- {description}
## Gaps
- {anything still unknown}
Freshness rules
| Depth |
Fresh for |
| Quick |
24 hours |
| Medium |
3 days |
| Deep |
7 days |
| Ultra-deep |
14 days |
Before starting research, check if a cache file exists. If fresh, use it.
If stale, re-research (but reference old results for comparison).
Output Format
Present findings in a clean, scannable format:
## Research: {Subject}
Depth: {level} | Sources: {count} | {date}
### Key Findings
- {finding 1} -- source: {url}
- {finding 2} -- source: {url}
### Details
{structured content organized by relevance}
### Gaps
- {anything you couldn't find or verify}
Lead with what matters most. Don't pad.
Troubleshooting
| Issue |
Fix |
| Thin WebSearch results |
Try different query terms, escalate to Brave/Perplexity |
| Firecrawl returns empty |
Page may be JS-rendered. Try with waitFor: 5000. Or try firecrawl_map first. |
| Perplexity misses recent news |
Supplement with WebSearch using recency filter |
| Conflicting sources |
Note the conflict explicitly. Prefer primary sources (official filings, press releases) over secondary (blog posts, forums). |
Adapting to Your MCP Setup
This skill references several MCP servers. Use what you have available:
- No MCP at all? Your agent's built-in web search and fetch tools
(WebSearch/WebFetch in Claude Code, or equivalents) handle most quick and
medium research. You lose structured extraction (Firecrawl) and
AI-synthesized answers (Perplexity), but the methodology still works.
- Only Brave Search? Use it as your primary search. Skip Firecrawl steps.
- Only Perplexity? Jump straight to medium/deep depth. Skip the free tier escalation.
- Full stack? Follow the routing table as written.
The methodology is tool-agnostic. The routing table is a recommendation, not
a requirement. Use the best tools you have access to.
Built by Agent Blueprint -- AI advisory for enterprise agent deployment.
1---2name: research-agent3description: Multi-tool research methodology with automatic depth routing for company research, market analysis, deep research, and competitive investigation. Routes queries through free tools first (web search, page scraping), escalates to paid tools only when needed (Perplexity, Gemini Deep Research). Includes caching, source verification, and structured output. Use when researching companies, topics, markets, competitors, or any question requiring web information. Triggers: research, look into, find out about, investigate, what do we know about, deep research, company research, market analysis.4license: Apache-2.05---67# Research Agent89A multi-tool research methodology with automatic depth routing. Start cheap,10escalate when needed, cache everything, cite every claim.1112---1314## Hard Rules15161. **Never fabricate research findings.** Every claim needs a source.172. **Check the cache before starting.** Don't re-research what's already fresh.183. **Start with free tools.** Only escalate to paid tools when free results are thin.194. **Present findings by relevance, not by tool.** The user doesn't care which20 backend produced the answer.215. **Disclose uncertainty.** If you couldn't verify a claim, say so explicitly.2223---2425## Depth Routing2627Assess the query and pick the right tool. Always start with the cheapest28tool that can plausibly answer.2930"WebSearch" and "WebFetch" below mean your agent's built-in web search and31page fetch tools. Those are the Claude Code names; other agents have32equivalents, so substitute whatever your environment provides.3334| Depth | Tool | When to use | Speed | Cost |35|-------|------|-------------|-------|------|36| **Quick** | WebSearch (built-in) | Single fact, recent news, quick lookup | Seconds | Free |37| **Scrape** | WebFetch (built-in) | Read a specific URL the user provides | Seconds | Free |38| **Better scrape** | Firecrawl (MCP) | JS-heavy pages, structured extraction, WebFetch fails | Seconds | ~$0.01 |39| **Broader** | Brave Search (MCP) | WebSearch results thin, need more results or domain filtering | Seconds | Free tier |40| **Medium** | Perplexity Ask (MCP) | AI-synthesized answer with citations, multi-faceted questions | 5-10s | Small |41| **Deep** | Perplexity Research (MCP) | Comprehensive multi-source investigation, company profiles | ~30s | Moderate |42| **Ultra-deep** | Gemini Deep Research (API) | Market landscapes at extreme breadth, when Perplexity is thin | 10-20 min | $2-5 |4344### Tool Priority45461. **WebSearch** -- built-in web search, free, always try first472. **WebFetch** -- built-in page fetch, free, for reading specific URLs483. **Brave Search** -- MCP, when WebSearch is insufficient494. **Firecrawl** -- MCP, when WebFetch fails (JS rendering, structured extraction)505. **Perplexity Ask** -- MCP, quick AI-synthesized answers with citations516. **Perplexity Research** -- MCP, the workhorse for deep research (best quality-to-cost ratio)527. **Gemini Deep Research** -- API, last resort for extreme breadth5354### Routing Signals5556**Use Quick (WebSearch/Brave) when:**57- Simple factual question58- Looking up a single data point (funding round, CEO name, HQ location)59- Checking recent news60- Verifying a claim6162**Use Medium (Perplexity Ask) when:**63- Need a synthesized answer from multiple sources64- Comparing a few options65- Getting a topic overview with decent depth6667**Use Deep (Perplexity Research) when:**68- Full company profile or due diligence69- Preparing for a demo, pitch, or advisory engagement70- Need strategic initiatives, financials, leadership, tech stack7172**Escalation pattern:** Start with the cheapest tool that can plausibly answer.73If results are thin, escalate one level. Tell the user before escalating to74paid tiers.7576---7778## Supplemental Source Checks7980After the primary research call, run targeted follow-ups to fill gaps. These81are cheap/free and take about a minute total. Run as many in parallel as possible.8283| Source | Tool | What it fills |84|--------|------|---------------|85| Financial filings | WebSearch | Revenue, assets, employee count from statutory accounts |86| Recent news (3mo) | WebSearch | Press coverage, events the primary call missed |87| Careers page | Firecrawl | Hiring priorities, tech stack confirmation, growth signals |88| Customer reviews | WebSearch (site:trustpilot.com, g2.com) | Customer sentiment, pain points |89| Competitive moves | WebSearch per competitor | What competitors are doing |9091**When to run supplementals:**92- Always for company research or due diligence93- Always for demo or advisory prep94- Skip for quick lookups or general topic questions9596**How to use findings:** Merge into the primary output organized by section97(not by source). Flag anything that contradicts the primary research. Note98gaps that remain even after supplementals.99100---101102## Caching103104Cache research results to avoid redundant queries.105106### Cache file format107108Filename: `{slugified-subject}-{date}.md`109110```markdown111# Research: {Subject}112Researched: {date}113Depth: {quick|medium|deep}114Tools used: {list}115116## Findings117{content}118119## Sources120- {url} -- {description}121122## Gaps123- {anything still unknown}124```125126### Freshness rules127128| Depth | Fresh for |129|-------|-----------|130| Quick | 24 hours |131| Medium | 3 days |132| Deep | 7 days |133| Ultra-deep | 14 days |134135Before starting research, check if a cache file exists. If fresh, use it.136If stale, re-research (but reference old results for comparison).137138---139140## Output Format141142Present findings in a clean, scannable format:143144```markdown145## Research: {Subject}146Depth: {level} | Sources: {count} | {date}147148### Key Findings149- {finding 1} -- source: {url}150- {finding 2} -- source: {url}151152### Details153{structured content organized by relevance}154155### Gaps156- {anything you couldn't find or verify}157```158159Lead with what matters most. Don't pad.160161---162163## Troubleshooting164165| Issue | Fix |166|-------|-----|167| Thin WebSearch results | Try different query terms, escalate to Brave/Perplexity |168| Firecrawl returns empty | Page may be JS-rendered. Try with `waitFor: 5000`. Or try `firecrawl_map` first. |169| Perplexity misses recent news | Supplement with WebSearch using recency filter |170| Conflicting sources | Note the conflict explicitly. Prefer primary sources (official filings, press releases) over secondary (blog posts, forums). |171172---173174## Adapting to Your MCP Setup175176This skill references several MCP servers. Use what you have available:177178- **No MCP at all?** Your agent's built-in web search and fetch tools179 (WebSearch/WebFetch in Claude Code, or equivalents) handle most quick and180 medium research. You lose structured extraction (Firecrawl) and181 AI-synthesized answers (Perplexity), but the methodology still works.182- **Only Brave Search?** Use it as your primary search. Skip Firecrawl steps.183- **Only Perplexity?** Jump straight to medium/deep depth. Skip the free tier escalation.184- **Full stack?** Follow the routing table as written.185186The methodology is tool-agnostic. The routing table is a recommendation, not187a requirement. Use the best tools you have access to.188189---190191*Built by [Agent Blueprint](https://agentblueprint.ai) -- AI advisory for enterprise agent deployment.*