SuperAPI AI 工具集

sec-filings-research

写作与研究

查看项目

更新于 10-15 20:29

技能介绍

用途:通过 Crawlora 接口检索 SEC EDGAR 申报文件与财务披露,回答带可识别文件、报告期和来源链接的申报问题。需区分已报告事实、管理层陈述与分析解读;仅凭一次申报查询不足以支撑买卖结论。

主要能力:公司实体检索(/sec/company/search)、申报列表(/sec/company/submissions,支持 cik 或 ticker、form、from、to、limit,最大 500)、单份申报(/sec/filing)、章节提取(/sec/filing/sections,items 与 max_chars,默认 20000,每节最大 200000)、标准化财务(/sec/financials,statement=income/balance/cash_flow,period=annual/quarterly,limit 最大 20)、全文检索、公司情报、内部人披露、机构持仓(需管理人 CIK)、跨公司 XBRL 事实(/sec/frames)以及批量数据集。

使用方式:设置 CRAWLORA_API_KEY,运行本技能目录下的 scripts/crawlora.sh 或使用绝对路径;接口使用 x-api-key 访问 https://api.crawlora.net/api/v1。示例:scripts/crawlora.sh /sec/company/search q=Apple;scripts/crawlora.sh /sec/company/submissions ticker=AAPL form=10-K limit=2;scripts/crawlora.sh /sec/financials ticker=AAPL statement=income period=annual limit=2。使用返回的 accession,不要复用过期示例 ID。

限制:申报日期过滤不等于报告期过滤;Item 编号因表单而异,应读取返回的 form/title。truncated=true 时可在上限内提高字符数或用 /web/scrape 查看主文档;不得仅因截断提取中缺失就断定风险消失。标准化数值采用每期最新申报数据,可能反映重述。季度现金流披露可能是年初至今。13F 为延迟报告快照,不代表当前完整组合或每笔交易。数据集结果可能滞后于实时申报。遇 429 退避,5xx 重试一次,401/403 停止。缺失值需与零区分,保留部分证据并明确缺口。