企业官网建设流程全解析

面向 Claude Code 使用的 EDGAR 指南

本指南解释技能如何使用tools/edgar.py读取 SEC 数据。

使用的端点

• CIK 查询：https://www.sec.gov/files/company_tickers.json
• 公司事实（XBRL）：https://data.sec.gov/api/xbrl/companyfacts/CIK{cik}.json
• 申报元数据：https://data.sec.gov/submissions/CIK{cik}.json

支持的申报表格

• 10-K
• 10-Q
• 20-F
• 6-K

公共函数

• get_cik(ticker)
• get_company_facts(ticker)
• get_financials(ticker)
• get_filings_metadata(ticker)

数据规范化模式

• 将股票代码规范化为大写。
• 在 CIK 查询期间解析.和-变体。
• 解析us-gaap和ifrs-full两种概念命名空间。
• 尽可能将 IFRS 术语映射到常见输出字段名。
• 保持年度和季度快照分离。
• 仅从期末股份概念返回shares_outstanding；如果不可用，则保持为 null，而不是使用加权平均 EPS 分母。

CLI 示例

python3 tools/edgar.py AAPL python3 tools/edgar.py NVDA--modefilings python3 tools/edgar.py ASML--modefacts

实用说明

• SEC 请求应包含合理的User-Agent。
• SEC 端点可能对突发流量限速；避免激进的循环。
• 国际股票代码的 EDGAR 覆盖可能稀疏。
• 在分析中呈现数值时应与申报元数据关联。

错误处理理念

• 在无效股票代码/CIK 解析上响亮失败。
• 当某些概念不可用时返回部分数据集。
• 绝不编造缺失值。