前言¶
做财务审计或投研时，经常需要把某只股票某一年的年报 PDF 或公告页找出来。手工在上交所、北交所披露站点里按代码和年份检索，步骤重复，也不适合写进自动化流水线。若希望由 Agent 根据「股票代码 + 年度」直接给出可访问的年报链接，可以安装 SkillHub 上的社区 Skill「上市公司年报下载」（坐标 @user_1d6ff26f/stockreportdownload，当前版本 1.0.2）。
这是什么¶
「上市公司年报下载」是 SkillHub 分类 data-analysis 下的社区 Skill，发布者为 user_1d6ff26f。官方简介说明：根据股票代码和年度抓取上市公司发布的年报链接；目前仅支持上交所、北交所。标签标明 requires_api_key=false，使用时无需单独配置 API Key。Skill 面向财务审计、投资研究和自动化数据抓取等需要批量或对话式获取披露链接的场景。
SkillHub 页面：上市公司年报下载。技能元数据地址：https://api.skillhub.cn/user_1d6ff26f/stockreportdownload（用于商店与 Agent 拉取技能描述）。
核心功能¶
依据已公开的 SkillHub 资料，可核实的能力如下：
- 输入维度：股票代码与财报年度（由用户在对话或任务中提供，Skill 据此检索）。
- 输出：对应上市公司在该年度披露的年报相关链接（具体字段与格式以技能包内
SKILL.md为准）。 - 交易所范围：上交所、北交所；未在简介中声明支持深交所等其他市场。
- 依赖：不需要 API Key（
requires_api_key=false）。
安装与启用¶
下面介绍通过 SkillHub CLI 将技能安装到当前 Agent 可识别的 skills 目录。安装说明亦见于 SkillHub 安装文档 与技能详情页。
1、检查或安装 skillhub CLI¶
先确认本机是否已有 CLI：
command -v skillhub && skillhub --version
若未安装，可按官方文档执行完整安装（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
2、安装本 Skill¶
安装时必须用 --dir 指向当前 Agent 实际读取的 skills 目录；否则默认会装到 ./skills/，Agent 可能无法加载。官方安装文档给出的常见路径包括：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
在对应目录下执行（将 <skills 目录> 换成你的环境路径）：
skillhub install @user_1d6ff26f/stockreportdownload --dir <skills 目录>
技能页亦提示：可将安装说明发给 AI，让其按 SkillHub 安装文档 安装 @user_1d6ff26f/stockreportdownload。安装后若 Agent 未立即识别新技能，需按你所用客户端的说明重启或刷新 skills 加载。
典型用法¶
公开页面未附带固定股票代码的复制示例；用法与简介一致，可在启用该 Skill 的 Agent 对话中说明需求，例如：
- 写明股票代码（上交所或北交所标的，格式以交易所惯例为准）。
- 写明年度（指年报所属会计年度或你需要的披露年份，与 Skill 内约定一致）。
- 让 Agent 调用本 Skill，返回该标的在该年度的年报链接，再自行下载或交给后续爬虫、归档脚本处理。
经过上面的步骤，适合把「查链接」交给 Agent，而把「落盘、解析 PDF、入库」留在你自己的流水线里。
适用场景与注意¶
适合谁
- 审计、合规或财务团队需要快速定位指定公司某年年报披露页。
- 投研人员在做历史财报对比前，先批量收集链接。
- 编写自动化任务时，用 Agent + Skill 替代反复打开交易所网站的检索操作。
限制与注意
- 交易所：仅上交所、北交所；深交所等市场不在当前简介支持范围内，勿假设通用 A 股全覆盖。
- 版本与来源：社区发布（
community），升级前可在 SkillHub 查看 v1.0.2 及后续变更。 - 合规：年报链接来自公开披露渠道；批量下载与二次分发须遵守交易所与各公司版权、使用条款及你所在机构的合规要求。
- 统计信息：SkillHub 页面展示的评分、下载次数会随时间变化；撰写时页面记载为评分 100000、下载 1616 次（以你打开页面时的数据为准）。
结尾¶
「上市公司年报下载」把「股票代码 + 年度 → 年报链接」收敛成可在 Agent 里复用的 Skill，并明确覆盖上交所与北交所、且无需 API Key。需要安装或查看说明时，请访问 SkillHub 技能页：https://www.skillhub.cn/skills/user_1d6ff26f/stockreportdownload 。
