前言¶
做 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。
