SuperAPI AI 工具集

report-download

通用与其它

查看项目

更新于 10-16 07:22

技能介绍

用途:自动完成 A 股与港股上市公司财报 PDF 的检索与下载,数据来源为雪球 stockn.xueqiu.com,同花顺 notice.10jqka.com.cn 作为备选。

输入与识别:输入包括 stock_code(必填)、year(可选,默认最新可得年份)、report_type(可选,默认年报)。市场按代码规则识别:6 位以 6 开头为沪市 A 股,加 SH 前缀,如 600887 → SH600887;6 位以 0 或 3 开头为深市 A 股,加 SZ 前缀,如 300750 → SZ300750;1 至 5 位为港股,补足 5 位,如 700 → 00700;已带 SH/SZ 前缀则原样使用。

报告类型支持:年报、中报、一季报、三季报;A 股检索关键词分别为年度报告、半年度报告、第一季度报告、第三季度报告,港股关键词为 annual report、interim report,港股不支持一季报和三季报。

检索流程:使用 WebSearch,A 股查询形如 site:stockn.xueqiu.com {formatted_code} {search_keyword} {year},港股使用对应关键词;未指定年份时先试当前年再试上一年。雪球无结果时改用 site:notice.10jqka.com.cn 检索,也可加公司名,仍无结果则去掉 site: 前缀重试。随后提取匹配来源的 PDF 链接,并剔除含摘要、审计报告、公告、利润分配、可持续发展、股东大会、ESG、summary、auditor、dividend、更正、补充、意见、内部控制等字样的结果,优先选择标题含报告关键词且不含摘要、URL 日期最接近预期发布时间的文件。

下载方式:如缺少依赖,安装命令为 pip install requests --break-system-packages;随后运行 ${CLAUDE_PLUGIN_ROOT}/skills/report-download/scripts/download_report.py,需传入 --url、--stock-code、--report-type、--year、--save-dir 参数。脚本在 ---RESULT--- 与 ---END--- 之间输出 status、filepath、filesize、message。成功时报告文件路径、大小、股票代码、年份与报告类型;失败时给出错误信息,并建议检查链接可访问性、重试或核对输入。

限制:依赖网络检索与两个指定站点的可访问性;港股无季度报告类型;无法保证总能找到目标文件,检索失败时需人工核对代码、年份或报告类型。收费、价格与平台支持等其它信息暂未提供。