build_research_timeline
Construct a research timeline for any biomedical topic or specific PMIDs, automatically detecting key milestones such as clinical trials, approvals, and landmark studies.
Instructions
Build a research timeline for a topic OR specific PMIDs.
═══════════════════════════════════════════════════════════════ 🎯 TWO MODES OF OPERATION ═══════════════════════════════════════════════════════════════
Mode 1: Search by topic (default) build_research_timeline(topic="remimazolam")
Mode 2: Build from specific PMIDs build_research_timeline(pmids="12345678,23456789", topic="My Timeline")
═══════════════════════════════════════════════════════════════ MILESTONE DETECTION ═══════════════════════════════════════════════════════════════
Automatically detects significant milestones including:
First reports and mechanism discoveries
Clinical trial phases (Phase 1/2/3/4)
FDA/EMA approvals
Meta-analyses and systematic reviews
Guidelines and consensus statements
Safety alerts and label updates
High-impact landmark studies
═══════════════════════════════════════════════════════════════ OUTPUT FORMATS (output_format parameter) ═══════════════════════════════════════════════════════════════
"text": Human-readable text format (default)
"tree": Research lineage tree — branches by sub-topic (NEW)
"mermaid": Mermaid timeline (VS Code, GitHub preview)
"mindmap": Mermaid mindmap of research branches (NEW)
"json": Full JSON data
"timeline_js": TimelineJS library format
"d3": D3.js visualization format
Args: topic: Research topic (drug name, gene, disease, etc.) Required if pmids not provided. Examples: "remimazolam", "BRCA1", "pembrolizumab melanoma" pmids: Comma-separated PMIDs or "last" for previous search results If provided, builds timeline from these specific articles. Example: "12345678,23456789,34567890" max_events: Maximum number of events to include (default: 30) min_year: Filter articles from this year (optional, topic mode only) max_year: Filter articles until this year (optional, topic mode only) include_all: Include non-milestone articles as generic events output_format: "text", "tree", "mermaid", "mindmap", "json", "json_tree", "timeline_js", or "d3"
Returns: Research timeline with detected milestones in requested format.
Examples: # By topic build_research_timeline(topic="remimazolam", max_events=20) build_research_timeline(topic="CAR-T therapy", min_year=2015, output_format="mermaid")
# By PMIDs
build_research_timeline(pmids="12345678,23456789", topic="Propofol Studies")
build_research_timeline(pmids="last", topic="Previous Search", output_format="json")
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| topic | No | ||
| pmids | No | ||
| max_events | No | ||
| min_year | No | ||
| max_year | No | ||
| include_all | No | ||
| highlight_landmarks | No | ||
| output_format | No | text |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |