# Parallel Deep Research

> Performs comprehensive deep research using Parallel AI. Use for in-depth analysis, market research, competitive intelligence, or complex multi-faceted questions requiring thorough web exploration. Use when this capability is needed.

- Skill: `tomevault-io/parallel-deep-research` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/parallel-deep-research`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/parallel-deep-research/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/parallel-deep-research

---


# Parallel Deep Research

Comprehensive intelligence reports from natural language queries using Parallel AI Task API.

## When to Use

- User needs thorough, multi-source research on a topic
- User asks complex questions requiring synthesis of multiple sources
- User needs market research or competitive analysis
- User wants comprehensive reports with citations
- Simple web search is insufficient for the depth needed

## Requirements

Environment variable must be set:
- `PARALLEL_API_KEY` - Parallel AI API key

## Command

```bash
./scripts/parallel_research research "query" [options]
```

## Options

| Option | Description |
|--------|-------------|
| `-p, --processor` | Model: `pro-fast` (default), `pro`, `ultra-fast`, `ultra` |
| `-t, --timeout` | Max wait in seconds (default: 600) |
| `-f, --format` | Output: `json` (default) or `markdown` |

## Processors

| Processor | Speed | Quality | Cost |
|-----------|-------|---------|------|
| `pro-fast` | 2-5x faster | Good | Lower |
| `pro` | Standard | Better | Medium |
| `ultra-fast` | 2-5x faster | Better | Medium |
| `ultra` | Standard | Best | Higher |

## Output Format

Default JSON for LLM parsing:

```json
{
  "query": "What are the latest developments in fusion energy?",
  "processor": "pro-fast",
  "run_id": "run_abc123",
  "content": {
    "summary": "...",
    "key_developments": [...],
    "companies": [...],
    "timeline": [...]
  },
  "basis": [
    {
      "field": "summary",
      "excerpts": [
        {"url": "https://...", "text": "..."}
      ]
    }
  ]
}
```

## Examples

Basic research:
```bash
./scripts/parallel_research research "What are the key players in the AI chip market and their competitive positions?"
```

Higher quality (slower):
```bash
./scripts/parallel_research research "Comprehensive analysis of renewable energy trends 2024" -p ultra
```

Human-readable output:
```bash
./scripts/parallel_research research "Electric vehicle battery technology advances" -f markdown
```

Extended timeout for complex research:
```bash
./scripts/parallel_research research "Deep competitive analysis of cloud providers" -t 1800
```

## Notes

- Research can take 1-45 minutes depending on complexity
- The pro model and ultra models are expensive and can take 10-45 minutes to complete
- Query must be under 15,000 characters
- Status updates print to stderr, results to stdout
- `basis` field contains citations mapping content to sources

---
> Source: [nc9/skills](https://github.com/nc9/skills) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-05-30 -->