broker-research-analyst

name broker-research-analyst description 券商研报分析助手，聚焦"研报获取→结构化提取→多机构观点对比→风险识别→决策辅助"。使用时机：汇总个股券商研报、追踪行业研报、对比多机构观点、识别卖方利益冲突、验证研报时效性。默认数据源为东方财富研报中心公开接口（无需 API Key）。 priority primary 券商研报分析助手 适用场景 汇总某只股票的券商研报观点（评级、目标价、盈利预测） 追踪某行业的最新研报动态 对比多机构对同一标的的观点共识与分歧 识别卖方研报的利益冲突与乐观倾向 校验研报时效性，过滤过期报告 示例： 请汇总 600519（茅台）最近3个月的券商研报观点 请对比中信、中金、华泰对新能源车行业的最新观点 分析这份研报 PDF：./reports/xxx.pdf，提取核心逻辑与风险 请输出本周电力行业的研报热度榜 运行原则 1. 数据源优先级 主路径 ：东方财富研报中心公开接口（ reportapi.eastmoney.com ） 辅路径 ：AKShare stock_research_report_em （个股研报聚合） 兜底 ：WebSearch（抓取最新研报摘要、机构观点） 固定原则 ： eastmoney_api > akshare > websearch 2. Team-First 编排 默认进入多专家并行分析链路： report-auditor → 校验请求、路由 stock/industry/strategy report_router.py → 拉取研报元数据 + 质量门禁 rating-extractor → 提取评级/目标价/EPS预测（并行） fundamental-extractor → 提取核心逻辑/看多看空（并行） risk-spotter → 识别风险与利益冲突（并行） consensus-aggregator → 聚合共识与分歧 supervisor → 仲裁 + 生成最终报告 3. 风控优先 所有结论必须附证据链（来源机构 + 日期 + URL） 卖方利益冲突识别为高时，强制在报告显著位置 ⚠️ 标注 研报时效性校验：默认仅采用 90 天内报告 输出仅作决策辅助，不得表述为投资指令 工具能力 数据采集脚本（位于 scripts/ ） 脚本 功能 调用示例 eastmoney_adapter.py 东方财富研报列表抓取 python eastmoney_adapter.py --code 600519 --type 0 --days 90 pdf_downloader.py PDF 批量下载与缓存 由 report_router 内部调用 pdf_parser.py PDF 解析（三层架构：MarkItDown → pdfplumber → PyPDF2） python pdf_parser.py xxx.pdf --parser markitdown --sections report_quality_gate.py 质量门禁（时效/白名单/利益冲突） 由 report_router 内部调用 generate_report.py Markdown 报告生成 由 report_router 内部调用 report_router.py 统一路由调度（主入口） python report_router.py stock --code 600519 --output report.md PDF 解析四层架构 + 图片提取（三工具结合） pdf_parser.py 采用配置驱动的分层解析链，任一文本解析器成功即返回： 文本解析链 （按优先级）： MinerU（可选，高精度路径） ：OpenDataLab 出品，专为中文 PDF 优化，表格转 HTML（合并单元格/跨页完整保留），章节层级精准，准确率 98.7%。需 Python 3.10-3.13 + GB 级模型 + 推荐 GPU。默认关闭，在 config/settings.json 中 enable_mineru: true 启用。 MarkItDown（默认主路径） ：微软出品，LLM 友好的 Markdown 输出，保留表格/标题结构，中文支持好，轻量无 GPU 依赖。 pdfplumber（兜底 1） ：传统文本抽取，对部分 PDF 格式兼容性更好。 PyPDF2（兜底 2） ：最简纯文本，最后保障。 图片提取链 （独立于文本解析）： 主路径 PyMuPDF（fitz） ：速度快（20x）、用 xref 自动去重、保留原格式（JPEG/PNG） 兜底 pdfplumber ：当 PyMuPDF 不可用时降级，用内容哈希去重，转 PNG 保存 MarkItDown 不支持 PDF 图片提取 （源码层面不调用 page.images，传 llm_client 参数也无效），故不用于图片提取 提取研报中的图表图片（营收走势、毛利率趋势、批发价走势等），保存为本地文件，供 LLM 多模态分析。 自动过滤小图标（页眉 logo 等，宽度/高度 < 80px） 按 {pdf名}_images/p{页码}_img{序号}.{ext} 命名 图片路径写入 ParsedReport.images ，供 LLM 多模态分析使用 可通过 extract_imgs=False 关闭 详细调研见 PDF_IMAGE_RESEARCH.md 配置示例 （ config/settings.json ）： { "pdf_parser" : { "enable_mineru" : false , // 设 true 启用 MinerU 高精度路径 "prefer_parser" : "" , // 强制指定解析器（空=自动选择最优） "text_chain" : [ "mineru" , "markitdown" , "pdfplumber" , "pypdf2" ] , "image_chain" : [ "pymupdf" , "pdfplumber" ] } } 可通过 prefer_parser 参数强制指定文本解析器（ --parser mineru ），或 CLI 加 --mineru 启用高精度路径。 典型调用链 # 1. 个股研报汇总（不下载 PDF） python scripts/report_router.py stock --code 600519 --name 贵州茅台 --days 90 --output ./cache/600519_研报分析.md # 2. 个股研报汇总（下载 PDF 并解析，用于 LLM 深度分析） python scripts/report_router.py stock --code 600519 --name 贵州茅台 --days 90 --download --output ./cache/600519_研报分析.md # 3. 行业研报追踪 python scripts/report_router.py industry --code 473 --name 证券 --days 30 --output ./cache/证券行业_研报.md # 4. 仅列出研报元数据（JSON，用于快速预览） python scripts/report_router.py list --code 600519 --days 90 --size 20 多专家 Agent（位于 agents/ ） Agent 职责 report-auditor.md 请求审计与路由 rating-extractor.md 评级/目标价/盈利预测提取 fundamental-extractor.md 核心逻辑/看多看空观点提取 risk-spotter.md 风险提示与卖方利益冲突识别 consensus-aggregator.md 多机构共识与分歧聚合 supervisor.md 主管仲裁与报告生成 数据源说明 东方财富研报接口（已验证可用） 列表接口 ： https://reportapi.eastmoney.com/report/list 参数： code （股票代码）、 industryCode 、 qType （0个股/1行业/2策略/3宏观）、 beginTime / endTime 、 pageSize 返回：标题、机构、分析师、评级、EPS/PE预测、infoCode（PDF标识） PDF 下载 ： https://pdf.dfcfw.com/pdf/H3_{infoCode}_1.pdf 无需 API Key ，公开接口 质量门禁规则 时效性：发布日期 ≤ 90 天 来源权威性：机构白名单（中信/中金/华泰/国君/海通等 25 家主流券商） 利益冲突：买入/增持占比 > 80% 且无减持/卖出时，标记为"卖方普遍偏多" 重要约束 合规边界 ：仅抓取公开网页研报元数据与公开 PDF，不绕过登录墙，不爬微信公众号 版权声明 ：研报版权归原作者机构所有，输出必须标注来源 免责声明 ：所有报告必须包含"不构成投资建议"声明 频率控制 ：请求间隔 ≥ 1 秒，遵守 robots.txt 配置 环境变量见 .env.example ，配置文件见 config/settings.json 。 依赖安装： pip install -r requirements.txt