Parallel Search
High-accuracy web search built for AI agents. Returns ranked results with intelligent excerpts optimized for LLM consumption.
When to Use
Trigger this skill when the user asks for:
- - "search the web", "web search", "look up", "find online"
- "current news about...", "latest updates on..."
- "research [topic]", "what's happening with..."
- Fact-checking with citations needed
- Domain-specific searches (e.g., "search GitHub for...", "find on Reddit...")
Quick Start
CODEBLOCK0
CLI Reference
Basic Usage
CODEBLOCK1
Common Flags
| Flag | Description |
|---|
| INLINECODE0 | Add keyword filter (repeatable, 3-8 recommended) |
| INLINECODE1 |
Number of results (1-20, default: 10) |
|
--json | Output as JSON |
|
--after-date YYYY-MM-DD | Filter for recent content |
|
--include-domains domain.com | Limit to specific domains (repeatable, max 10) |
|
--exclude-domains domain.com | Exclude domains (repeatable, max 10) |
|
--excerpt-max-chars-total N | Limit total excerpt size (default: 8000) |
Examples
Basic search:
CODEBLOCK2
With keyword filters:
CODEBLOCK3
Domain-scoped search:
CODEBLOCK4
Recent news only:
CODEBLOCK5
Best-Practice Prompting
Objective
Write 1-3 sentences describing:
- - The real task context (why you need the info)
- Freshness constraints ("prefer 2026+", "latest docs")
- Preferred sources ("official docs", "news sites")
Keyword Queries
Add 3-8 keyword queries including:
- - Specific terms, version numbers, error strings
- Common synonyms
- Date terms if relevant ("2026", "Jan 2026")
Response Format
Returns structured JSON with:
- -
search_id — unique identifier - INLINECODE8 — array of results:
-
url — source URL
-
title — page title
-
excerpts[] — relevant text excerpts
-
publish_date — when available
Output Handling
When turning results into a user-facing answer:
- - Prefer official/primary sources when possible
- Quote or paraphrase only the relevant extracted text
- Include URL + publish_date for transparency
- If results disagree, present both and note the discrepancy
Running Out of Context?
For long conversations, save results and use sessions_spawn:
CODEBLOCK6
Then spawn a sub-agent:
CODEBLOCK7
Error Handling
| Exit Code | Meaning |
|---|
| 0 | Success |
| 1 |
Unexpected error (network, parse) |
| 2 | Invalid arguments |
| 3 | API error (non-2xx) |
Prerequisites
- 1. Get an API key at parallel.ai
- Install the CLI:
CODEBLOCK8
References
并行搜索
专为AI代理构建的高精度网络搜索。返回经过排名的结果,并附带针对大语言模型消费优化的智能摘要。
使用时机
当用户请求以下内容时触发此技能:
- - 搜索网络、网络搜索、查找、在线搜索
- 关于...的最新新闻、...的最新动态
- 研究[主题]、...正在发生什么
- 需要引用的事实核查
- 特定领域搜索(例如:在GitHub上搜索...、在Reddit上查找...)
快速开始
bash
parallel-cli search 你的查询 --json --max-results 5
CLI参考
基本用法
bash
parallel-cli search <目标> [选项]
常用标志
| 标志 | 描述 |
|---|
| -q, --query <关键词> | 添加关键词筛选(可重复,建议3-8个) |
| --max-results N |
结果数量(1-20,默认:10) |
| --json | 以JSON格式输出 |
| --after-date YYYY-MM-DD | 筛选近期内容 |
| --include-domains domain.com | 限定特定域名(可重复,最多10个) |
| --exclude-domains domain.com | 排除域名(可重复,最多10个) |
| --excerpt-max-chars-total N | 限制摘要总字符数(默认:8000) |
示例
基本搜索:
bash
parallel-cli search 联合国是什么时候成立的? --json --max-results 5
带关键词筛选:
bash
parallel-cli search 量子计算最新进展 \
-q 量子 -q 计算 -q 2026 \
--json --max-results 10
限定域名搜索:
bash
parallel-cli search React hooks最佳实践 \
--include-domains react.dev --include-domains github.com \
--json --max-results 5
仅限近期新闻:
bash
parallel-cli search AI监管新闻 \
--after-date 2026-01-01 \
--json --max-results 10
最佳实践提示
目标
用1-3句话描述:
- - 实际任务背景(为什么需要这些信息)
- 时效性要求(优先2026年之后、最新文档)
- 首选来源(官方文档、新闻网站)
关键词查询
添加3-8个关键词查询,包括:
- - 特定术语、版本号、错误字符串
- 常见同义词
- 相关日期术语(2026、2026年1月)
响应格式
返回结构化JSON,包含:
- - search_id — 唯一标识符
- results[] — 结果数组:
- url — 来源URL
- title — 页面标题
- excerpts[] — 相关文本摘要
- publish_date — 发布日期(如有)
输出处理
将结果转化为面向用户的回答时:
- - 尽可能优先使用官方/主要来源
- 仅引用或转述相关的提取文本
- 包含URL + 发布日期以保证透明度
- 如果结果存在分歧,同时呈现并注明差异
上下文不足?
对于长对话,保存结果并使用sessions_spawn:
bash
parallel-cli search <查询> --json -o /tmp/search-<主题>.json
然后生成子代理:
json
{
tool: sessions_spawn,
task: 读取/tmp/search-<主题>.json并综合生成带来源的摘要。,
label: search-summary
}
错误处理
意外错误(网络、解析) |
| 2 | 无效参数 |
| 3 | API错误(非2xx状态码) |
前置条件
- 1. 在parallel.ai获取API密钥
- 安装CLI:
bash
curl -fsSL https://parallel.ai/install.sh | bash
export PARALLELAPIKEY=你的密钥
参考