institutional-flow-tracker by tradermonty/claude-trading-skills
npx skills add https://github.com/tradermonty/claude-trading-skills --skill institutional-flow-tracker本技能通过分析 13F SEC 文件来追踪机构投资者的活动,识别流入和流出股票的“聪明钱”。通过分析机构持股的季度变化,您可以在主要价格变动之前发现老练投资者正在积累的股票,或在机构减持时识别潜在风险。
核心洞察: 机构投资者(对冲基金、养老基金、共同基金)管理着数万亿美元的资金并进行广泛研究。他们的集体买卖模式通常领先于显著的价格变动 1-3 个季度。
FMP_API_KEY 环境变量或向脚本传递 --api-keypip install requests(脚本会优雅地处理缺失的依赖项)在以下情况使用此技能:
不要在以下情况使用:
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
此技能使用 Financial Modeling Prep (FMP) API 来访问 13F 文件数据:
设置:
# 设置环境变量(推荐)
export FMP_API_KEY=your_key_here
# 或者在运行脚本时提供
python3 scripts/track_institutional_flow.py --api-key YOUR_KEY
API 层级要求:
13F 文件提交时间表:
执行主要筛选脚本,以发现具有显著机构活动的股票:
快速扫描(按机构变化排名前 50 的股票):
python3 scripts/track_institutional_flow.py \
--top 50 \
--min-change-percent 10
聚焦特定板块的扫描:
python3 scripts/track_institutional_flow.py \
--sector Technology \
--min-institutions 20
自定义筛选:
python3 scripts/track_institutional_flow.py \
--min-market-cap 2000000000 \
--min-change-percent 15 \
--top 100 \
--output institutional_flow_results.json
输出包括:
对特定股票的机构持股进行详细分析:
python3 scripts/analyze_single_stock.py AAPL
这将生成:
需要评估的关键指标:
注意:
track_institution_portfolio.py尚未实现。FMP API 按股票(而非按机构)组织机构持有人数据,仅通过此 API 重建完整投资组合是不切实际的。
替代方法 — 使用 analyze_single_stock.py 检查特定机构是否持有某只股票:
# 分析一只股票,并在输出中查找特定机构
python3 institutional-flow-tracker/scripts/analyze_single_stock.py AAPL
# 然后在报告中搜索前 20 大持有人表格中的 "Berkshire" 或 "ARK"
要进行完整的机构层面投资组合追踪,请使用以下外部资源:
阅读参考资料以获取解读指导:
references/13f_filings_guide.md - 了解 13F 数据及其局限性references/institutional_investor_types.md - 不同类型的投资者及其策略references/interpretation_framework.md - 如何解读机构资金流向信号信号强度框架:
强烈看涨(考虑买入):
中度看涨:
中性:
中度看跌:
强烈看跌(考虑卖出/避免):
对于新仓位:
对于现有持仓:
筛选工作流程集成:
所有分析都会生成结构化的 Markdown 报告,并保存到仓库根目录:
文件名约定: institutional_flow_analysis_<股票代码/主题>_<日期>.md
报告章节:
所有分析现在都包含基于数据质量的可靠性评级:
筛选脚本 (track_institutional_flow.py) 会自动排除 C 级股票。单只股票分析 (analyze_single_stock.py) 会显示评级并给出相应警告。
为什么这很重要: FMP 每个季度返回的持有人数量不同。一只股票可能在 Q4 显示有 5,415 个持有人,但在 Q3 只有 201 个。如果不进行过滤,汇总指标会产生误导性的百分比变化(例如,+400%)。数据质量模块会过滤到“真实”持有人(两个季度均存在),以生成可靠的指标。
数据延迟:
覆盖范围:
报告规则:
解读:
内幕人士 + 机构组合:
板块轮动检测:
逆向操作:
聪明钱验证:
references/ 文件夹包含详细指南:
用于寻找机构持股发生显著变化的股票的主要筛选脚本。
必需:
--api-key:FMP API 密钥(或设置 FMP_API_KEY 环境变量)可选:
--top N:按机构变化返回前 N 只股票(默认:50)--min-change-percent X:机构持股的最小百分比变化(默认:10)--min-market-cap X:最小市值(美元)(默认:10亿)--sector NAME:按特定板块筛选--min-institutions N:机构持有人的最小数量(默认:10)--limit N:从筛选器中获取的股票数量(默认:100)。较低的值可以节省 API 调用。--output FILE:输出 JSON 文件路径--output-dir DIR:报告的输出目录(默认:reports/)--sort-by FIELD:按 'ownership_change' 或 'institution_count_change' 排序对特定股票的机构持股进行深入分析。
必需:
--api-key:FMP API 密钥(或设置 FMP_API_KEY 环境变量)可选:
--quarters N:要分析的季度数(默认:8,即 2 年)--output FILE:输出 Markdown 报告路径--output-dir DIR:报告的输出目录(默认:reports/)--compare-to TICKER:将机构持股与另一只股票进行比较(未来功能)状态:尚未实现
此脚本是一个占位符。它会打印替代资源(WhaleWisdom、SEC EDGAR、DataRoma)并以错误代码 1 退出。FMP API 按股票(而非按机构)组织机构持有人数据,使得完全重建投资组合不切实际。
要进行机构特定的投资组合追踪,请使用:
由 track_institutional_flow.py 和 analyze_single_stock.py 共享的实用工具模块:
价值股息筛选器 + 机构资金流向:
1. 运行价值股息筛选器以寻找候选股票
2. 对每个候选股票检查机构资金流向
3. 优先考虑机构持股上升的股票
美股分析 + 机构资金流向:
1. 运行全面的基本面分析
2. 用机构持股趋势进行验证
3. 如果机构正在卖出,调查原因
投资组合管理器 + 机构资金流向:
1. 通过 Alpaca 获取当前投资组合
2. 对每个持仓进行机构分析
3. 标记机构支持恶化的仓位
4. 考虑从派发中重新平衡
技术分析师 + 机构资金流向:
1. 识别技术形态(例如,突破)
2. 检查机构买入是否确认
3. 如果两者一致,则信心更高
注意: 此技能专为长期投资者(3-12 个月时间范围)设计。对于短期交易,请结合技术分析和其他动量指标。
每周安装次数
180
代码仓库
GitHub 星标数
394
首次出现
2026年1月26日
安全审计
安装于
gemini-cli167
cursor166
opencode166
codex162
github-copilot160
kimi-cli158
This skill tracks institutional investor activity through 13F SEC filings to identify "smart money" flows into and out of stocks. By analyzing quarterly changes in institutional ownership, you can discover stocks that sophisticated investors are accumulating before major price moves, or identify potential risks when institutions are reducing positions.
Key Insight: Institutional investors (hedge funds, pension funds, mutual funds) manage trillions of dollars and conduct extensive research. Their collective buying/selling patterns often precede significant price movements by 1-3 quarters.
FMP_API_KEY environment variable or pass --api-key to scriptspip install requests (scripts handle missing dependencies gracefully)Use this skill when:
Do NOT use when:
This skill uses Financial Modeling Prep (FMP) API to access 13F filing data:
Setup:
# Set environment variable (preferred)
export FMP_API_KEY=your_key_here
# Or provide when running scripts
python3 scripts/track_institutional_flow.py --api-key YOUR_KEY
API Tier Requirements:
13F Filing Schedule:
Execute the main screening script to find stocks with notable institutional activity:
Quick scan (top 50 stocks by institutional change):
python3 scripts/track_institutional_flow.py \
--top 50 \
--min-change-percent 10
Sector-focused scan:
python3 scripts/track_institutional_flow.py \
--sector Technology \
--min-institutions 20
Custom screening:
python3 scripts/track_institutional_flow.py \
--min-market-cap 2000000000 \
--min-change-percent 15 \
--top 100 \
--output institutional_flow_results.json
Output includes:
For detailed analysis of a specific stock's institutional ownership:
python3 scripts/analyze_single_stock.py AAPL
This generates:
Key metrics to evaluate:
Note:
track_institution_portfolio.pyis not yet implemented. FMP API organizes institutional holder data by stock (not by institution), making full portfolio reconstruction impractical via this API alone.
Alternative approach — useanalyze_single_stock.py to check if a specific institution holds a stock:
# Analyze a stock and look for a specific institution in the output
python3 institutional-flow-tracker/scripts/analyze_single_stock.py AAPL
# Then search the report for "Berkshire" or "ARK" in the Top 20 holders table
For full institution-level portfolio tracking, use these external resources:
Read the references for interpretation guidance:
references/13f_filings_guide.md - Understanding 13F data and limitationsreferences/institutional_investor_types.md - Different investor types and their strategiesreferences/interpretation_framework.md - How to interpret institutional flow signalsSignal Strength Framework:
Strong Bullish (Consider buying):
Moderate Bullish:
Neutral:
Moderate Bearish:
Strong Bearish (Consider selling/avoiding):
For new positions:
For existing holdings:
Screening workflow integration:
All analysis generates structured markdown reports saved to repository root:
Filename convention: institutional_flow_analysis_<TICKER/THEME>_<DATE>.md
Report sections:
All analysis now includes a reliability grade based on data quality:
The screening script (track_institutional_flow.py) automatically excludes Grade C stocks. The single stock analysis (analyze_single_stock.py) displays the grade with appropriate warnings.
Why this matters: FMP returns different numbers of holders per quarter. A stock may show 5,415 holders in Q4 but only 201 in Q3. Without filtering, aggregate metrics produce misleading percent changes (e.g., +400%). The data quality module filters to "genuine" holders (present in both quarters) to produce reliable metrics.
Data Lag:
Coverage:
Reporting Rules:
Interpretation:
Insider + Institutional Combo:
Sector Rotation Detection:
Contrarian Plays:
Smart Money Validation:
The references/ folder contains detailed guides:
Main screening script for finding stocks with significant institutional changes.
Required:
--api-key: FMP API key (or set FMP_API_KEY environment variable)Optional:
--top N: Return top N stocks by institutional change (default: 50)--min-change-percent X: Minimum % change in institutional ownership (default: 10)--min-market-cap X: Minimum market cap in dollars (default: 1B)--sector NAME: Filter by specific sector--min-institutions N: Minimum number of institutional holders (default: 10)--limit N: Number of stocks to fetch from screener (default: 100). Lower values save API calls.--output FILE: Output JSON file path--output-dir DIR: Output directory for reports (default: reports/)--sort-by FIELD: Sort by 'ownership_change' or 'institution_count_change'Deep dive analysis on a specific stock's institutional ownership.
Required:
--api-key: FMP API key (or set FMP_API_KEY environment variable)Optional:
--quarters N: Number of quarters to analyze (default: 8, i.e., 2 years)--output FILE: Output markdown report path--output-dir DIR: Output directory for reports (default: reports/)--compare-to TICKER: Compare institutional ownership to another stock (future feature)Status: NOT YET IMPLEMENTED
This script is a placeholder. It prints alternative resources (WhaleWisdom, SEC EDGAR, DataRoma) and exits with error code 1. FMP API organizes institutional holder data by stock (not by institution), making full portfolio reconstruction impractical.
For institution-specific portfolio tracking, use:
Shared utility module used by both track_institutional_flow.py and analyze_single_stock.py:
Value Dividend Screener + Institutional Flow:
1. Run Value Dividend Screener to find candidates
2. For each candidate, check institutional flow
3. Prioritize stocks with rising institutional ownership
US Stock Analysis + Institutional Flow:
1. Run comprehensive fundamental analysis
2. Validate with institutional ownership trends
3. If institutions are selling, investigate why
Portfolio Manager + Institutional Flow:
1. Fetch current portfolio via Alpaca
2. Run institutional analysis on each holding
3. Flag positions with deteriorating institutional support
4. Consider rebalancing away from distribution
Technical Analyst + Institutional Flow:
1. Identify technical setup (e.g., breakout)
2. Check if institutional buying confirms
3. Higher conviction if both align
Note: This skill is designed for long-term investors (3-12 month horizon). For short-term trading, combine with technical analysis and other momentum indicators.
Weekly Installs
180
Repository
GitHub Stars
394
First Seen
Jan 26, 2026
Security Audits
Gen Agent Trust HubPassSocketPassSnykWarn
Installed on
gemini-cli167
cursor166
opencode166
codex162
github-copilot160
kimi-cli158
Python PDF处理教程:合并拆分、提取文本表格、创建PDF文件
59,800 周安装