SuperAPI AI 工具集

parallel-research

写作与研究

查看项目

更新于 10-15 17:11

技能介绍

用途

Parallel Research 用于开展深度网络研究、竞争情报、实体发现与数据丰富,底层调用 Parallel AI 的专用 API。适用于需要快速事实查询、生成综合研究报告、按条件查找公司或人物、以及为已有记录补充字段的场景。

主要能力

该技能按需求分为四类调用路径:

  • 快速事实回答(3-5 秒):Chat API,价格 $0.005/请求,命令为 scripts/parallel_research.py chat "question"。
  • 综合研究报告(5 分钟至 2 小时):Deep Research API,ultra 档为 $0.30/报告,命令为 scripts/parallel_research.py research "topic"。
  • 查找符合标准的实体(公司、人物):FindAll API,价格 $0.03 + $0.10/匹配,命令为 scripts/parallel_research.py findall "query"。
  • 丰富已有数据(为记录添加字段):Task API with schema,core 档为 $0.025/记录,命令为 scripts/parallel_research.py enrich data.csv。

此外还提供简化脚本:

  • python scripts/basic_research.py "Company Name"
  • python scripts/vendor_selection.py "CRM software" --requirements "enterprise,API,automation"

使用方式

环境配置:在 .env 中设置 PARALLEL_API_KEY=your_api_key_here。API 密钥获取地址为 https://platform.parallel.ai/settings/api-keys。

常用命令示例:

  • 快速问答:python scripts/parallel_research.py chat "What is Anthropic's latest funding round?"
  • 深度研究报告:python scripts/parallel_research.py research "Competitive landscape of AI code editors in 2025" --processor ultra
  • 查找公司:python scripts/parallel_research.py findall "AI code editor companies that raised funding in 2024-2025" --limit 50

处理器层级与成本/延迟:

  • lite:$5/1K,10-60 秒,适合基础元数据。
  • base:$10/1K,15-100 秒,适合简单研究。
  • core:$25/1K,1-5 分钟,适合交叉引用研究。
  • pro:$100/1K,2-10 分钟,适合探索性研究。
  • ultra:$300/1K,5-25 分钟,适合深度研究(推荐)。
  • ultra-fast:$300/1K,2-10 分钟,兼顾速度与质量。

成本估算示例:

  • 100 个快速问题(Chat):$0.50。
  • 市场研究报告(Deep Research ultra):$0.30。
  • 查找 50 个竞争对手(FindAll core):约 $5.00。
  • 丰富 100 条线索(Task core):$2.50。

免费额度:全部 API 合计 20,000 次免费请求。

适用场景

  • 市场调研与竞争情报。
  • 按条件发现公司或人物实体。
  • 为 CRM 或表格填充与补充数据。

集成模式(资料中给出):

  • Research to Report:parallel-research → content-generation,从研究发现生成结构化报告并排版为品牌文档。
  • FindAll to CRM:parallel-research → attio-crm,用 FindAll 发现公司、丰富数据并写入 Attio CRM。
  • Research to Sheets:parallel-research → google-workspace,对多个实体批量研究,整理为表格并上传 Google Sheets。

限制与安全

  • 研究查询会发送至 Parallel AI 服务器,结果可能包含第三方公司信息,结果本地存储在 .tmp/ 目录,Parallel AI 可能记录查询用于服务改进;应避免在查询中包含敏感内部数据。
  • API 密钥提供对所有研究端点的完整访问,无细粒度权限范围;需通过仪表盘监控用量与成本。
  • 研究来源为公开网络来源,输出应引用来源并验证准确性;竞争情报需符合相关政策;应尊重第三方数据知识产权;结果可能包含公司或个人 PII;对时效性信息需核实数据新鲜度。
  • 常见问题涵盖处理器超时、额度耗尽、响应格式错误、结果为空或不相关、认证失败、限流等,并给出对应处理方式,如使用更低成本处理器、简化查询、拆分请求、检查余额、重试、重新生成密钥、增加请求间隔或指数退避等。

参考资料包括 references/api-guide.md、references/basic-research.md、references/vendor-selection.md。