财报批量下载
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_39a8b4ab/financial-reports-downloader。
技能介绍
要解决什么问题
做基本面或持仓复盘时,往往要把一家上市公司历年年报、半年报、季报的 PDF 凑齐。手工在交易所、巨潮、港交所页面翻公告,既慢又容易把摘要、ESG、英文版等非定期报告混进文件夹,命名也不统一,后续按年份对比很痛苦。
技能如何工作
本技能围绕「下载 → 归置 → 可选清理」三条线,覆盖 A 股(上交所 SSE、深交所 SZSE) 与 港股(HKEX):
- 交易所路由:按代码前缀选下载器——
60xxxx/688xxx走 SSE,000/001/002/30xxxx走 cninfo,0xxxx(5 位)走港交所。 - 零手写映射:深交所
orgId从szse_stock.json解析;港股stockId从activestock_sehk_e.json的i字段解析,无需维护映射表。 - 增量下载:以磁盘上是否已有 PDF 为准;
_done.txt只是辅助,文件丢了会重下。默认目录~/财报,可用环境变量REPORT_DIR覆盖。 - 归置与命名:
organize_rename.py把文件移入公司/子目录,按公司:YYYY年X报告.pdf规范命名,sha256 去重;可选pypdf仅在文件名缺年份时读首页兜底。
终端会输出 SUMMARY 计数,并生成清单 .txt(文件名、大小、披露日、原标题及失败/重复标记),便于核查漏网。
边界与注意点
脚本依赖能访问上交所、巨潮、港交所接口(通常需大陆网络)。上交所直链有 WAF,技能内置处理;年报披露年与文件名年份可能差一年,归置以规范命名规则为准。借壳更名公司的历史公告可能属于原壳公司,需人工甄别。强制全量重下可删 REPORT_DIR/.state/_done.txt(港股还可删相关缓存 JSON)。
使用场景
- 新加入自选或持仓的一家公司,需要把历年定期报告 PDF 一次性落到本地并按公司分子文件夹归档
- 维护多只股票的基本面资料库,重跑脚本只补新披露季报或年报,避免重复请求已落盘文件
- 从巨潮或港交所拉港股财报时不想维护 stockId 映射表,直接用 5 位代码触发自动解析与下载
- 下载完成后要用统一命名规则去重、区分修订版/正文版,并生成带披露日的清单 txt 做漏下核查
适合人员
- 做个股或行业基本面研究的投资者,需要把持仓/自选公司的年报、半年报、季报 PDF 集中存到固定目录
- Quant 或数据工程师要为下游 NLP/表格抽取准备干净的定期报告语料,需剔除摘要与 ESG 等非定期附件
- 在深圳或香港上市覆盖范围内的证券分析师,要为多家公司批量拉公告并保留增量状态以便定期更新
- 在 WorkBuddy 里编排自动化工作流的用户,希望 skill 放目录即可发现、脚本仅依赖 Python 3.10+ 标准库(除可选 pypdf)