terancejiang/skill_financial_report_download/report-download

Financial Report PDF Downloader

Download A-share and Hong Kong stock financial report PDFs from stockn.xueqiu.com (雪球) with notice.10jqka.com.cn (同花顺) as fallback. Both sources enable reliable automated downloads.

Workflow

Input (stock code, year, report type)
  → Step 0: Parse & detect market
  → Step 1: WebSearch for PDF on stockn.xueqiu.com
  → Step 2: Extract matching PDF URLs
  → Step 3: Identify correct report (filter out summaries, audit reports, etc.)
  → Step 4: Python script downloads PDF to local disk
  → Output: local PDF file path

Step 0: Parse Input

Parse user input into three parts:

• stock_code (required): stock ticker
• year (optional): defaults to latest available
• report_type (optional): defaults to 年报

Market Detection

Report Type Mapping

Step 1: Search for the Report

Use WebSearch with this query pattern:

A-share: site:stockn.xueqiu.com {formatted_code} {search_keyword} {year} HK: site:stockn.xueqiu.com {formatted_code} {hk_search_keyword} {year}

If no year specified: try current year first, then previous year. If no results from Xueqiu:

1. Retry with 同花顺: site:notice.10jqka.com.cn {formatted_code} {search_keyword} {year}

• Can also try with company name, e.g.: site:notice.10jqka.com.cn 伊利股份 2024 年度报告

1. If still no results: retry without any site: prefix as a last resort.

Step 2: Extract PDF Links

Filter search results for PDF URLs from supported sources:

• https://stockn.xueqiu.com/.../*.pdf
• https://notice.10jqka.com.cn/.../*.pdf

Step 3: Identify Correct Report

Exclude results with titles containing: 摘要, 审计报告, 公告, 利润分配, 可持续发展, 股东大会, ESG, summary, auditor, dividend, 更正, 补充, 意见, 内部控制

Prefer results where:

1. Title contains the report keyword (e.g. "年度报告") WITHOUT "摘要"
2. URL date closest to expected publish date
3. If tied, pick first result

If no candidates remain: inform user and suggest verifying stock code/year/report type.

Step 4: Download the PDF

Install dependency if needed:

pip install requests --break-system-packages

Run the download script (located at ${CLAUDE_PLUGIN_ROOT}/skills/report-download/scripts/download_report.py):

python3 ${CLAUDE_PLUGIN_ROOT}/skills/report-download/scripts/download_report.py \
  --url "<PDF_URL>" \
  --stock-code "<formatted_stock_code>" \
  --report-type "<report_type>" \
  --year "<year>" \
  --save-dir "."

Parse Output

The script prints a structured block between ---RESULT--- and ---END---:

• status: SUCCESS or FAILED
• filepath: absolute path to downloaded file
• filesize: file size in bytes
• message: status message

Report to User

On success: Report file path, size (human-readable MB), stock code, year, report type. On failure: Report error message. Suggest checking URL accessibility, retrying, or verifying inputs.