前言¶
做 A 股尽调、合规核对或年报汇编时，公告往往散落在巨潮资讯网（cninfo）里：要按公司翻检索结果，再逐条打开下载。人工在浏览器里重复筛选、保存，耗时长，也容易漏掉某次披露。
若你已经在用 Cursor、Claude Code 等带 Skills 的 Agent，可以把「检索 + 批量下载」交给 Skill，用对话描述需求，由 Agent 按 Skill 说明调用工具。下面介绍 SkillHub 上的 巨潮-A股上市公告查询及批量下载（@user_457a1277/cninfo-filing-scraper）是什么、如何安装，以及适合怎么用。
这是什么¶
巨潮-A股上市公告查询及批量下载 是 SkillHub 社区来源（community）的 professional 类 Skill，当前版本 1.0.0，坐标 @user_457a1277/cninfo-filing-scraper，发布者为 user_457a1277；SkillHub 页面标注作者为 Peter Ynag。
从名称与官方简介可以归纳其定位：面向 巨潮资讯网 A 股上市公告 的 检索与批量下载，官方写明适用于 中介机构开展 A 股公司年报查询及批量下载。标签 requires_api_key=false，表示按 SkillHub 元数据 不需要额外配置 API Key。
- SkillHub 展示页：https://www.skillhub.cn/skills/user_457a1277/cninfo-filing-scraper
- API 条目：https://api.skillhub.cn/user_457a1277/cninfo-filing-scraper
（SkillHub 统计截至页面展示：评分 100000，下载 3167，安装 19。）
核心功能¶
以下能力均来自官方名称与简介，不展开未在资料中出现的接口细节。
- 上市公告检索：在巨潮体系下查询 A 股上市公司公告（Skill 名称中的「查询」）。
- 批量下载：对检索结果进行批量拉取（Skill 名称中的「批量下载」）。
- 年报相关场景：官方简介强调 年报查询及批量下载，适合以年报为主体的合规与尽调工作流。
具体筛选维度、文件格式、元数据字段等，需以安装后的 SKILL.md 及 Skill 内脚本为准；本文无法从当前可访问的下载接口获取包内文档，故不逐项罗列。
安装与启用¶
SkillHub 推荐两种方式：用 CLI 安装到当前 Agent 的 skills 目录，或把安装提示词发给 AI 由其按官方安装文档执行。
1、安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 skillhub：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装文档执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
说明见：https://skillhub.cn/install/skillhub.md。
2、安装本 Skill¶
必须用 --dir 指向当前 Agent 识别的 skills 目录；装到错误路径时 Agent 可能无法加载，部分环境还需重启后生效。
skillhub install user_457a1277/cninfo-filing-scraper --dir <skills 目录>
常用目录示例（来自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
SkillHub 页面提供的 AI 安装提示词为：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_457a1277/cninfo-filing-scraper`。
将上述内容发给当前 Agent 即可按同一流程安装。
3、启用与配置¶
元数据标明 不需要 API Key。安装完成后，在支持 Skills 的客户端中确认该 Skill 已出现在技能列表；若刚安装未生效，可重启客户端或重新打开工作区后再试。
典型用法¶
官方未在公开页面给出固定 CLI 子命令示例，典型用法是对话驱动：在 Skill 已安装的前提下，用自然语言说明 公司 / 公告类型（如年报）/ 是否要批量下载。
示例表述（与官方「年报查询及批量下载」一致，可按实际公司改写）：
请用巨潮 Skill 检索贵州茅台（600519）近年年度报告公告，列出标题与日期，并批量下载到当前项目下的 filings/ 目录。
我是中介机构在做 A 股年报汇编，请从巨潮批量下载指定股票代码列表对应的上一年度年报相关公告。
Agent 会读取 Skill 内的 SKILL.md 决定具体脚本与参数；若某次检索无结果，应先核对股票代码、公告类别与巨潮站点是否可访问。
适用场景与注意¶
适合谁
- 中介机构、研究或合规岗位，需要反复在巨潮上查 A 股年报 并 批量留存公告 的场景。
- 已在使用 Cursor、Claude Code、Codex 等 Agent，希望把「打开巨潮 → 搜索 → 逐条下载」收成对话工作流的用户。
使用注意
- 公告数据版权归巨潮资讯网及披露主体所有，批量下载应遵守网站规则与内部合规要求，仅用于合法授权用途。
- Skill 为社区发布（
community），版本为 1.0.0；升级或行为变更以 SkillHub 上该坐标为准。 - 若
skillhub install因索引或下载接口失败，可先通过 SkillHub 展示页确认 Skill 仍在线，再重试或改用页面上的 AI 安装提示词。
结尾¶
巨潮-A股上市公告查询及批量下载 把巨潮上的 A 股上市公告检索与批量下载封装成 Agent Skill，官方侧重 年报查询及批量下载，且 无需 API Key。需要安装或查看说明时，请打开 SkillHub 展示页：https://www.skillhub.cn/skills/user_457a1277/cninfo-filing-scraper。
