前言¶
需要獲取美股上市公司公告的開發者或中介機構，通常需要手動在 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 檢索與下載流程封裝爲可複用的能力，適合需要批量處理美股公告的開發者。如需使用，可前往官方地址查看詳細配置與文檔。
