总安装量 2
评分人数 2
核心用法
valyu-search 是 Valyu AI 平台的官方命令行工具，提供四大核心能力：
1. Search API：支持网络搜索（web）、新闻检索（news）、学术文献（arXiv/PubMed）、金融数据（股票）、专利等多源数据查询，可指定时间范围、地区、来源过滤等参数。
2. Contents API：将任意网页 URL 转换为结构化 Markdown 或自定义 JSON 格式，支持内容摘要和深度提取。
3. Answer API：基于实时搜索结果生成带引用的 AI 回答，确保信息可溯源。
4. DeepResearch API：异步执行多步骤深度研究，提供 fast（5分钟）、standard（10-20分钟）、heavy（90分钟）三种模式，输出 Markdown 或 PDF 报告。
显著优点
- 多源权威数据：整合 arXiv、PubMed、SEC filings、USPTO 专利、WHO 健康数据等专业数据库，超越普通搜索引擎。
- 零外部依赖：仅使用 Node.js 内置模块，无 npm 依赖，供应链攻击风险极低。
- 灵活输出格式：支持结构化 JSON、Markdown、PDF 等多种格式，适配自动化工作流。
- 异步深度研究：heavy 模式可执行长达 90 分钟的复杂分析，适合专业调研场景。
- 官方维护：Valyu 平台官方集成，文档完善，API 稳定性有保障。
潜在缺点与局限性
- API 密钥成本：依赖 Valyu 商业 API，高频使用可能产生费用。
- 网络依赖性强：所有功能需连接 api.valyu.ai，离线不可用，且无代理配置支持。
- 无本地缓存：重复查询不会复用结果，可能增加 API 调用成本。
- 输入验证薄弱：URL 参数无格式校验，存在潜在 SSRF 风险；JSON 解析缺乏错误包装。
- 超时机制缺失：fetch 请求未设置超时，网络异常时可能长时间挂起。
适合的目标群体
- 科研人员：需要检索 arXiv、PubMed 等学术数据库，生成带引用的文献综述。
- 金融分析师：查询股票数据、SEC 文件，进行市场趋势深度研究。
- 咨询与智库：执行 heavy 模式的行业研究报告，输出 PDF 交付物。
- 内容创作者：快速提取网页内容、核实事实、获取多源信息。
- 开发者：通过命令行集成搜索能力到自动化脚本或 CI/CD 流程。
使用风险
- API 密钥泄露风险：密钥以明文存储于 ~/.valyu/config.json，共享环境需手动设置 0o600 权限。
- 数据隐私：搜索查询和上传文件会传输至 Valyu 服务器，敏感信息需谨慎处理。
- 服务可用性：完全依赖 Valyu API 稳定性，无降级方案。
- 研究质量波动：AI 生成的 DeepResearch 报告可能存在幻觉，需人工核实关键结论。
scripts