Global Financial Downloader OpenClaw Skill

全球财报智能下载器 v2.2。自动识别市场（A 股/港股/美股），自动选择爬虫。港股使用东方财富+同花顺 API，无需认证。美股外国公司（ADR）自动使用 20-F/6-K 替代 10-K/10-Q。subprocess 替代 os.system，错误检查+输出捕获。支持 --dry-run 预览、下载后自动验证。

v2.3.0 Recently Updated Updated 6 days ago

Installation

clawhub install global-financial-downloader

Requires npm i -g clawhub

View on ClawHub Download .zip

86

Downloads

0

Stars

1

current installs

1 all-time

7

Versions

EU EU-Hosted Inference API

Power your OpenClaw skills with the best open-source models.

Drop-in OpenAI-compatible API. No data leaves Europe.

Explore Inference API

GLM

GLM 5

$1.00 / $3.20

per M tokens

Kimi

Kimi K2.5

$0.60 / $2.80

per M tokens

MiniMax

MiniMax M2.5

$0.30 / $1.20

per M tokens

Qwen

Qwen3.5 122B

$0.40 / $3.00

per M tokens

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

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=年报 --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

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

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

Statistics

Downloads 86
Stars 0
Current installs 1
All-time installs 1
Versions 7
Comments 0
Created Apr 6, 2026
Updated Apr 12, 2026

Latest Changes

v2.3.0 · Apr 12, 2026

- Update version to 2.3.0 in documentation. - No other functional or content changes; documentation otherwise unchanged.

Quick Install

clawhub install global-financial-downloader

Related Skills

Other popular skills you might find useful.

MaTriXy

Agent Browser

MaTriXy

Headless browser automation CLI optimized for AI agents with accessibility tree snapshots and ref-based element selection

91.3k 329 v0.1.0
peytoncasper

Browser Automation

peytoncasper

Automate web browser interactions using natural language via CLI commands. Use when the user asks to browse websites, navigate web pages, extract data from websites, take screenshots, fill forms, click buttons, or interact with web applications.

35.9k 49 v1.0.1
Iván

Code

Iván

Coding workflow with planning, implementation, verification, and testing for clean software development.

21.3k 38 v1.0.4
peytoncasper

Agent Browser - Stagehand

peytoncasper

Automate web browser interactions using natural language via CLI commands. Use when the user asks to browse websites, navigate web pages, extract data from websites, take screenshots, fill forms, click buttons, or interact with web applications.

6.9k 4 v1.0.0
Browse all skills →
EU Made in Europe

Chat with 100+ AI Models in one App.

Use Claude, ChatGPT, Gemini alongside with EU-Hosted Models like Deepseek, GLM-5, Kimi K2.5 and many more.

Start for free View pricing
Customer Support