用途：分析美国上市公司在 SEC EDGAR 的公开申报文件，提取基本面、风险信号与投资相关信息。覆盖年报 10-K、季报 10-Q、重大事件 8-K、股东委托书 DEF 14A、内部人交易 Form 4、机构持仓 13F 及 5% 以上持股披露 SC 13D/G。
主要能力：一是财务报表深挖，关注收入增速、毛利率趋势、经营杠杆、研发强度、非经常项目、现金与债务、流动比率、商誉占比、存货与应收天数、自由现金流及转化率、股权激励、回购与分红。二是 MD&A 分析，提取收入驱动、利润率解释、前瞻性措辞，并通过正负面及谨慎词频变化判断管理层语气转向。三是风险因素变化检测，识别新增、删除、措辞强化或顺序提前的风险。四是 8-K 事件分类，如财报预告、并购、高管离职、重述、指引调整等。五是 Form 4 内部人信号，区分公开市场买入、10b5-1 计划卖出、期权行权等。六是 13F 机构持仓变化与 SC 13D 激进投资者信号。最后按财务健康、管理层语气、风险变化、内部人活动、机构流向、事件催化六个维度打分，输出综合信号。
使用方式：数据获取可用 read_url 工具访问 EDGAR URL，例如 https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&CIK=AAPL&type=10-K&dateb=&owner=include&count=10，或使用 yfinance 的 Ticker 对象获取结构化财务数据，如 ticker.financials、ticker.balance_sheet、ticker.cashflow、ticker.insider_transactions、ticker.institutional_holders。EDGAR 公开免费，无需 API key，但需带 User-Agent 并遵守约每秒 10 次请求限制。
适用场景：美股基本面研究、风险排查、事件驱动跟踪、内部人与机构行为观察。
限制：10-K/10-Q 数据偏历史，需结合前瞻指引；内部人交易有 2 个工作日报告滞后；13F 有季度结束后 45 天滞后，持仓可能已变化；本框架仅供研究，不构成投资建议。