SuperAPI AI 工具集

sn-search-year-report

数据与分析

查看项目

更新于 10-15 16:44

技能介绍

用途:搜索免费、官方、可正常访问的年报、年度账目与定期报告,覆盖 A 股、港股、美股、英企、日本上市公司、发债主体、加拿大、新加坡、澳洲等主体。

主要能力:先用 scripts/year_report_api.py(仅 Python 标准库)做结构化查询,支持 cninfo(巨潮资讯 A 股公告,默认查年度报告 PDF)、sec-company / sec-filings(SEC EDGAR 的 CIK 与 10-K/20-F/40-F)、download(下载公开 PDF)。示例:python scripts/year_report_api.py cninfo "平安银行" --year 2023 --page-size 5;python scripts/year_report_api.py sec-filings --ticker AAPL --limit 5;python scripts/year_report_api.py download "https://static.cninfo.com.cn/finalpage/2024-03-15/1219306493.PDF" --output report.pdf。无脚本覆盖或需交互筛选时,用 browser-use 打开官方网页入口,如巨潮资讯、上交所、深交所、北交所、HKEXnews、中国货币网、上海清算所、上交所债券、Companies House、SEDAR+、SGX、ASX,进行站内搜索、筛选公告类别、定位 PDF 或详情页。

使用方式:凭证(API key、token、cookie)统一建议写在仓库根目录 .env(参考 .env.example),由 runtime 或用户在执行前加载为同名环境变量;脚本只从环境变量或显式 CLI 参数读取凭证,不要把真实密钥写入 skill payload、报告、日志或提交。cninfo 的 --year 表示报告期年份,脚本会自动查下一年的披露窗口;若按披露日期精确过滤,改用 --date-range。

限制:只接受免费、官方、可正常访问的来源;遇到商业库、订阅、试用额度、付费下载、登录墙、验证码、防护页、不可访问页面立即丢弃,不绕过限制。只接受官方披露源;公司官网 IR 可作补充但不能替代官方源。中国普通非上市企业通常没有公开完整财务年报;工商年报不是审计财报,且已丢弃不可稳定访问的工商公示系统。已丢弃 Companies House API、EDINET API(需 API key)及任何商业数据库或付费 API。输出时保留公司/证券代码、报告期、文件标题、披露日期、PDF 或详情页 URL、来源名称;能定位 PDF 时给 PDF,否则给官方详情页,并说明工商年报、上市公司年度报告、SEC 10-K/20-F/40-F、Companies House accounts、债券发行人年度报告并非同一披露口径。