Agent Skills
返回列表
财报批量下载

财报批量下载

数据分析 更新于 2026.08.30

将以下提示词粘贴到你的 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)