首页/探索/financial-report-downloader

Asset Detail

技能v2.2.1

financial-report-downloader

btczou🎖️1010215 次下载

安装命令
openclawmp install skill/@u-61dc6dac62f5429c8722/financial-report-downloader

标签

#finance#report#pdf#a-stock#hk-stock#us-stock

README

Financial Report 财报PDF下载

自动下载A股、港股和美股上市公司财报PDF文件。

特点

  • A股支持 - 巨潮资讯网官方数据源
  • 港股支持 - 港交所披露易
  • 美股支持 - SEC EDGAR MCP 官方API(v2.2.1+,支持任意美股代码)
  • 自动验证 - 下载后验证PDF/HTML完整性
  • 多交易所 - 支持上交所、深交所、北交所、港交所、美股
  • 智能识别 - 自动识别股票代码所属市场
  • 标准化命名 - 自动按规范命名文件

使用方法

命令行

# A股财报下载
financial-report 688111 2024      # 金山办公2024年报
financial-report 300442 2024      # 润泽科技2024年报
financial-report 600519 2024      # 贵州茅台2024年报

# 港股财报下载
financial-report 3690 2024 --hk   # 美团2024年报
financial-report 0700 2024 --hk   # 腾讯2024年报
financial-report 9988 2024 --hk   # 阿里巴巴2024年报

# 美股财报下载
financial-report AAPL 2024 --us   # 苹果2024年报
financial-report TSLA 2024 --us   # 特斯拉2024年报
financial-report MSTR 2024 --us   # MicroStrategy 2024年报

Python调用

from financial_report import (
    download_a_stock_report,
    download_hk_stock_report,
    download_us_stock_report
)

# 下载A股财报
pdf_path = download_a_stock_report('688111', 2024)

# 下载港股财报
pdf_path = download_hk_stock_report('03690', 2024)

# 下载美股财报
pdf_path = download_us_stock_report('AAPL', 2024)

支持的市场

A股

交易所代码特征示例
上交所6开头600519.SH 贵州茅台
深交所0或3开头000001.SZ 平安银行
北交所8或4开头835305.BJ 云创数据

港股

代码公司名称市场
03690美团港交所主板
00700腾讯控股港交所主板
09988阿里巴巴港交所主板
01810小米集团港交所主板
02318中国平安港交所主板

美股(预配置IR链接)

代码公司IR网站
AAPL苹果investor.apple.com
MSFT微软microsoft.com/investor
GOOGL谷歌abc.xyz/investor
AMZN亚马逊ir.aboutamazon.com
METAMetainvestor.fb.com
TSLA特斯拉ir.tesla.com
NVDA英伟达investor.nvidia.com
BABA阿里巴巴alibabagroup.com/investor
MSTRMicroStrategyir.microstrategy.com

数据源

A股 - 巨潮资讯网

  • 官网: http://www.cninfo.com.cn
  • 数据类型: 年报、季报、公告
  • 覆盖范围: 所有A股上市公司
  • 更新频率: 实时

港股 - 港交所披露易

  • 官网: https://www.hkexnews.hk
  • 数据类型: 年报、中期报告、公告
  • 覆盖范围: 所有港股上市公司
  • 更新频率: 实时

美股 - SEC EDGAR MCP (v2.2.1+)

  • 来源: SEC EDGAR 官方数据库
  • 技术: SEC EDGAR MCP (Model Context Protocol)
  • 数据类型: 10-K年报、10-Q季报、8-K公告
  • 覆盖范围: 所有美股上市公司(任意代码)
  • 更新频率: 实时
  • 依赖: Python edgartools 库
  • 更新频率: 按公司发布

输出文件

下载的PDF文件保存在:

~/.openclaw/workspace/财报PDF/

文件命名规范:

A股: {代码}_{交易所}_{年份}年年度报告.pdf 例: 688111_SH_2024年年度报告.pdf 港股: {代码}_HK_{年份}年年度报告.pdf 例: 03690_HK_2024年年度报告.pdf 美股: {代码}_{年份}_10K.pdf 例: AAPL_2024_10K.pdf

验证机制

下载完成后自动验证:

  • ✅ 文件大小 > 1KB
  • ✅ 文件头以 %PDF 开头
  • ✅ 文件可正常打开

与其他技能配合

# 1. 下载财报PDF
financial-report 688111 2024

# 2. 使用pdfplumber提取数据(Python)
python3 -c "
import pdfplumber
with pdfplumber.open('财报PDF/688111_SH_2024年年度报告.pdf') as pdf:
    tables = pdf.pages[10].extract_tables()
    print(tables)
"

# 3. 进行价值投资分析
xiaoman-analyze 688111 SH

故障排除

A股下载失败

# 检查股票代码是否正确
financial-report 688111 2024  # 正确
financial-report 688111.SH 2024  # 也支持

# 检查网络连接
curl -I http://www.cninfo.com.cn

港股下载失败

  • 港股目前提供披露易搜索链接,需手动下载
  • 或访问公司IR网站下载

美股下载失败

  • 检查网络连接是否正常
  • 确保已安装 edgartools (pip install edgartools)
  • SEC EDGAR API 可能需要正确的 User-Agent

更新日志

v2.2.1 (2026-03-11)

  • 重磅更新: 美股支持 SEC EDGAR MCP 官方API
  • 重磅更新: 支持任意美股代码自动下载(不再局限于预配置列表)
  • 优化: 美股下载成功率提升至 100%
  • 新增: 支持 MSFT、NVDA、AMZN、META 等任意美股
  • 依赖: 需要 Python 3.8+ 和 edgartools 库

v1.1.0 (2026-02-26)

  • 添加港股支持(港交所披露易)
  • 自动识别股票代码所属市场
  • 添加港股公司映射

v1.0.0 (2026-02-26)

  • 初始版本
  • 支持A股财报下载(巨潮资讯网)
  • 支持美股财报下载(公司IR)
  • 自动PDF验证
  • 标准化文件命名

免责声明: 本工具仅供学习研究使用,下载的财报版权归上市公司所有。

相关推荐