parallel-deep-research
Exhaustive research with configurable depth, latency, and cost trade-offs for complex topics.
- Three processor tiers (pro-fast, ultra-fast, ultra) ranging from 30 seconds to 25 minutes, with cost scaling from 1x to 3x baseline
- Asynchronous execution with polling: kick off research instantly, monitor progress via URL, retrieve results when ready without blocking
- Outputs formatted markdown report and JSON metadata; executive summary printed to stdout for quick overview
- Designed for explicit user requests ("deep research," "exhaustive," "comprehensive") — use parallel-web-search for routine lookups
Deep Research
Research topic: $ARGUMENTS
Requires
parallel-cli≥ 0.3.0 for text output and context chaining. If a documented command or option is missing, checkparallel-cli --versionand that command's--help, then follow the installation-specific upgrade guidance in Setup. API, authentication and input errors are not evidence of an older CLI.
When to use (vs parallel-web-search)
ONLY use this skill when the user explicitly requests deep/exhaustive research. It can take several minutes and costs more than a quick search, depending on the processor and task. For normal "research X" requests, quick lookups, or fact-checking, use parallel-web-search instead.
Step 1: Start the research
Choose a descriptive output base in a persistent directory (e.g., reports/ai-chip-market-2026). Include the returned run ID to make it unique, then use this base in step 2 as -o "$FILENAME". Check for existing .json and .md files before saving.
parallel-cli research run "$ARGUMENTS" --processor pro-fast --text --no-wait --json
The --text flag tells the API to return a markdown report (with inline citations) when the task completes, instead of the default structured JSON. Use it for narrative/report-style requests, which is what most users want from "deep research." Drop --text if the user explicitly wants structured JSON output.