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

# 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

# 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

Supported Markets

A-Shares (China)

Use stock code for ANY A-share company!

Hong Kong

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

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

US Stocks

Use stock code for ANY US company!

Report Types

A-Shares / HK

US Stocks

Output Files

/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

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

Example 2: Download Tencent Reports

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

Example 3: Download Apple 10-K

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)

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

Configuration

Add New Companies

Edit /root/.openclaw/workspace/skills/global-financial-downloader/stock_mapping.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

# ❌ 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

Author

Created by 玄武 🐢

Version: 2.2.0

Last Updated: 2026-04-12