尧图网页设计 
Vibe-Trading SEC EDGAR 文件分析实战从 10-K 到 Form 4 的美股基本面与事件信号框架【免费下载链接】Vibe-TradingVibe-Trading: Your Personal Trading Agent项目地址: https://gitcode.com/GitHub_Trending/vi/Vibe-Trading导读本文基于 Vibe-Trading 项目内建的edgar-sec-filings方法论技能系统讲解如何对美股上市公司的 SEC EDGAR 公开文件进行分析——覆盖年报10-K、季报10-Q、重大事件披露8-K、委托书DEF 14A、内幕交易Form 4与机构持仓13F/SC 13D-G。你将掌握一套可直接落地的分析框架文件类型与信号价值映射、三大报表解读要点、MDA 语气识别、风险因素变化检测、8-K 事件分类规则、内幕交易评分、13F 聪明钱追踪以及最终的综合信号评分模板同时结合 Vibe-Trading 仓库中的get_sec_filings工具与sec_edgar_client传输层实现了解数据是如何在免 API Key、受 IP 限速保护的条件下被可靠获取的。技能定位与数据获取分工在 Vibe-Trading 中SEC 相关能力被拆分为两层理解这一分工有助于正确使用edgar-sec-filings本文主体方法论层回答“拿到文件后怎么读”——提取财务数据、风险信号与投资相关信息sec-edgarfetch 技能获取层回答“数据从哪来、怎么拿”——封装 ticker→CIK 解析、文件索引、XBRL 财务序列三个数据通道。数据检索通过read_url工具访问 EDGAR URL或通过yfinance的 Ticker 对象获取结构化财务数据而项目内置的get_sec_filings工具实现见 sec_filings_tool.py则把“拉取文件列表 拉取单一 us-gaap 指标序列”合并为一次调用由底层冻结的限速客户端保证不会以未节流的方式访问sec.gov。文件类型与投资相关性文件频率核心内容信号价值10-K年度全年财务、风险因素、MDA、分部数据全面的基本面视角10-Q季度季度财务、中期 MDA、法律更新趋势确认 / 拐点识别8-K事件驱动重大事件并购、CEO 变更、重述、业绩指引催化剂 / 风险触发器DEF 14A年度委托书高管薪酬、董事会构成、股东提案治理质量信号Form 42 个工作日内内幕人买入 / 卖出内幕人信心信号13F季度AUM 超 1 亿美元的机构持仓聪明钱仓位动向SC 13D/G事件驱动持股超 5% 的披露激进投资者 / 战略投资者信号EDGAR 数据访问直接 EDGAR URL# 公司文件检索 # https://www.sec.gov/cgi-bin/browse-edgar?actiongetcompanyCIK{ticker}type{filing_type} # 示例Apple 的 10-K 文件列表 url https://www.sec.gov/cgi-bin/browse-edgar?actiongetcompanyCIKAAPLtype10-Kdatebownerincludecount10 # EDGAR 全文检索EFTS # https://efts.sec.gov/LATEST/search-index?q{query}dateRangecustomstartdt{start}enddt{end}通过 yfinance结构化数据import yfinance as yf ticker yf.Ticker(AAPL) # 财务报表源自 10-K/10-Q income ticker.financials # 年度利润表 income_q ticker.quarterly_financials # 季度 balance ticker.balance_sheet # 资产负债表 cashflow ticker.cashflow # 现金流量表 # 内幕交易源自 Form 4 insider ticker.insider_transactions # 机构持仓源自 13F institutions ticker.institutional_holders major ticker.major_holders通过内置get_sec_filings工具推荐Vibe-Trading 的SecFilingsTool模块 sec_filings_tool.py将 EDGAR 访问包装在BaseTool契约之后。一次调用可以回答两个问题列出近期文件可按form过滤以及当给出metric时返回某一 us-gaap 概念的已报告时间序列。完整契约见 get_sec_filings_tool.md。参数说明参数类型必填默认说明tickerstring是—美股代码不区分大小写AAPL、msft经 SEC company-tickers 表解析为 CIKformstring否全部SEC 表单类型过滤不区分大小写10-K、10-Q、8-Kmetricstring否—XBRLus-gaap概念名Revenues、NetIncomeLoss、Assets大小写敏感taxonomy 元素名精确匹配limitinteger否20最多返回的文件 / 指标点数被钳制在1..40源码常量_MAX_LIMIT 40、_DEFAULT_LIMIT 20调用示例{ ticker: AAPL, form: 10-K, limit: 5 } { ticker: MSFT, metric: Revenues, limit: 8 } { ticker: TSLA, form: 8-K, limit: 10 } { ticker: NVDA, metric: NetIncomeLoss, limit: 12 }成功信封结构简化{ ok: true, market: US, source: sec_edgar, data: { ticker: AAPL, cik: 0000320193, filings: [ { form: 10-K, accession_number: 0000320193-23-000106, filing_date: 2023-11-03, report_date: 2023-09-30, primary_document: aapl-20230930.htm, document_url: https://www.sec.gov/Archives/edgar/data/320193/000032019323000106/aapl-20230930.htm } ], metric: { concept: Revenues, unit: USD, points: [{ end: 2023-09-30, val: 383285000000.0, fiscal_year: 2023, fiscal_period: FY, form: 10-K }] } } }失败时返回错误信封例如{ ok: false, error: ticker XYZ not found in the SEC company table (US only) }。filings按 SEC 返回顺序保持最新优先分页字段paging.next_offset支持继续翻页对应 test_sec_filings_tool.py 中验证的分页行为。底层传输sec_edgar_client当需要工具未暴露的原始字段如公司地址、某概念的全部 units时可直接调用传输层函数见 sec_edgar_client.mdfrom backtest.loaders.sec_edgar_client import cik_for, get_submissions, get_company_facts cik cik_for(AAPL) # 0000320193或 None不在 SEC 表中 submissions get_submissions(cik) # 近期文件索引 公司元数据 facts get_company_facts(cik) # 全部已报告 XBRL 概念仓库里还提供了一个可运行的端到端示例脚本 sec_filings_example.py展示 ticker → CIK → 近期 10-K 列表 → 单一指标序列的完整链路可在agent/目录下以python src/skills/sec-edgar/scripts/sec_filings_example.py运行。关键实现细节重要CIK 填充规则submissions 与 companyfacts 端点要求 10 位零填充 CIK320193→0000320193而主文档 URL 使用未填充形式。示例CIK0000320193也会被归一化为0000320193。主文档 URL 拼装https://www.sec.gov/Archives/edgar/data/{cik_unpadded}/{accession_no_dashes}/{primary_document}其中 accession 连字符被去除0000320193-23-000106→000032019323000106。限速与 User-Agent所有请求经由backtest.loaders._http的sec主机桶节流每次请求间隔约 0.12 秒远低于 SEC 约 10 req/s 上限并携带合规的联系人 User-Agent。两个环境变量可覆盖VIBE_TRADING_SEC_UA替换 UA与VIBE_TRADING_SEC_MIN_INTERVAL提高间隔不会低于 0.12s 下限。切勿绕过客户端用裸requests循环突发请求否则会触发 SEC 的临时 IP 封禁详见 endpoints_and_limits.md。仅限美国市场EDGAR 不覆盖 A 股、港股等非美市场非美代码不会解析出 CIK。从源码结构看sec_edgar_client是纯 REST 客户端而非DataLoaderProtocol未注册为回测sourceEDGAR 只喂给get_sec_filings工具层。10-K / 10-Q 分析框架一、财务报表深度拆解利润表关注点营收增速同比与环比加速 / 减速毛利率趋势扩张定价权vs 压缩成本压力经营杠杆SGA 占营收比下降 正的经营杠杆研发强度RD / 营收与同业对比非经常性项目重组费用、减值、一次性收益资产负债表关注点现金及等价物 vs 总债务净现金 / 净债务头寸流动比率与速动比率流动性健康度商誉 / 无形资产占总资产比并购驱动型增长风险存货天数制造业 / 零售业上升 需求走弱信号应收账款天数上升 回款风险或渠道压货现金流量表关注点FCF 经营现金流 − 资本开支真实现金创造能力FCF 转化率 FCF / 净利润80% 代表高盈利质量资本开支强度 CapEx / 营收上升 增长投入或维护负担股权激励SBC加回以还原真实现金盈利回购 vs 分红资本回报策略信号关于指标期间的一个坑源码级佐证SEC 的 XBRLcompanyfacts会在同一end日期下同时上报“真实季度”与“年初至今”两类期间帧同一fy/fp/form/accn。仅凭end识别期间会把九个月的数字与同日结束的季度混淆——在真实 AAPL 营收数据上曾出现 81 个 key 中 36 个发生碰撞。Vibe-Trading 的 sec_frames.py 用(start, end)跨度作为期间唯一标识并按天数窗口分类季度帧约 60–120 天、年度帧约 330–380 天其余持续时间归类为ytd。_parse_metric还会对同一跨度去重且保留最新申报版本确保重述restatement后显示的是最新数字对应回归测试 test_sec_period_frames.py。当你在分析中用Revenues、NetIncomeLoss这类指标时务必留意period_type与period_days字段避免把 QTD 当成季度值。二、MDA管理层讨论与分析MDA 是文件中最具定性、最前向的部分。关键提取目标营收驱动哪些分部 / 地区在增长哪些在下滑毛利评论管理层对毛利率变化的解释前瞻指引措辞“expect”“anticipate”“believe”——语气转变检测风险因素变化与上次文件对比新增风险 实质性变化流动性与资本资源债务到期时间表、信贷额度可用性语气分析信号# 简化语气打分 positive_words [growth, improvement, strong, exceeded, momentum, opportunity] negative_words [challenging, decline, uncertainty, headwind, pressure, risk] cautious_words [moderate, cautious, prudent, measured, selective] # 与上次文件对比词频变化 # 负面词数上升 展望恶化 # 谨慎词上升 管理层在 hedging三、风险因素分析风险因素变化检测10-K vs 上期 10-K变化类型信号行动新增风险因素识别出实质性新风险深挖该具体风险移除风险因素风险已解决或视为不重大若是真实解决则为正面信号措辞加剧风险升级审视敞口与对冲排序变化上移风险优先级提升评估潜在影响幅度美股常见风险类别监管 / 法律风险反垄断、FDA、专利到期客户集中度单一客户营收超 10% 必须披露地域集中度中国敞口、新兴市场风险技术颠覆风险网络安全风险SEC 新规重大网络事件须在 8-K 中披露气候 / ESG 风险要求日益增加8-K 事件分析重大事件分类事件类型8-K 条款典型价格影响时间敏感性业绩预告发布2.02高立即并购公告1.01极高立即CEO / CFO 离职5.02中高当日财务重述4.02极高负面立即业绩指引修订7.01/8.01高当日信贷协议变更1.01低-中监控股票回购计划8.01低正面背景信号股息变更8.01中当日8-K 信号规则# 高优先级 8-K 事件 if item 4.02: # 财务重述 signal strong_negative # 重述摧毁信任 action review_all_prior_financials elif item 2.02 and surprise_direction negative: signal negative # 业绩预告不及预期 elif item 5.02 and role in [CEO, CFO]: signal uncertainty # C 级高管离职 治理风险 elif item 1.01 and event_type acquisition: signal evaluate # 并购收购方通常 -2% 至 -5%标的 20% 至 40%内幕交易分析Form 4信号框架模式信号置信度集群买入30 天内 3 内幕人买入强看多高CEO/CFO 大额公开市场买入$500K看多高股价下跌 20% 后内幕人买入逆势看多中高历史高位集群卖出中性至轻度看空低可能是预先规划CFO 卖出超 50% 持仓看空中10b5-1 计划卖出中性低预先编程关键区分公开市场买入信息量最大内幕人自掏腰包10b5-1 计划卖出信息量最小预先编程、监管安全港期权行权 立即卖出常为税务驱动信号价值低赠予交易做信号时可忽略# 内幕信号打分 def score_insider_activity(transactions, lookback_days90): buys [t for t in transactions if t.type Purchase and t.days_ago lookback_days] sells [t for t in transactions if t.type Sale and t.days_ago lookback_days] buy_value sum(t.value for t in buys) sell_value sum(t.value for t in sells) # 过滤掉 10b5-1 计划卖出 organic_sells [s for s in sells if not s.is_10b5_1] if len(buys) 3 and buy_value 1_000_000: return strong_bullish elif buy_value sell_value * 2: return bullish elif len(organic_sells) 3 and sell_value 5_000_000: return bearish_watch else: return neutral13F 机构持仓分析聪明钱追踪关键指标机构持有人数上升 持仓基础扩大前 10 大持有人集中度50% 集中易受单基金赎回冲击本季新建仓聪明钱入场本季清仓聪明钱离场激进投资者持仓SC 13D潜在公司行动催化剂机构质量分级Tier 1 — 信念信号Berkshire、Baupost、Greenlight、Pershing Square、Tiger GlobalTier 2 — 趋势信号BlackRock、Vanguard、Fidelity资金流驱动选股信号较弱Tier 3 — 量化型Renaissance、Two Sigma、Citadel高换手方向性信号较弱# 13F 变化检测 def analyze_13f_changes(current_holders, prior_holders): new_positions current_holders - prior_holders # 新进 closed_positions prior_holders - current_holders # 退出 # 标记多个 Tier 1 基金同时建仓 tier1_new [h for h in new_positions if h.tier 1] if len(tier1_new) 2: signal strong_smart_money_accumulation return signal综合文件信号Composite Filing Signal评分模板filing_score { financial_health: 0, # -2 至 2基于 10-K/10-Q 财务 management_tone: 0, # -2 至 2MDA 情绪变化 risk_factor_change: 0, # -2 至 2新增风险 vs 已解决风险 insider_activity: 0, # -2 至 2内幕净买入/卖出 institutional_flow: 0, # -2 至 213F 仓位变化 event_catalyst: 0, # -2 至 2近期 8-K 影响 } # 总分区间-12 至 12 # 6强基本面看多 # 2 至 6轻度看多 # -2 至 2中性 # -2基本面谨慎输出格式模板完成分析后可参照以下结构化模板产出可复用的分析报告该格式本身即适合作为 Agent 的后续处理输入## SEC Filing Analysis — [Ticker] ### Filing Summary - **Latest 10-K/10-Q**: [date], [period] - **Recent 8-K events**: [list material events] - **Insider activity (90d)**: [net buy/sell summary] ### Financial Health - Revenue trend: [accelerating / stable / decelerating] - Margin trajectory: [expanding / stable / compressing] - FCF conversion: [strong / adequate / weak] - Balance sheet: [net cash / moderate leverage / high leverage] ### MDA Tone Shift - vs prior filing: [more optimistic / unchanged / more cautious] - Key language changes: [specific quotes or paraphrases] ### Risk Factor Changes - New risks: [list any new risk factors added] - Intensified risks: [list risks with stronger language] - Resolved risks: [list removed risk factors] ### Insider Institutional Signals - Insider net activity: [cluster buy / neutral / cluster sell] - Institutional positioning: [accumulation / stable / distribution] ### Composite Signal | Dimension | Score (-2~2) | Basis | |-----------|---------------|-------| | Financial health | 1 | Revenue accelerating, margins stable | | Management tone | -1 | More cautious language in MDA | | ... | ... | ... | ### Investment Implication - Direction: [bullish / bearish / neutral] - Confidence: [high / medium / low] - Key monitoring: [next earnings date, upcoming 8-K triggers]使用注意事项免费免 Key但须守规矩EDGAR 文件公开免费无需 API KeySEC 按源 IP 限速约 10 请求/秒并要求请求头携带描述性 User-Agent。Vibe-Trading 内置客户端已默认合规并支持VIBE_TRADING_SEC_UA覆盖。滞后性look-back10-K/10-Q 数据是回溯性的需结合前向指引与分析师预期才能形成完整视角。Form 4 报告滞后内幕交易数据有 2 个工作日报告延迟实时内幕数据需付费服务。13F 报告滞后13F 在季末后 45 天才披露仓位可能已发生变化。范围限制本框架仅覆盖美国市场EDGAR 不提供非美覆盖。研究用途声明本框架仅用于研究目的不构成投资建议。配套方法论技能的原文位于 edgar-sec-filings/SKILL.md获取层细节见 sec-edgar/SKILL.md两者配合使用可在 Vibe-Trading 的 Agent 工作流中完成“取数 → 解读 → 信号评分”的完整闭环。【免费下载链接】Vibe-TradingVibe-Trading: Your Personal Trading Agent项目地址: https://gitcode.com/GitHub_Trending/vi/Vibe-Trading创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Vibe-Trading SEC EDGAR 文件分析实战：从 10-K 到 Form 4 的美股基本面与事件信号框架
Vibe-Trading SEC EDGAR 文件分析实战从 10-K 到 Form 4 的美股基本面与事件信号框架【免费下载链接】Vibe-TradingVibe-Trading: Your Personal Trading Agent项目地址: https://gitcode.com/GitHub_Trending/vi/Vibe-Trading导读本文基于 Vibe-Trading 项目内建的edgar-sec-filings方法论技能系统讲解如何对美股上市公司的 SEC EDGAR 公开文件进行分析——覆盖年报10-K、季报10-Q、重大事件披露8-K、委托书DEF 14A、内幕交易Form 4与机构持仓13F/SC 13D-G。你将掌握一套可直接落地的分析框架文件类型与信号价值映射、三大报表解读要点、MDA 语气识别、风险因素变化检测、8-K 事件分类规则、内幕交易评分、13F 聪明钱追踪以及最终的综合信号评分模板同时结合 Vibe-Trading 仓库中的get_sec_filings工具与sec_edgar_client传输层实现了解数据是如何在免 API Key、受 IP 限速保护的条件下被可靠获取的。技能定位与数据获取分工在 Vibe-Trading 中SEC 相关能力被拆分为两层理解这一分工有助于正确使用edgar-sec-filings本文主体方法论层回答“拿到文件后怎么读”——提取财务数据、风险信号与投资相关信息sec-edgarfetch 技能获取层回答“数据从哪来、怎么拿”——封装 ticker→CIK 解析、文件索引、XBRL 财务序列三个数据通道。数据检索通过read_url工具访问 EDGAR URL或通过yfinance的 Ticker 对象获取结构化财务数据而项目内置的get_sec_filings工具实现见 sec_filings_tool.py则把“拉取文件列表 拉取单一 us-gaap 指标序列”合并为一次调用由底层冻结的限速客户端保证不会以未节流的方式访问sec.gov。文件类型与投资相关性文件频率核心内容信号价值10-K年度全年财务、风险因素、MDA、分部数据全面的基本面视角10-Q季度季度财务、中期 MDA、法律更新趋势确认 / 拐点识别8-K事件驱动重大事件并购、CEO 变更、重述、业绩指引催化剂 / 风险触发器DEF 14A年度委托书高管薪酬、董事会构成、股东提案治理质量信号Form 42 个工作日内内幕人买入 / 卖出内幕人信心信号13F季度AUM 超 1 亿美元的机构持仓聪明钱仓位动向SC 13D/G事件驱动持股超 5% 的披露激进投资者 / 战略投资者信号EDGAR 数据访问直接 EDGAR URL# 公司文件检索 # https://www.sec.gov/cgi-bin/browse-edgar?actiongetcompanyCIK{ticker}type{filing_type} # 示例Apple 的 10-K 文件列表 url https://www.sec.gov/cgi-bin/browse-edgar?actiongetcompanyCIKAAPLtype10-Kdatebownerincludecount10 # EDGAR 全文检索EFTS # https://efts.sec.gov/LATEST/search-index?q{query}dateRangecustomstartdt{start}enddt{end}通过 yfinance结构化数据import yfinance as yf ticker yf.Ticker(AAPL) # 财务报表源自 10-K/10-Q income ticker.financials # 年度利润表 income_q ticker.quarterly_financials # 季度 balance ticker.balance_sheet # 资产负债表 cashflow ticker.cashflow # 现金流量表 # 内幕交易源自 Form 4 insider ticker.insider_transactions # 机构持仓源自 13F institutions ticker.institutional_holders major ticker.major_holders通过内置get_sec_filings工具推荐Vibe-Trading 的SecFilingsTool模块 sec_filings_tool.py将 EDGAR 访问包装在BaseTool契约之后。一次调用可以回答两个问题列出近期文件可按form过滤以及当给出metric时返回某一 us-gaap 概念的已报告时间序列。完整契约见 get_sec_filings_tool.md。参数说明参数类型必填默认说明tickerstring是—美股代码不区分大小写AAPL、msft经 SEC company-tickers 表解析为 CIKformstring否全部SEC 表单类型过滤不区分大小写10-K、10-Q、8-Kmetricstring否—XBRLus-gaap概念名Revenues、NetIncomeLoss、Assets大小写敏感taxonomy 元素名精确匹配limitinteger否20最多返回的文件 / 指标点数被钳制在1..40源码常量_MAX_LIMIT 40、_DEFAULT_LIMIT 20调用示例{ ticker: AAPL, form: 10-K, limit: 5 } { ticker: MSFT, metric: Revenues, limit: 8 } { ticker: TSLA, form: 8-K, limit: 10 } { ticker: NVDA, metric: NetIncomeLoss, limit: 12 }成功信封结构简化{ ok: true, market: US, source: sec_edgar, data: { ticker: AAPL, cik: 0000320193, filings: [ { form: 10-K, accession_number: 0000320193-23-000106, filing_date: 2023-11-03, report_date: 2023-09-30, primary_document: aapl-20230930.htm, document_url: https://www.sec.gov/Archives/edgar/data/320193/000032019323000106/aapl-20230930.htm } ], metric: { concept: Revenues, unit: USD, points: [{ end: 2023-09-30, val: 383285000000.0, fiscal_year: 2023, fiscal_period: FY, form: 10-K }] } } }失败时返回错误信封例如{ ok: false, error: ticker XYZ not found in the SEC company table (US only) }。filings按 SEC 返回顺序保持最新优先分页字段paging.next_offset支持继续翻页对应 test_sec_filings_tool.py 中验证的分页行为。底层传输sec_edgar_client当需要工具未暴露的原始字段如公司地址、某概念的全部 units时可直接调用传输层函数见 sec_edgar_client.mdfrom backtest.loaders.sec_edgar_client import cik_for, get_submissions, get_company_facts cik cik_for(AAPL) # 0000320193或 None不在 SEC 表中 submissions get_submissions(cik) # 近期文件索引 公司元数据 facts get_company_facts(cik) # 全部已报告 XBRL 概念仓库里还提供了一个可运行的端到端示例脚本 sec_filings_example.py展示 ticker → CIK → 近期 10-K 列表 → 单一指标序列的完整链路可在agent/目录下以python src/skills/sec-edgar/scripts/sec_filings_example.py运行。关键实现细节重要CIK 填充规则submissions 与 companyfacts 端点要求 10 位零填充 CIK320193→0000320193而主文档 URL 使用未填充形式。示例CIK0000320193也会被归一化为0000320193。主文档 URL 拼装https://www.sec.gov/Archives/edgar/data/{cik_unpadded}/{accession_no_dashes}/{primary_document}其中 accession 连字符被去除0000320193-23-000106→000032019323000106。限速与 User-Agent所有请求经由backtest.loaders._http的sec主机桶节流每次请求间隔约 0.12 秒远低于 SEC 约 10 req/s 上限并携带合规的联系人 User-Agent。两个环境变量可覆盖VIBE_TRADING_SEC_UA替换 UA与VIBE_TRADING_SEC_MIN_INTERVAL提高间隔不会低于 0.12s 下限。切勿绕过客户端用裸requests循环突发请求否则会触发 SEC 的临时 IP 封禁详见 endpoints_and_limits.md。仅限美国市场EDGAR 不覆盖 A 股、港股等非美市场非美代码不会解析出 CIK。从源码结构看sec_edgar_client是纯 REST 客户端而非DataLoaderProtocol未注册为回测sourceEDGAR 只喂给get_sec_filings工具层。10-K / 10-Q 分析框架一、财务报表深度拆解利润表关注点营收增速同比与环比加速 / 减速毛利率趋势扩张定价权vs 压缩成本压力经营杠杆SGA 占营收比下降 正的经营杠杆研发强度RD / 营收与同业对比非经常性项目重组费用、减值、一次性收益资产负债表关注点现金及等价物 vs 总债务净现金 / 净债务头寸流动比率与速动比率流动性健康度商誉 / 无形资产占总资产比并购驱动型增长风险存货天数制造业 / 零售业上升 需求走弱信号应收账款天数上升 回款风险或渠道压货现金流量表关注点FCF 经营现金流 − 资本开支真实现金创造能力FCF 转化率 FCF / 净利润80% 代表高盈利质量资本开支强度 CapEx / 营收上升 增长投入或维护负担股权激励SBC加回以还原真实现金盈利回购 vs 分红资本回报策略信号关于指标期间的一个坑源码级佐证SEC 的 XBRLcompanyfacts会在同一end日期下同时上报“真实季度”与“年初至今”两类期间帧同一fy/fp/form/accn。仅凭end识别期间会把九个月的数字与同日结束的季度混淆——在真实 AAPL 营收数据上曾出现 81 个 key 中 36 个发生碰撞。Vibe-Trading 的 sec_frames.py 用(start, end)跨度作为期间唯一标识并按天数窗口分类季度帧约 60–120 天、年度帧约 330–380 天其余持续时间归类为ytd。_parse_metric还会对同一跨度去重且保留最新申报版本确保重述restatement后显示的是最新数字对应回归测试 test_sec_period_frames.py。当你在分析中用Revenues、NetIncomeLoss这类指标时务必留意period_type与period_days字段避免把 QTD 当成季度值。二、MDA管理层讨论与分析MDA 是文件中最具定性、最前向的部分。关键提取目标营收驱动哪些分部 / 地区在增长哪些在下滑毛利评论管理层对毛利率变化的解释前瞻指引措辞“expect”“anticipate”“believe”——语气转变检测风险因素变化与上次文件对比新增风险 实质性变化流动性与资本资源债务到期时间表、信贷额度可用性语气分析信号# 简化语气打分 positive_words [growth, improvement, strong, exceeded, momentum, opportunity] negative_words [challenging, decline, uncertainty, headwind, pressure, risk] cautious_words [moderate, cautious, prudent, measured, selective] # 与上次文件对比词频变化 # 负面词数上升 展望恶化 # 谨慎词上升 管理层在 hedging三、风险因素分析风险因素变化检测10-K vs 上期 10-K变化类型信号行动新增风险因素识别出实质性新风险深挖该具体风险移除风险因素风险已解决或视为不重大若是真实解决则为正面信号措辞加剧风险升级审视敞口与对冲排序变化上移风险优先级提升评估潜在影响幅度美股常见风险类别监管 / 法律风险反垄断、FDA、专利到期客户集中度单一客户营收超 10% 必须披露地域集中度中国敞口、新兴市场风险技术颠覆风险网络安全风险SEC 新规重大网络事件须在 8-K 中披露气候 / ESG 风险要求日益增加8-K 事件分析重大事件分类事件类型8-K 条款典型价格影响时间敏感性业绩预告发布2.02高立即并购公告1.01极高立即CEO / CFO 离职5.02中高当日财务重述4.02极高负面立即业绩指引修订7.01/8.01高当日信贷协议变更1.01低-中监控股票回购计划8.01低正面背景信号股息变更8.01中当日8-K 信号规则# 高优先级 8-K 事件 if item 4.02: # 财务重述 signal strong_negative # 重述摧毁信任 action review_all_prior_financials elif item 2.02 and surprise_direction negative: signal negative # 业绩预告不及预期 elif item 5.02 and role in [CEO, CFO]: signal uncertainty # C 级高管离职 治理风险 elif item 1.01 and event_type acquisition: signal evaluate # 并购收购方通常 -2% 至 -5%标的 20% 至 40%内幕交易分析Form 4信号框架模式信号置信度集群买入30 天内 3 内幕人买入强看多高CEO/CFO 大额公开市场买入$500K看多高股价下跌 20% 后内幕人买入逆势看多中高历史高位集群卖出中性至轻度看空低可能是预先规划CFO 卖出超 50% 持仓看空中10b5-1 计划卖出中性低预先编程关键区分公开市场买入信息量最大内幕人自掏腰包10b5-1 计划卖出信息量最小预先编程、监管安全港期权行权 立即卖出常为税务驱动信号价值低赠予交易做信号时可忽略# 内幕信号打分 def score_insider_activity(transactions, lookback_days90): buys [t for t in transactions if t.type Purchase and t.days_ago lookback_days] sells [t for t in transactions if t.type Sale and t.days_ago lookback_days] buy_value sum(t.value for t in buys) sell_value sum(t.value for t in sells) # 过滤掉 10b5-1 计划卖出 organic_sells [s for s in sells if not s.is_10b5_1] if len(buys) 3 and buy_value 1_000_000: return strong_bullish elif buy_value sell_value * 2: return bullish elif len(organic_sells) 3 and sell_value 5_000_000: return bearish_watch else: return neutral13F 机构持仓分析聪明钱追踪关键指标机构持有人数上升 持仓基础扩大前 10 大持有人集中度50% 集中易受单基金赎回冲击本季新建仓聪明钱入场本季清仓聪明钱离场激进投资者持仓SC 13D潜在公司行动催化剂机构质量分级Tier 1 — 信念信号Berkshire、Baupost、Greenlight、Pershing Square、Tiger GlobalTier 2 — 趋势信号BlackRock、Vanguard、Fidelity资金流驱动选股信号较弱Tier 3 — 量化型Renaissance、Two Sigma、Citadel高换手方向性信号较弱# 13F 变化检测 def analyze_13f_changes(current_holders, prior_holders): new_positions current_holders - prior_holders # 新进 closed_positions prior_holders - current_holders # 退出 # 标记多个 Tier 1 基金同时建仓 tier1_new [h for h in new_positions if h.tier 1] if len(tier1_new) 2: signal strong_smart_money_accumulation return signal综合文件信号Composite Filing Signal评分模板filing_score { financial_health: 0, # -2 至 2基于 10-K/10-Q 财务 management_tone: 0, # -2 至 2MDA 情绪变化 risk_factor_change: 0, # -2 至 2新增风险 vs 已解决风险 insider_activity: 0, # -2 至 2内幕净买入/卖出 institutional_flow: 0, # -2 至 213F 仓位变化 event_catalyst: 0, # -2 至 2近期 8-K 影响 } # 总分区间-12 至 12 # 6强基本面看多 # 2 至 6轻度看多 # -2 至 2中性 # -2基本面谨慎输出格式模板完成分析后可参照以下结构化模板产出可复用的分析报告该格式本身即适合作为 Agent 的后续处理输入## SEC Filing Analysis — [Ticker] ### Filing Summary - **Latest 10-K/10-Q**: [date], [period] - **Recent 8-K events**: [list material events] - **Insider activity (90d)**: [net buy/sell summary] ### Financial Health - Revenue trend: [accelerating / stable / decelerating] - Margin trajectory: [expanding / stable / compressing] - FCF conversion: [strong / adequate / weak] - Balance sheet: [net cash / moderate leverage / high leverage] ### MDA Tone Shift - vs prior filing: [more optimistic / unchanged / more cautious] - Key language changes: [specific quotes or paraphrases] ### Risk Factor Changes - New risks: [list any new risk factors added] - Intensified risks: [list risks with stronger language] - Resolved risks: [list removed risk factors] ### Insider Institutional Signals - Insider net activity: [cluster buy / neutral / cluster sell] - Institutional positioning: [accumulation / stable / distribution] ### Composite Signal | Dimension | Score (-2~2) | Basis | |-----------|---------------|-------| | Financial health | 1 | Revenue accelerating, margins stable | | Management tone | -1 | More cautious language in MDA | | ... | ... | ... | ### Investment Implication - Direction: [bullish / bearish / neutral] - Confidence: [high / medium / low] - Key monitoring: [next earnings date, upcoming 8-K triggers]使用注意事项免费免 Key但须守规矩EDGAR 文件公开免费无需 API KeySEC 按源 IP 限速约 10 请求/秒并要求请求头携带描述性 User-Agent。Vibe-Trading 内置客户端已默认合规并支持VIBE_TRADING_SEC_UA覆盖。滞后性look-back10-K/10-Q 数据是回溯性的需结合前向指引与分析师预期才能形成完整视角。Form 4 报告滞后内幕交易数据有 2 个工作日报告延迟实时内幕数据需付费服务。13F 报告滞后13F 在季末后 45 天才披露仓位可能已发生变化。范围限制本框架仅覆盖美国市场EDGAR 不提供非美覆盖。研究用途声明本框架仅用于研究目的不构成投资建议。配套方法论技能的原文位于 edgar-sec-filings/SKILL.md获取层细节见 sec-edgar/SKILL.md两者配合使用可在 Vibe-Trading 的 Agent 工作流中完成“取数 → 解读 → 信号评分”的完整闭环。【免费下载链接】Vibe-TradingVibe-Trading: Your Personal Trading Agent项目地址: https://gitcode.com/GitHub_Trending/vi/Vibe-Trading创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考