Global Financial Downloader

When to Use#

• Download financial reports from global markets (A-shares, HK, US)
• Automatically identify market from stock code
• Batch download annual/interim/quarterly reports
• Support both stock codes and company names

Quick Start#

Download Single Company#

bash

# Use stock code (recommended - supports all companies)
python3 /root/.openclaw/workspace/skills/global-financial-downloader/downloader.py \
  600519 --from=2020 --to=2026 --type=年报 --pdf

# Use company name (predefined companies only)
python3 /root/.openclaw/workspace/skills/global-financial-downloader/downloader.py \
  贵州茅台 --from=2020 --to=2026 --pdf

Batch Download#

bash

# Create a script for batch download
cat > download_all.sh << 'EOF'
#!/bin/bash
stocks=("600519 贵州茅台" "00700 腾讯" "AAPL 苹果")
for stock in "${stocks[@]}"; do
    code=$(echo $stock | cut -d' ' -f1)
    python3 /root/.openclaw/workspace/skills/global-financial-downloader/downloader.py \
      $code --from=2020 --to=2024 --pdf
done
EOF
chmod +x download_all.sh
./download_all.sh

Parameters#

ParameterDescriptionDefaultExamplestockStock code or company nameRequired600519, 贵州茅台, AAPL``--fromStart year2020--from=2020``--toEnd year2025--to=2026``--typeReport type年报年报, 中报, 10-K, 10-Q``--pdfDownload PDF filesNo--pdf``--no-pdfSkip PDF downloadNo--no-pdf

Supported Markets#

A-Shares (China)#

CodeName (CN)Name (EN)600519贵州茅台kweichow_moutai000858五粮液wuliangye601318中国平安ping_an_insurance600036招商银行china_merchants_bank.........

Use stock code for ANY A-share company!

Hong Kong#

CodeName (CN)Name (EN)00700腾讯tencent09988阿里巴巴alibaba03690美团meituan01810小米xiaomi.........

港股数据源 (v2.0 更新):

数据源API说明东方财富np-anotice-stock.eastmoney.com完整报告最多，22 份年报 (2005-2025)同花顺basic.10jqka.com.cn/basicapi/notice/pub补充东方财富缺失年份披露易www1.hkexnews.hk兜底

港股代码自动转换: 700/0700/00700/HK0700 自动适配各平台格式。

US Stocks#

CodeName (CN)Name (EN)AAPL苹果appleMSFT微软microsoftGOOGL谷歌alphabetAMZN亚马逊amazonNVDA英伟达nvidia.........

Use stock code for ANY US company!

Report Types#

A-Shares / HK#

TypeParameterDescription年报年报, annualAnnual Report中报中报, interimInterim Report季报季报, quarterlyQuarterly Report全部全部, allAll Reports

US Stocks#

TypeParameterDescription年报10-K, 年报Annual Report (10-K)季报10-Q, 季报Quarterly Report (10-Q)全部all, 全部All Reports

Output Files#

text

/root/.openclaw/workspace/exports/
├── cninfo_{name}/          # A-shares
│   ├── cninfo_{code}.json
│   ├── cninfo_{code}.csv
│   └── pdfs/
├── hkex_{name}/            # HK
│   ├── hkex_{name}_financial.json
│   ├── hkex_{name}_financial.csv
│   └── financial_pdfs/
└── sec_{name}/             # US
    ├── sec_{code}_{type}.json
    ├── sec_{code}_{type}.csv
    └── pdfs/

Examples#

Example 1: Download Moutai Annual Reports#

bash

python3 /root/.openclaw/workspace/skills/global-financial-downloader/downloader.py \
  600519 --from=2020 --to=2026 --type=年报 --pdf

Example 2: Download Tencent Reports#

bash

python3 /root/.openclaw/workspace/skills/global-financial-downloader/downloader.py \
  00700 --from=2020 --to=2026 --pdf

Example 3: Download Apple 10-K#

bash

python3 /root/.openclaw/workspace/skills/global-financial-downloader/downloader.py \
  AAPL --from=2020 --to=2026 --type=10-K --pdf

Example 4: Download All Reports (No PDF)#

bash

python3 /root/.openclaw/workspace/skills/global-financial-downloader/downloader.py \
  贵州茅台 --type=全部 --no-pdf

Technical Details#

Market Identification#

1. 6-digit code starting with 6/0: A-shares
2. 5-digit code starting with 0: HK stocks
3. Letter code: US stocks
4. Company name: Lookup in mapping table

Report Type Mapping#

InputA-SharesHKUS年报/annualannualfinancial10-K中报/interiminterimfinancial10-Q季报/quarterlyregularquarterly10-Q全部/allregularfinancialall

Configuration#

Add New Companies#

Edit /root/.openclaw/workspace/skills/global-financial-downloader/stock_mapping.json:

json

{
  "cn_stocks": {
    "stocks": [
      ["股票代码", "中文名称", "英文名称"],
      ["601318", "中国平安", "ping_an_insurance"]
    ]
  }
}

Supported Companies#

Predefined: 204 companies (50 A-shares, 51 HK, 100 US)

All companies: Use stock code for ANY company!

Troubleshooting#

Issue: Company Not Recognized#

Solution: Use stock code instead of company name

bash

# ❌ May not work for undefined companies
python3 downloader.py 某公司 --pdf

# ✅ Always works
python3 downloader.py 600XXX --pdf

Issue: PDF Download Failed#

Solution: Check network and disk space

Issue: No Reports Found#

Solution: Expand year range or check report type

Related Files#

• Main Script: /root/.openclaw/workspace/skills/global-financial-downloader/downloader.py
• Stock Mapping: /root/.openclaw/workspace/skills/global-financial-downloader/stock_mapping.json
• HK Downloader: /root/.openclaw/workspace/skills/hk-financial-downloader/scripts/hk_downloader.py
• Output: /root/.openclaw/workspace/archive/

Update Log#

VersionDateChanges2.2.02026-04-12美股 ADR 支持 ⭐⭐- 美股外国公司自动使用 20-F/6-K（~50 家公司）- 本土公司继续用 10-K/10-Q- 外国公司列表：中概股+加拿大+欧洲+日本+拉美- SEC 爬虫 v2.0：CIK 缓存扩展 + 自动搜索2.1.02026-04-126 项修复 ⭐- subprocess 替代 os.system（错误检查 + 输出捕获）- 报告类型大小写保护（10-k → 10-K）- market key 大小写修复（HK→hk）- 港股 report type 映射修复（financial → 年报/中报/季报）- --dry-run 预览模式- 下载后自动验证结果2.0.02026-04-12港股重构 ⭐⭐⭐- 替换 hkex_auto_scraper_v3.py → hk_financial_downloader- 数据源：东方财富 + 同花顺 API（无需认证）- 自动代码格式转换 (700/0700/00700/HK0700)- 完整报告优先于业绩公告- 移除 playwright 依赖1.0.02026-04-03初始版本

Author#

Created by 玄武 🐢 Version: 2.2.0 Last Updated: 2026-04-12