crewAI-examples 股票分析示例｜多Agent协作生成股票研究报告

这是 CrewAI 官方示例仓库中的一个股票分析示例（路径 crews/stock_analysis），用 CrewAI 框架把几个扮演不同角色的 AI Agent 串起来，按顺序完成一次股票研究：财务分析师看财务指标和行业对比，研究员收集新闻、公告与市场情绪，再由投资顾问角色汇总成一份带立场和理由的报告。

需要先说明两点：其一，该仓库已归档，属于示例性质，不承诺持续维护，依赖版本、工具接口与兼容性均待核验；其二，它是一个需要自己安装依赖、配置密钥、改代码才能跑起来的多 Agent 示例程序，不是打开网页就能用的 SaaS 产品。

运行后按提示输入要分析的公司股票代码，流程大致为：财务分析任务（市盈率、每股收益增长、营收趋势、负债权益比等，并与同业和整体市场比较）→ 研究任务（近期新闻、新闻稿、分析师观点、即将到来的财报事件）→ 财报文件任务（读取 EDGAR 上的 10-Q 与 10-K，关注管理层讨论、财务报表、内部人交易与风险披露）→ 汇总给出投资建议报告。

输入：公司股票代码，以及所配置模型和检索、SEC 接口所需的密钥。输出：一份结构化的中文或英文研究报告文本（取决于模型与提示词配置），内容包括财务健康评估、市场情绪、财报要点和内部人交易活动。

输出仅为研究草稿，不能替代专业投资建议；涉及财务与法务判断须由具备资质的人员复核，不应据此自动做出投资或交易决定。示例中的网页抓取与搜索工具需要相应授权，不要用于未获许可的站点。

官方来源：https://github.com/crewAIInc/crewAI-examples/blob/da94a91e691e1cf5b3151416bb15b5b62729bea8/crews/stock_analysis/README.md

作者/维护方：crewAIInc/crewAI-examples。采集日期：2026-11-13；依据官方资料经AI整理，未安装、运行或实测。

许可说明：README 写作 MIT，仓库元数据标注未声明，存在冲突，再分发前须核实，不得假定允许。具体子目录、依赖、模型和在线服务各自适用其条款。本站提供原创说明和来源入口，不随本文分发源码或凭据。

适合想学习多 Agent 编排、任务拆解与工具调用的开发者，或想了解“AI 辅助证券研究流程长什么样”的研究者。不适合把它当成投资决策工具直接使用。

1. 获取仓库代码（仓库已归档，链接与可用性待核验）。
2. 按 README 准备环境变量：需要 Browserless、Serper、SEC-API 与 OpenAI 的密钥，复制 .env.example 后填写。
3. 安装依赖：README 给出的是 poetry install --no-root。
4. 运行：poetry run python3 main.py，需在包含 main.py 的目录下执行。

项目声明要求 Python 3.12 至 3.13，依赖 crewai[tools]、python-dotenv、html2text、sec-api 等，具体版本以仓库配置文件为准。

README 说明默认使用 GPT-4，会产生费用；也可在创建 Agent 时传入其他模型，文档给出 GPT-3.5 与本地 Ollama 两种改法。注意仓库里的 crew.py 实际把模型实例写死为某个 Ollama 模型，且部分 Agent 的 SEC 工具参数写死了符号，直接运行可能与 README 描述不一致，需要自行调整，这一点属于代码与文档存在出入，实际效果未实测。

使用云端模型和第三方检索、SEC 数据接口都会产生费用，具体价格待核查；国内访问相关 API 的可用性待核查。SEC 数据针对美国上市公司，其他市场不适用。项目许可在 README 中写作 MIT，但仓库元数据标注“未声明”，两者冲突，再分发前须核实，不得假定允许。