Deep Web Research
Help the user conduct thorough web research using Yutori's Research API.
Process
Understand the research goal
- What question needs answering?
- What type of sources matter? (news, academic, documentation, social, financial filings)
- Any time constraints? (recent only, historical)
- What format should the output be in?
Craft the research query Similar to scout queries, comprehensive research queries include:
- Context on why this research matters
- Specific questions to answer
- Sources to prioritize
- Output format expectations
Start the research task Use
run_research_taskwith:query: The research question with contextuser_timezone: For time-relevant searchesoutput_fields: If structured output is needed (e.g., ["title", "summary", "source_url", "date"])webhook_url: HTTPS URL for completion notificationwebhook_format:scout(default),slack, orzapier
Poll for results
- Important: Research typically takes 5-10 minutes (300-600 seconds)
- Use
get_research_task_resultto check status - Poll every 30 seconds until
succeededorfailed - The task runs asynchronously - you can inform the user to wait
Synthesize and present findings
- Organize results by relevance
- Highlight key insights
- Note sources for verification
Tips
Fetching documentation or reference URLs:
If you use a web fetch tool to look up documentation, API references, or other pages while preparing the research query, include the Accept: text/markdown header. Many documentation sites (Cloudflare-hosted) will return clean Markdown instead of HTML — fewer tokens, easier to parse.
$ARGUMENTS