terancejiang/skill_financial_report_download
ResearchThis page was translated automatically. Technical details may differ from the original. View the original
An automatic PDF download tool for A-share/Hong Kong stock financial reports, supporting both Xueqiu and Tonghuashun data sources, and can be used as a Claude Code slash command or plugin.
Overview
An automatic PDF search and download tool for listed company financial reports, supporting Xueqiu (primary source) and Tonghuashun (alternative source), and can be accessed via the Claude Code slash command or the Claude plugin. - (Required): Stock Code, Automatic Market Recognition - (Optional): Search for the latest available report if not specified - (Optional): Default is "Annual Report" In Claude Code, use /download-report directly, driven by .claude/commands/download-report.md, and call scripts/download_report.py to download. Through the commands/download-report.md entry, read the full workflow of skills/report-download/SKILL.md and call skills/report-download/scripts/download_report.py to download. After installation, Claude Code will automatically load the commands/ and skills/ directories, and you can use the /download-report command. The plugin also supports natural language triggering—just say "Download Yili Co.'s 2024 annual report" to Claude and other options to automatically call it. 1. : Parse stock codes, years, report types, automatically identify the market, and format the code 2. : Search in stockn.xueqiu.com via WebSearch; if no results are found, revert to notice.10jqka.com.cn (iFinD) 3. : Exclude non-text files such as summaries and audit reports, and select the most compatible PDF 4. : Download via Python script streaming, supports retry and PDF format verification - Prioritize using Snowball (stockn.xueqiu.com) for search; if no results are found, revert to Straight Flush (notice.10jqka.com.cn) - Download script will verify PDF header (%PDF- magic bytes) - Issue a warning if file size is less than 100KB (may be an abnormal file) - Download timeout is 120 seconds, up to 3 retries (progressive withdrawal) - Download file naming format: {Stock Code}{Report Type}{Year}.pdf
Overview (machine translated)
An automatic PDF search and download tool for listed company financial reports, supporting Xueqiu (primary source) and Tonghuashun (alternative source), and can be accessed via the Claude Code slash command or the Claude plugin.
How to use
- Stock Code (required): Stock code, automatically recognizes the market
- Year (optional): If not specified, search for the latest available report
- Report Type (optional): Default is “Annual Report”
Usage Examples
Supported Markets
| Market | Code Format | Example |
|---|---|---|
| Shanghai A-shares (SH) | 6-digit numbers starting with 6 | 600887 (Yili Co., Ltd.) |
| Shenzhen A-shares (SZ) | 6-digit numbers starting with 0 or 3 | 300750 (CATL) |
| Hong Kong Stocks (HK) | 1-5 digits | 700 or 00700 (Tencent Holdings) |
Types of Supported Reports
| Report Type | User Input | Applicable Market | Typical Release Time |
|---|---|---|---|
| Annual Report | 年报 / annual |
A-shares, Hong Kong stocks | March-April of the following year |
| Mid-Year Report | 中报 / interim |
A-shares, Hong Kong stocks | August-September of the year |
| Q1 Report | 一季报 / Q1 |
Only A-shares | April of the same year |
| Q3 Report | 三季报 / Q3 |
Only A-shares | October of the same year |
Two Usage Paths
This project offers two usage modes, both of which work normally:
1. Slash Command
In Claude Code, use /download-report directly, driven by .claude/commands/download-report.md and call scripts/download_report.py to download.
2. Claude Plugin
Through the commands/download-report.md entry, read the full skills/report-download/SKILL.md workflow and call skills/report-download/scripts/download_report.py to download.
Installation method: Add this repository as a plugin in your project .claude/settings.json:
After adding, Claude Code will automatically load the commands/ and skills/ directories, and the /download-report command can be used. The plugin also supports natural language triggers—simply say “Download Yili Co., Ltd. 2024 annual report” to Claude to automatically call it.
Project Structure
Dependency installation
Only the requests library is required.
This page was translated automatically. Technical details may differ from the original.
Recommended Tools
Try a different keyword or remove a filter.
Install
npx skillfish add terancejiang/skill_financial_report_download