前言¶
需要获取美股上市公司公告的开发者或中介机构，通常需要手动在 SEC EDGAR 网站上逐个搜索和下载文档，这个过程重复且耗时。下面介绍一个可以直接在 Agent 中调用、支持批量检索与下载的工具。
这是什么¶
这是一个基于 SkillHub 的 Skill，由用户 user_457a1277 发布，版本为 1.0.0，分类为 data-analysis。它通过调用 SEC EDGAR 公告检索接口，支持按股票代码、日期范围搜索公告，并批量下载文档，同时提取公告的元数据。
核心功能¶
- 按股票代码检索：输入股票代码，查询该公司在指定日期范围内的所有公告。
- 按日期范围检索：设定开始与结束日期，获取该时间段内的公告列表。
- 批量下载文档：对检索结果进行批量下载，无需逐个操作。
- 提取公告元数据：获取每条公告的股票代码、公司名称、表格类型（如 10-K、10-Q、8-K 等）、提交日期等字段。
- API 调用：Skill 内部调用 SEC EDGAR 检索接口，输出结构化数据供 Agent 使用。
安装与启用¶
Skill 位于 SkillHub 平台，由社区发布。在支持 SkillHub 的环境（如 Cursor、Claude Code 或 Codex CLI）中，可通过以下方式启用：
1、在 Agent 配置或 Skill 仓库中搜索 Skill 名称：SEC-美股上市公司年报下载及批量查询。
2、确认版本为 1.0.0，来源为 community，分类为 data-analysis。
3、确保环境具备网络访问能力，能够调用 SkillHub 平台及 SEC EDGAR 接口。
（注：官方未提供具体的命令行安装路径，建议在 SkillHub 平台完成导入与配置。）
典型用法¶
以下为使用该 Skill 的典型流程：
1、准备股票代码与日期范围。例如，查询公司代码为 AAPL，日期范围为 2024-01-01 至 2024-12-31。
2、在 Agent 中调用 Skill，传入股票代码与日期参数。
3、Skill 返回公告列表，包含每条公告的提交日期、表格类型、文档链接等元数据。
4、Agent 根据返回结果，可选择单个或批量下载文档。
适用场景与注意¶
- 适用对象：需要定期获取美股公告的开发者、数据分析师、中介机构等。
- 使用场景：年报研究、公告监控、批量数据采集、合规检查等。
- 注意事项：
- 需遵守 SEC EDGAR 使用条款与数据访问限制。
- 大批量下载时需注意频率控制，避免触发限流。
- 元数据字段以实际返回为准，不同公告类型可能包含不同字段。
短结尾¶
该 Skill 将 SEC EDGAR 检索与下载流程封装为可复用的能力，适合需要批量处理美股公告的开发者。如需使用，可前往官方地址查看详细配置与文档。
