埃德加风险区(Edgar Risk Diff)
v1.0.1比较两份美国上市公司的SEC 10-K 风险因素部分(第1A项)之间的差异。显示新增风险、删除风险、语言修改、主题汇总(AI、网络安全、地缘政治、监管)和变动百分比。直接使用SEC EDGAR,无需API密钥。高级版添加基于嵌入的新颖性评分。
运行时依赖
安装命令
点击复制技能文档
Edgar Risk Diff 本公司的风险因素与去年相比有什么新变化?这个技能可以在几秒钟内回答这个问题,适用于任何美国上市的股票代码,通过从 SEC EDGAR 中拉取最近两份 10-K 报告,并生成 Item 1A(风险因素)的结构化 diff。当使用这个技能时,激活以下问题: “{ticker} 的 10-K 风险因素有什么变化?” “{ticker} 今年披露了什么新的风险?” “{ticker} 与去年相比是否删除了任何风险因素?” “比较 {ticker} 在 {year1} 和 {year2} 年的风险因素。” “扫描 {tickers…} 的新 AI/网络/中国/监管风险。” “拉取 {ticker} 的最新风险因素。” 不要使用这个技能来做以下事情: 10-Q 差异(这个技能仅适用于 10-K —— Item 1A 通常每年只更改一次)。 实时价格/收益/基本面数据(使用市场数据技能代替)。 法律建议。 输出仅供信息参考。 快速开始 # 差异化最近两份 10-K 报告 python3 {baseDir}/scripts/risk_diff.py diff AAPL # 差异化特定年份 python3 {baseDir}/scripts/risk_diff.py diff TSLA --years 2024 2022 # 打印最新的风险因素部分(无差异) python3 {baseDir}/scripts/risk_diff.py latest NVDA # 多个股票代码的一行摘要(适合早间简报) python3 {baseDir}/scripts/risk_diff.py scan AAPL MSFT GOOGL NVDA META AMZN # [高级] 基于嵌入的新颖性评分 —— 根据段落实际的新颖性进行排名,而不仅仅是文本是否有所不同。 python3 {baseDir}/scripts/risk_diff.py novelty AAPL --top 10 差异输出包含的内容 翻转百分比 —— 添加、删除或修改的段落数量的比例。 新主题 —— 根据主题(网络安全、AI/ML、地缘政治、气候、供应链、监管、诉讼、宏观、劳动力、加密货币、流行病)汇总添加的段落数量。 添加的段落 —— 在前一份 10-K 报告中不存在的风险语言,每个段落都标有其所属的主题。 删除的段落 —— 公司删除的语言(通常与添加的语言一样重要)。 修改的段落 —— 旧的和新的段落对,带有相似度比率,以便用户可以看到已知风险如何被重新表述。 免费版与高级版的功能 功能 免费 高级 差异(添加/删除/修改) 主题汇总(基于关键词) 多个股票代码扫描 语义新颖性评分(基于嵌入,捕捉关键词差异忽略的改述风险) 优先电子邮件支持 高级版解锁新颖性子命令。购买许可证密钥并将其保存到 ~/.edgar-risk-diff/license.txt 中,或导出 EDGAR_RISK_LICENSE=。 数据源和速率限制 从 data.sec.gov 和 www.sec.gov/Archives/(公共、免费、无需认证)读取数据。根据 SEC 公平访问政策,限制在每秒 10 个请求以下。缓存所有响应在 ~/.edgar-risk-diff/cache/ 中 —— 对于相同股票代码的后续运行是即时的。发送 EDGAR 兼容的 User-Agent 标头。重写为 EDGAR_USER_AGENT="您的姓名 你的@email.com",如果重新分发。 安全性和权限 无 API 密钥。无凭据。无外部写入。仅向 data.sec.gov 和 www.sec.gov 发送 HTTPS GET 请求。仅在 ~/.edgar-risk-diff/(缓存 + 可选许可证文件)内写入。无遥测。无分析。无第三方调用。审查 scripts/risk_diff.py(≈350 行,单个文件,纯 stdlib + requests)在第一次使用之前。 限制 Item 1A 检测基于正则表达式,适用于标准 10-K 格式。使用高度非标准 HTML 的提交可能会导致提取失败 —— 重新运行 latest 以查看解析器看到的内容。段落匹配是模糊的(SequenceMatcher + 哈希双语 cosine)。非常短的段落(<40 个字符)被忽略以抑制噪音。高级新颖性使用确定性的哈希双语嵌入 —— 在本地运行,无外部 API。质量低于变换器模型,但捕捉到本技能设计的改述模式。