面向 Claude Code 使用的 EDGAR 指南本指南解释技能如何使用tools/edgar.py读取 SEC 数据。使用的端点CIK 查询https://www.sec.gov/files/company_tickers.json公司事实XBRLhttps://data.sec.gov/api/xbrl/companyfacts/CIK{cik}.json申报元数据https://data.sec.gov/submissions/CIK{cik}.json支持的申报表格10-K10-Q20-F6-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 解析上响亮失败。当某些概念不可用时返回部分数据集。绝不编造缺失值。