用途:通过 SEC 13F 申报数据追踪机构投资者(对冲基金、养老金、共同基金等)的持仓变化,识别“聪明钱”流入流出,用于验证投资想法、发现机构增持标的、评估机构减持风险、监测持仓机构支持度、跟踪特定投资者(如巴菲特、Cathie Wood)及板块轮动分析。
主要能力:提供三个脚本。track_institutional_flow.py 按机构持股变化筛选股票,支持 --top、--min-change-percent、--min-market-cap、--sector、--min-institutions、--output、--sort-by 等参数;analyze_single_stock.py 对单只股票做深度分析,含 8 个季度历史趋势、持有人变化、集中度等,支持 --quarters、--compare-to;track_institution_portfolio.py 按 CIK 跟踪特定机构组合,支持 --cik、--name、--top、--min-position-value。输出为结构化 markdown 报告,文件名形如 institutional_flow_analysis_<TICKER/THEME>_<DATE>.md。
使用方式:需 FMP API Key,可设置环境变量 export FMP_API_KEY=your_key_here,或运行时传 --api-key。免费层 250 请求/天,约可分析 20-30 只股票/季度。13F 每季度结束后 45 天内申报。
适用场景:长期投资者(3-12 个月)用于组合季度复盘、板块轮动早期识别、与内部人交易或其他技能组合验证。
限制:13F 有 45 天延迟,仅覆盖管理超 1 亿美元的机构,仅报告多头股票持仓,不含做空、期权、债券,部分持仓可保密延迟;不适用于日内信号、微盘股(市值低于 1 亿美元)或 3 个月以内短线交易;相关性不等于因果,需结合基本面与技术分析。