财报下载助手

问题：财报 PDF 难定位

上市公司公告页通常通过动态渲染加载，直接抓 announcementId 或拼接下载链接容易失败。A 股、港股、北交所数据源不同，orgId 格式、搜索参数、直链域名也有差异，手动查公告、判断是否为正式年报、排除提示性公告和摘要，成本高且易漏。

工作方式

该技能把流程收敛为三条链路：

• 沪市/深市/港股：调用巨潮资讯公告搜索 API，按 stock、searchkey、category 等参数查找公告，提取 announcementId；若返回 adjunctUrl，直接拼接 PDF 直链；否则用 agent-browser 打开详情页提取 a 标签中的 static.cninfo.com.cn 地址。
• 北交所：由于巨潮不覆盖，改走东方财富接口，搜索公告后直接下载 pdf.dfcfw.com 的 PDF。
• 结果规范化：按报告类型命名为 {年份}年报.pdf、{年份}Q1.pdf 等，默认输出到 cninfo_reports/，便于按公司目录批量管理。

关键步骤会处理常见坑：深市前缀是 gssz 而非 gszs；部分 orgId 为纯数字或 GD、nssc 前缀；搜索“年报”时可能混入提示性公告、摘要、修订、英文版本；年报发布年份可能滞后于报告期；巨潮页面加载等待方式需要避开 networkidle 卡死。

适用边界

适合批量获取已披露的年度报告、季度报告 PDF，尤其适合 A 股（沪/深/北交所）和港股场景。它不替代公告内容解析、财务指标提取或合规审查；遇到页面反爬、接口限流、PDF 下载失败时，可能需要补充代理、重试或手动核对公告标题。