parallel-web-search

网页搜索

搜索网页，查找：$ARGUMENTS

命令

根据查询选择一个简短且能描述内容的文件名（例如，ai-chip-news、react-vs-vue）。使用小写字母和连字符，不要使用空格。将其代入命令中内联使用——下面的 $FILENAME 和 <keyword> 是占位符，不是 shell 变量；不要逐字复制它们。

parallel-cli search "$ARGUMENTS" -q "<keyword1>" -q "<keyword2>" --json --max-results 10 --excerpt-max-chars-total 27000 -o "/tmp/$FILENAME.json"

以 React 19 相关查询为例：

parallel-cli search "latest React 19 features and adoption" -q "React 19" -q "concurrent rendering" --json --max-results 10 --excerpt-max-chars-total 27000 -o "/tmp/react-19-features.json"

第一个参数是目标——用自然语言描述你要查找的内容。对于宽泛或复杂的查询，它可以用一次调用替代多个关键词搜索。添加 -q 标志，以补充特定关键词查询。-o 标志会将完整结果保存到 JSON 文件中，以便后续提问。

如有需要，可使用以下选项：

• 使用 --after-date YYYY-MM-DD 查询对时效性要求较高的内容
• 使用 --include-domains domain1.com,domain2.com 将结果限制在特定来源
• 使用 --exclude-domains domain.com 过滤掉噪声较多的来源
• 使用 --mode turbo 进行简单的事实查询（此时速度最重要）；支持英文和日文查询
• 使用 --mode fast 在约 1 秒的延迟预算内进行高质量搜索；需要 CLI ≥ 0.9.2，且不保证延迟
• 使用 --mode advanced 处理较难的问题（多步骤、Agent 式搜索）。除非请求需要其他模式，否则保留默认的 basic
• 使用 --location us（ISO 3166-1 alpha-2）获取地理位置定向结果
• 如果先前的响应返回了 session_id，则使用 --session-id "<returned-session-id>" 将相关的 Search/Extract 调用归为一组。session_id 或 search_id 不是 Task 交互 ID 或研究运行 ID；切勿将其发送到研究状态查询、轮询或 --previous-interaction-id

解析结果

将已保存的 -o JSON 文件视为权威数据。 结果数量和摘录长度限制了请求的内容，但标准输出仍可能超过工具的输出限制。被截断的标准输出无法解析为 JSON，也不能证明已保存的结果不完整。对于每个结果，提取：

• 标题、URL，以及在有提供时提取发布日期；省略未知日期
• 摘录中的有用内容（跳过菜单、页脚、“Skip to content”等导航噪声）

呈现结果前，检查退出状态、返回的 API 错误和 warnings。如果发生错误或 results 为空，请说明情况，不要编造答案。旧的输出文件不能证明失败的请求已成功。结果稀疏时，请说明覆盖范围的限制；只有在对用户请求有帮助时，才优化目标或查询。

响应格式

重要：每项断言都必须带有内联引用。 使用 Markdown 链接，例如 标题，且链接仅取自 JSON 输出。切勿编造或猜测 URL。

综合撰写响应，并且：

• 开篇给出关键答案或发现
• 包含具体事实、名称、数字和日期
• 每项事实都以内联引用的形式标注为 来源标题——不得留下未引用的断言
• 涉及多个主题时，按主题组织

最后添加“来源”部分，列出引用过的所有 URL：

Sources:
- [Source Title](https://example.com/article) (Feb 2026)
- [Another Source](https://example.com/other) (Jan 2026)

此“来源”部分为必需内容，不得省略。

仅包含已返回或已在检索内容中核实的来源日期。日期未知时，不要填写。

在“来源”部分之后，注明输出文件路径（/tmp/$FILENAME.json），以便用户在后续提问时使用。

设置

如果找不到 parallel-cli，请安装并完成身份验证：

/parallel:parallel-cli-setup

如果缺少文档中提到的命令或选项，请检查已安装的版本，并通过对应的安装方式升级：独立安装使用 parallel-cli update，pipx 使用 pipx upgrade parallel-web-tools，uv 使用 uv tool upgrade parallel-web-tools，Homebrew 使用 brew upgrade parallel-web/tap/parallel-cli，npm 使用 npm update -g parallel-web-cli。重试前，请在同一个终端中确认帮助信息。

如果遇到身份验证错误，请检查 parallel-cli auth --json 中的 authenticated 布尔值；仅凭退出码为零并不能证明身份验证成功。403 可能表示权限、策略或账单问题。请报告实际错误；仅在确认是账单相关故障时检查余额，未经明确确认，切勿充值。