用途:通过 SEC 13F 申报追踪机构投资者(对冲基金、养老金、共同基金等)的季度持仓变化,识别资金流入流出,用于验证投资想法、发现机构增持标的、评估机构减持风险、监控持仓机构支持度及板块轮动。
主要能力:track_institutional_flow.py 按机构持股变化、市值、板块、机构数量等条件筛选股票,输出持股比例、环比变化、机构数量变化及主要持有人;analyze_single_stock.py 对单只股票做深度分析,生成 8 个季度历史趋势、前 20 大持有人及仓位变化、集中度分析,并给出基于覆盖度的 A/B/C 可靠性评级(A:有可比上季度且机构持有人≥50;B:≥10;C:无可比季度或<10,筛选时自动排除)。
使用方式:需设置 FMP_API_KEY 环境变量或通过 --api-key 传入,依赖 pip install requests,Python 3.9+。示例:python3 scripts/track_institutional_flow.py --top 50 --min-change-percent 10;python3 scripts/analyze_single_stock.py AAPL。报告以 markdown 保存,文件名形如 institutional_flow_analysis_<TICKER/THEME>_<DATE>.md。
适用场景:长期投资者(3-12 个月)验证聪明钱是否认同、发现机构增持机会、季度持仓复查、板块轮动早期识别、与价值股息筛选器或技术分析等技能组合使用。
限制:13F 有 45 天申报滞后,仅覆盖管理超 1 亿美元的机构,只报告多头股票持仓(不含空头、期权、债券),为季度末快照,部分持仓可能保密延迟;不适用于日内或 3 个月以内短线信号,也不适合机构关注度低的微盘股。track_institution_portfolio.py 尚未实现,无法按机构重建完整组合,需借助 WhaleWisdom、SEC EDGAR、DataRoma 等外部资源。相关性不等于因果,应结合基本面与市场环境综合判断。