核心用法
investment-brief-generator 是一款面向股票投资者的智能分析工具，通过调用 Tavily AI 搜索 API，自动生成结构化的个股投资简报。用户可通过 CLI 执行三种核心操作：
1. 个股深度分析：--stock 参数指定股票代码（如 A 股 002837）及名称，生成包含实时价格、估值水平、技术形态的综合报告
2. 市场热点追踪：--market 模式自动扫描当日市场热点板块与资金流向
3. 持仓股监控：--portfolio 模式支持多股票批量监控，可自定义提醒价位
输出为标准 Markdown 格式，涵盖股票基本信息（价格、涨跌幅、成交量）、技术面分析（支撑/阻力位）、基本面亮点、市场情绪及操作建议五大模块，便于存档分享或二次编辑。
显著优点
- 零门槛部署：单 Node.js 脚本运行，无需复杂环境配置
- AI 驱动数据：依托 Tavily 搜索引擎获取实时市场信息，避免手动爬取数据的合规风险
- 多市场覆盖：明确支持 A 股、港股、美股三大市场
- 格式化输出：Markdown 简报结构清晰，可直接用于投资笔记或社群分享
- 开源透明：MIT 协议，代码可审计，无黑箱算法
潜在缺点与局限性
- 数据源依赖：核心功能完全依赖 Tavily API，若服务中断或额度耗尽则失效；Tavily 本身为搜索聚合引擎，非专业金融数据商，数据准确性未经权威验证
- 分析深度有限：简报为模板化生成，缺乏对财报细节的逐行拆解，重大投资决策需人工复核
- 实时性约束：搜索式数据存在分钟级延迟，高频交易场景不适用
- 地域合规风险：A 股实时数据需确认 Tavily 来源是否具备合法资质，用户可能面临数据使用合规性问题
- 无回测验证：未提供历史策略回测功能，无法量化报告有效性
适合人群
- 个人投资者希望快速获取股票多维度快照，建立初步研究框架
- 投资社群运营者需要批量生成标准化分析素材
- 对编程有基础认知、愿意配置 API Key 的技术型用户
常规风险
- API 密钥泄露：Tavily API Key 存储于本地环境变量，共享环境或日志输出可能导致密钥外泄
- 投资建议免责：AI 生成内容含"操作建议"模块，可能被误解为投资建议，用户需明确工具不具备投资咨询资质
- 数据过时风险：市场瞬息万变，依赖搜索缓存的数据可能导致决策滞后
- 供应商锁定：深度使用后难以迁移至其他数据源，存在服务连续性风险