披露易公告批量查询下载

问题

港股审计、投研和合规场景中，经常要按股票代码和日期范围核对披露易公告。人工打开网页、逐条复制链接、下载 PDF/HTML，既慢又容易漏掉分页记录；后续导出底稿时，还需要补公司简称、日期、文件类型和超链接。

工作方式

该技能调用港交所披露易标题搜索页背后的 JSON API：https://www1.hkexnews.hk/search/titleSearchServlet.do。它不需要浏览器，通过纯 HTTP 请求按 --stock、--from、--to、--limit 获取公告元数据，并支持将结果输出为 json 或 xlsx。

核心流程包括：

• 搜索公告：按 5 位股票代码和日期范围查询，默认覆盖最近两个月。
• 批量下载：download 子命令并行拉取公告 PDF/HTML，默认 --workers 5。
• 元数据导出：输出 stockCode、stockName、title、date、link、fileType、fileSize、filingType 等字段。
• 公告分类：将记录归入 ANNUAL_REPORT、RESULTS、CIRCULAR、NOTICE、OTHER，便于筛选年报、中报和通函。

适用边界

该工具适合审计底稿、披露完整性检查和公告趋势对比，但依赖港交所未公开接口，端点、字段或请求限制可能变化。全市场查询和长日期范围会产生较多记录，建议先用 --limit 小样本验证；下载本地文档仍需注意来源网站的使用条款。