前言¶

做港股合规、尽调或审计底稿时，经常要在港交所披露易上按代码和日期翻公告，再逐条打开 PDF 或 HTML。人工检索和单文件下载在标的多、区间长时很耗时间。下面介绍 SkillHub 上的社区 Skill「披露易-上市公司报告批量查询及下载」，把检索、元数据整理和批量落盘交给 Agent 与配套 Python 脚本完成。

这是什么¶

一句话定位：面向港交所（HKEx）披露易的公告检索与下载工具 Skill，坐标为 @user_457a1277/hkex-filing-scraper，当前版本 1.0.0，分类为 data-analysis，来源为 community，发布者为 user_457a1277（SkillHub 页面标注作者 Peter Ynag）。Skill 标签 requires_api_key=false，不依赖第三方 API Key。

官方页面说明其主要用于中介机构批量查询港股上市公司报告，并注明需要本机 Python 环境。Skill 内脚本通过披露易相关 HTTP 接口拉取数据，无需浏览器自动化。

核心功能¶

以下能力与 Skill 包内 SKILL.md 及商店检索摘要一致：

1. 按条件搜索公告：支持股票代码（5 位数字，如 01748）与日期区间；不指定代码时可查全市场。
2. 批量下载文档：并行下载公告 PDF/HTML 等到本地目录。
3. 元数据导出：输出 JSON，或带超链接的 Excel（xlsx）。
4. 公告类型归类：如年报、业绩、通函、公告等（字段含 filingType 等）。

单条记录常见字段包括：stockCode、stockName、title、date、link、fileType、fileSize、filingType。

在对话中可用触发词唤起，例如：披露易、港交所公告、HKEX filing、HKEx公告下载、披露易搜索、港交所公告下载、港股公告、批量下载公告、HKEX search、披露易爬取。

安装与启用¶

1. 安装 SkillHub CLI¶

若尚未安装，按 SkillHub 安装说明 检查或安装：

command -v skillhub && skillhub --version

未安装时可执行完整安装（文档推荐）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

2. 安装本 Skill¶

安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 且可能不被识别。商店检索给出的安装方式为：

skillhub install hkex-filing-scraper --namespace user_457a1277 --dir <skills 目录>

常见路径示例（以 SkillHub 文档为准）：

• Cursor：~/.cursor/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/
• Claude Code：~/.claude/skills/

安装完成后按所用客户端要求刷新或重启 Agent，使 Skill 生效。

3. Python 依赖¶

Skill 元数据要求 Python >= 3.10，并依赖：

• requests
• beautifulsoup4
• openpyxl

在运行脚本前于本机安装上述包即可。

典型用法¶

Agent 按 Skill 指引调用包内 scripts/hkex_scraper.py。进入 Skill 安装目录后，示例如下（与官方 SKILL.md 一致）。

搜索某只股票最近默认区间（约 2 个月）的公告：

python scripts/hkex_scraper.py search --stock 01748

指定日期范围：

python scripts/hkex_scraper.py search --stock 01748 --from 2024-01-01 --to 2024-12-31

不指定股票、按日期查全市场：

python scripts/hkex_scraper.py search --from 2026-04-01 --to 2026-04-22

下载到本地目录：

python scripts/hkex_scraper.py download --stock 01748 --from 2026-01-01 --output ./pdfs

导出 Excel：

python scripts/hkex_scraper.py search --stock 01748 --from 2025-01-01 --format xlsx --output 01748_filings.xlsx

限制条数：

python scripts/hkex_scraper.py search --stock 01748 --limit 50

主要参数：search / download 子命令；--stock、--from、--to、--limit、--format（json / xlsx）、--output、--workers（默认并行下载线程数 5）。

Skill 文档中的适用表述包括：拉取某港股客户特定期间公告列表、批量下载年报/中报/通函、检查披露及时性与完整性等。

适用场景与注意¶

适合谁：需要批量查披露易、整理公告清单或落盘 PDF/HTML 的分析师、中介、审计与合规相关岗位；与「打开网页逐条点击」相比，更适合重复、区间明确的任务。

使用注意：

• 依赖港交所披露易站点与接口可用性；Skill 说明其调用搜索相关 HTTP 端点（如 titleSearchServlet.do），网络或站点变更可能影响结果。
• 批量下载请注意本地磁盘与并发（--workers），避免对目标站点造成过高压力。
• 社区 Skill（community），使用前请自行评估合规与数据使用边界；元数据记载本包基于开源项目适配，具体许可见 Skill 包内说明。
• 商店统计（抓取时点）：评分 100000，下载约 819 次；以 SkillHub 技能页 为准。

结尾¶

「披露易-上市公司报告批量查询及下载」把披露易检索、元数据导出和批量下载收敛到同一套 Skill 与脚本流程，适合港股公告的批量处理场景。安装与详情见 SkillHub：

• 技能页：https://www.skillhub.cn/skills/user_457a1277/hkex-filing-scraper
• API 坐标：https://api.skillhub.cn/user_457a1277/hkex-filing-scraper