parallel-research

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Parallel Research

Overview

概述

Deep web research, competitive intelligence, entity discovery, and data enrichment using Parallel AI's specialized APIs.

借助Parallel AI的专用API实现深度网页调研、竞品情报收集、实体发现以及数据增强。

Quick Decision Tree

快速决策树

What do you need?
│
├── Quick factual answer (3-5 seconds)
│   └── Chat API ($0.005/request)
│   └── Script: scripts/parallel_research.py chat "question"
│
├── Comprehensive research report (5min-2hr)
│   └── Deep Research API ($0.30/report for ultra)
│   └── Script: scripts/parallel_research.py research "topic"
│
├── Find entities matching criteria (companies, people)
│   └── FindAll API ($0.03 + $0.10/match)
│   └── Script: scripts/parallel_research.py findall "query"
│
└── Enrich existing data (add fields to records)
    └── Task API with schema ($0.025/record for core)
    └── Script: scripts/parallel_research.py enrich data.csv

你需要什么？
│
├── 快速事实问答（3-5秒）
│   └── Chat API（每请求$0.005）
│   └── 脚本：scripts/parallel_research.py chat "问题"
│
├── 全面研究报告（5分钟-2小时）
│   └── Deep Research API（ultra版每份报告$0.30）
│   └── 脚本：scripts/parallel_research.py research "主题"
│
├── 查找符合条件的实体（企业、人物）
│   └── FindAll API（$0.03 + 每个匹配项$0.10）
│   └── 脚本：scripts/parallel_research.py findall "查询语句"
│
└── 增强现有数据（为记录添加字段）
    └── 带Schema的Task API（core版每条记录$0.025）
    └── 脚本：scripts/parallel_research.py enrich data.csv

Environment Setup

环境配置

bash

undefined

bash

undefined

Required in .env

.env文件中需配置

PARALLEL_API_KEY=your_api_key_here


Get your API key: https://platform.parallel.ai/settings/api-keys

PARALLEL_API_KEY=your_api_key_here


获取API密钥：https://platform.parallel.ai/settings/api-keys

Common Usage

常见用法

Quick Q&A

快速问答

bash

python scripts/parallel_research.py chat "What is Anthropic's latest funding round?"

bash

python scripts/parallel_research.py chat "Anthropic最新一轮融资情况如何？"

Deep Research Report

深度研究报告

bash

python scripts/parallel_research.py research "Competitive landscape of AI code editors in 2025" --processor ultra

bash

python scripts/parallel_research.py research "2025年AI代码编辑器的竞争格局" --processor ultra

Find Companies

查找企业

bash

python scripts/parallel_research.py findall "AI code editor companies that raised funding in 2024-2025" --limit 50

bash

python scripts/parallel_research.py findall "2024-2025年间获得融资的AI代码编辑器企业" --limit 50

Basic Research (Simplified)

基础调研（简化版）

bash

python scripts/basic_research.py "Company Name"

bash

python scripts/basic_research.py "企业名称"

Vendor Selection

供应商选择

bash

python scripts/vendor_selection.py "CRM software" --requirements "enterprise,API,automation"

bash

python scripts/vendor_selection.py "CRM软件" --requirements "企业级,API,自动化"

Processor Tiers

处理器层级

Processor	Cost/1K	Latency	Best For
`lite`	$5	10-60s	Basic metadata
`base`	$10	15-100s	Simple research
`core`	$25	1-5min	Cross-referenced research
`pro`	$100	2-10min	Exploratory research
`ultra`	$300	5-25min	Deep research (recommended)
`ultra-fast`	$300	2-10min	Speed + quality

处理器	每千次调用成本	延迟	适用场景
`lite`	$5	10-60秒	基础元数据
`base`	$10	15-100秒	简单调研
`core`	$25	1-5分钟	交叉验证调研
`pro`	$100	2-10分钟	探索性调研
`ultra`	$300	5-25分钟	深度调研（推荐）
`ultra-fast`	$300	2-10分钟	速度与质量兼顾

Cost Estimates

成本估算

Task	API	Cost
100 quick questions	Chat	$0.50
Market research report	Deep Research (ultra)	$0.30
Find 50 competitors	FindAll (core)	~$5.00
Enrich 100 leads	Task (core)	$2.50

任务	API	成本
100次快速问答	Chat	$0.50
市场调研报告	Deep Research（ultra版）	$0.30
查找50家竞品	FindAll（core版）	~$5.00
增强100条销售线索	Task（core版）	$2.50

Free Tier

免费额度

20,000 requests free (combined across all APIs).

所有API合计提供20,000次免费调用。

Security Notes

安全说明

Credential Handling

凭证处理

Store
```
PARALLEL_API_KEY
```
in
```
.env
```
file (never commit to git)
Regenerate keys at https://platform.parallel.ai/settings/api-keys
Never log or print API keys in script output
Use environment variables, not hardcoded values

将
```
PARALLEL_API_KEY
```
存储在
```
.env
```
文件中（绝不要提交到git）
在https://platform.parallel.ai/settings/api-keys重新生成密钥
绝不要在脚本输出中记录或打印API密钥
使用环境变量，而非硬编码值

Data Privacy

数据隐私

Research queries are sent to Parallel AI servers
Research outputs may contain third-party company information
Results are stored locally in
```
.tmp/
```
directory
Parallel AI may log queries for service improvement
Avoid including sensitive internal data in research queries

调研查询会发送至Parallel AI服务器
调研输出可能包含第三方企业信息
结果本地存储在
```
.tmp/
```
目录中
Parallel AI可能会记录查询以优化服务
避免在调研查询中包含敏感内部数据

Access Scopes

访问权限

API key provides full access to all research endpoints
No granular permission scopes available
Monitor usage and costs via Parallel AI dashboard

API密钥可访问所有调研端点的完整权限
暂无细粒度权限范围设置
通过Parallel AI控制台监控使用情况和成本

Compliance Considerations

合规注意事项

Data Sources: Research pulls from public web sources
Citation: Always cite sources in research outputs
Accuracy: AI-generated research should be verified
Competitive Intel: Ensure competitive research complies with policies
Third-Party Data: Respect intellectual property of sources
PII in Results: Research results may contain company/individual PII
Data Freshness: Verify currency of time-sensitive information

数据来源：调研数据来自公开网络资源
引用规范：调研输出中需始终注明来源
准确性：AI生成的调研内容需进行验证
竞品情报：确保竞品调研符合相关政策
第三方数据：尊重来源的知识产权
结果中的个人可识别信息（PII）：调研结果可能包含企业/个人的PII
数据时效性：验证时间敏感信息的时效性

Troubleshooting

故障排查

Common Issues

常见问题

Issue: Processor timeout

问题：处理器超时

Symptoms: Request times out or returns partial results Cause: Complex query requiring more processing time than allowed Solution:

Use a faster processor tier (
```
lite
```
or
```
base
```
instead of
```
ultra
```
)
Simplify the research query
Break complex queries into multiple smaller requests
Increase timeout in script if configurable

症状：请求超时或返回部分结果原因：复杂查询所需处理时间超过允许范围 解决方案：

使用更快的处理器层级（用
```
lite
```
或
```
base
```
替代
```
ultra
```
）
简化调研查询
将复杂查询拆分为多个较小的请求
若可配置，增加脚本中的超时时间

Issue: Credits exhausted

问题：额度耗尽

Symptoms: "Insufficient credits" or quota error Cause: Account credits depleted Solution:

Check balance at https://platform.parallel.ai/dashboard
Upgrade plan or purchase additional credits
Use lower-cost processor tiers for less critical queries
Monitor usage to avoid unexpected depletion

症状：出现“额度不足”或配额错误原因：账户额度已用尽 解决方案：

在https://platform.parallel.ai/dashboard查看余额
升级套餐或购买额外额度
对非关键查询使用低成本处理器层级
监控使用情况以避免意外耗尽

Issue: Invalid response format

问题：响应格式无效

Symptoms: JSON parsing error or unexpected response structure Cause: API returned error or malformed response Solution:

Check query format matches API requirements
Retry the request (may be transient issue)
Verify API key is valid and active
Review API documentation for expected response format

症状：JSON解析错误或响应结构不符合预期原因：API返回错误或格式错误的响应 解决方案：

检查查询格式是否符合API要求
重试请求（可能是临时问题）
验证API密钥是否有效且处于激活状态
查看API文档了解预期响应格式

Issue: Empty or irrelevant results

问题：结果为空或不相关

Symptoms: Research returns no results or off-topic content Cause: Query too narrow, ambiguous, or poorly structured Solution:

Broaden the search query
Add context to clarify query intent
Try different phrasing or keywords
Use Chat API first to validate query understanding

症状：调研无结果或内容偏离主题原因：查询范围过窄、模糊或结构不合理 解决方案：

扩大搜索查询范围
添加上下文以明确查询意图
尝试不同的表述或关键词
先使用Chat API验证查询是否被正确理解

Issue: API authentication failed

问题：API认证失败

Symptoms: "Invalid API key" or 401 error Cause: API key expired, invalid, or not set Solution:

Regenerate key at https://platform.parallel.ai/settings/api-keys
Verify
```
PARALLEL_API_KEY
```
is set correctly in
```
.env
```
Check for leading/trailing whitespace in key
Ensure key has not been revoked

症状：出现“无效API密钥”或401错误原因：API密钥过期、无效或未设置 解决方案：

在https://platform.parallel.ai/settings/api-keys重新生成密钥
验证
```
.env
```
文件中
```
PARALLEL_API_KEY
```
是否配置正确
检查密钥是否存在首尾空格
确认密钥未被撤销

Issue: Rate limited

问题：请求频率受限

Symptoms: 429 error or "rate limit exceeded" Cause: Too many concurrent requests Solution:

Add delays between requests
Reduce parallel request count
Implement exponential backoff
Contact support for higher rate limits if needed

症状：出现429错误或“请求频率超出限制” 原因：并发请求过多 解决方案：

在请求之间添加延迟
减少并行请求数量
实现指数退避机制
若需要，联系支持团队提高频率限制

Resources

资源

references/api-guide.md - Complete API documentation
references/basic-research.md - Simple company research
references/vendor-selection.md - Vendor comparison workflow

references/api-guide.md - 完整API文档
references/basic-research.md - 简单企业调研指南
references/vendor-selection.md - 供应商对比工作流

Integration Patterns

集成模式

Research to Report

调研转报告

Skills: parallel-research → content-generation Use case: Create polished reports from research findings Flow:

Run deep research on topic/company
Generate structured research output
Format into branded document via content-generation

技能组合：parallel-research → content-generation 使用场景：基于调研结果生成精美的报告流程：

对主题/企业进行深度调研
生成结构化调研输出
通过content-generation格式化为品牌化文档

FindAll to CRM

FindAll转CRM

Skills: parallel-research → attio-crm Use case: Populate CRM with discovered companies Flow:

Use FindAll to discover companies matching criteria
Enrich each company with additional data
Create/update company records in Attio CRM

技能组合：parallel-research → attio-crm 使用场景：将发现的企业信息导入CRM系统流程：

使用FindAll发现符合条件的企业
为每家企业补充额外数据
在Attio CRM中创建/更新企业记录

Research to Sheets

调研转表格

Skills: parallel-research → google-workspace Use case: Build research database in Google Sheets Flow:

Run FindAll or batch research on multiple entities
Structure results as tabular data
Upload to Google Sheets for team collaboration

技能组合：parallel-research → google-workspace 使用场景：在Google Sheets中构建调研数据库流程：

对多个实体执行FindAll或批量调研
将结果整理为表格数据
上传至Google Sheets供团队协作使用