- name
- Global Financial Downloader
- slug
- global-financial-downloader
- version
- 2.3.0
- description
- 全球财报智能下载器 v2.2。自动识别市场（A 股/港股/美股），自动选择爬虫。港股使用东方财富+同花顺 API，无需认证。美股外国公司（ADR）自动使用 20-F/6-K 替代 10-K/10-Q。subprocess 替代 os.system，错误检查+输出捕获。支持 --dry-run 预览、下载后自动验证。
- metadata
- {"clawdbot":{"emoji":"🌍","requires":{"bins":["python3"]},"os":["linux","darwin","win32"]}}
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 --pdfBatch 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.shParameters
| Parameter | Description | Default | Example |
|---|---|---|---|
stock | Stock code or company name | Required | 600519, 贵州茅台, AAPL |
--from | Start year | 2020 | --from=2020 |
--to | End year | 2025 | --to=2026 |
--type | Report type | 年报 | 年报, 中报, 10-K, 10-Q |
--pdf | Download PDF files | No | --pdf |
--no-pdf | Skip PDF download | No | --no-pdf |
Supported Markets
A-Shares (China)
| Code | Name (CN) | Name (EN) |
|---|---|---|
| 600519 | 贵州茅台 | kweichow_moutai |
| 000858 | 五粮液 | wuliangye |
| 601318 | 中国平安 | ping_an_insurance |
| 600036 | 招商银行 | china_merchants_bank |
| ... | ... | ... |
Use stock code for ANY A-share company!
Hong Kong
| Code | Name (CN) | Name (EN) |
|---|---|---|
| 00700 | 腾讯 | tencent |
| 09988 | 阿里巴巴 | alibaba |
| 03690 | 美团 | meituan |
| 01810 | 小米 | 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
| Code | Name (CN) | Name (EN) |
|---|---|---|
| AAPL | 苹果 | apple |
| MSFT | 微软 | microsoft |
| GOOGL | 谷歌 | alphabet |
| AMZN | 亚马逊 | amazon |
| NVDA | 英伟达 | nvidia |
| ... | ... | ... |
Use stock code for ANY US company!
Report Types
A-Shares / HK
| Type | Parameter | Description |
|---|---|---|
| 年报 | 年报, annual | Annual Report |
| 中报 | 中报, interim | Interim Report |
| 季报 | 季报, quarterly | Quarterly Report |
| 全部 | 全部, all | All Reports |
US Stocks
| Type | Parameter | Description |
|---|---|---|
| 年报 | 10-K, 年报 | Annual Report (10-K) |
| 季报 | 10-Q, 季报 | Quarterly Report (10-Q) |
| 全部 | all, 全部 | All Reports |
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=年报 --pdfExample 2: Download Tencent Reports
python3 /root/.openclaw/workspace/skills/global-financial-downloader/downloader.py \
00700 --from=2020 --to=2026 --pdfExample 3: Download Apple 10-K
python3 /root/.openclaw/workspace/skills/global-financial-downloader/downloader.py \
AAPL --from=2020 --to=2026 --type=10-K --pdfExample 4: Download All Reports (No PDF)
python3 /root/.openclaw/workspace/skills/global-financial-downloader/downloader.py \
贵州茅台 --type=全部 --no-pdfTechnical Details
Market Identification
- 6-digit code starting with 6/0: A-shares
- 5-digit code starting with 0: HK stocks
- Letter code: US stocks
- Company name: Lookup in mapping table
Report Type Mapping
| Input | A-Shares | HK | US |
|---|---|---|---|
| 年报/annual | annual | financial | 10-K |
| 中报/interim | interim | financial | 10-Q |
| 季报/quarterly | regular | quarterly | 10-Q |
| 全部/all | regular | financial | all |
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 --pdfIssue: 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
| Version | Date | Changes |
|---|---|---|
| 2.2.0 | 2026-04-12 | 美股 ADR 支持 ⭐⭐ |
| - 美股外国公司自动使用 20-F/6-K（~50 家公司） | ||
| - 本土公司继续用 10-K/10-Q | ||
| - 外国公司列表：中概股+加拿大+欧洲+日本+拉美 | ||
| - SEC 爬虫 v2.0：CIK 缓存扩展 + 自动搜索 | ||
| 2.1.0 | 2026-04-12 | 6 项修复 ⭐ |
| - subprocess 替代 os.system（错误检查 + 输出捕获） | ||
| - 报告类型大小写保护（10-k → 10-K） | ||
| - market key 大小写修复（HK→hk） | ||
| - 港股 report type 映射修复（financial → 年报/中报/季报） | ||
| - --dry-run 预览模式 | ||
| - 下载后自动验证结果 | ||
| 2.0.0 | 2026-04-12 | 港股重构 ⭐⭐⭐ |
- 替换 hkex_auto_scraper_v3.py → hk_financial_downloader | ||
| - 数据源：东方财富 + 同花顺 API（无需认证） | ||
| - 自动代码格式转换 (700/0700/00700/HK0700) | ||
| - 完整报告优先于业绩公告 | ||
| - 移除 playwright 依赖 | ||
| 1.0.0 | 2026-04-03 | 初始版本 |
Author
Created by 玄武 🐢 Version: 2.2.0 Last Updated: 2026-04-12