财务对比:在 Agent 里做多只股票估值横向对比

前言

做个股研究时,经常要在同一段对话里拉齐多只股票的市值、PE、PB,再对照行业均值和估值百分位。自己拼接口或翻网页,步骤碎、口径也容易不一致。下面介绍 SkillHub 上的「财务对比」Skill:它把广发证券的量化接口封装成 Agent 可调用的能力,面向「多标的、同一套估值字段」的横向对比。

这是什么

「财务对比」是 SkillHub 坐标 @org-mijzrode/gfstockvaluation 的企业级 Skill(来源 enterprise,分类 professional),当前版本 1.0.1,由 广发证券 发布。

一句话定位:基于广发证券接口,查询多只股票市值、PE、PB、行业均值与估值百分位,用于个股估值横向财务对比。SkillHub 页面显示评分 100000,下载 1989 次;技能带 requires_api_key=true 标签,使用前需完成 API Key 配置。

官方入口:

  • API 元数据:https://api.skillhub.cn/org-mijzrode/gfstockvaluation
  • SkillHub 展示页:https://www.skillhub.cn/skills/org-mijzrode/gfstockvaluation

核心功能

结合 SkillHub 简介与技能包内 SKILL.md,已核实的能力包括:

  1. 多股票批量查询:通过 stock_codes 传入多只证券代码(示例为深交所格式,如 SZ000776、SZ000001)。
  2. 统一估值字段:返回侧覆盖市值、PE、PB,以及行业均值、估值百分位等,便于在同一对话里横向比较。
  3. 固定后端调用形态:经广发 Skills MCP 网关,服务名 quant,工具名 common_basic_post,请求方式为 POST。

数据与口径以广发证券接口为准;Skill 负责告诉 Agent 如何鉴权、调哪条地址、传哪些参数,而不是替代你自己的投资判断。

安装与启用

用 SkillHub CLI 安装

先确认本机已有 skillhub(安装方式见 SkillHub 安装文档)。安装技能时必须用 --dir 指向当前 Agent 的 skills 目录,否则默认落在 ./skills/,Agent 可能识别不到。

skillhub install gfstockvaluation --namespace org-mijzrode --dir <你的 Agent skills 目录>

常见 Agent 的 skills 目录(摘自官方安装文档):

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

安装完成后,按你所用客户端的要求重启或刷新 Agent,使新 Skill 被加载。

让 AI 代为安装

SkillHub 页面提供的提示词等价于:让 Agent 阅读 https://skillhub.cn/install/skillhub.md,并安装 @org-mijzrode/gfstockvaluation。适合已习惯用对话管理技能环境的场景。

API Key 配置

SKILL.md 中的鉴权规则如下:

  • 环境变量名:GF_SKILLS_APIKEY
  • 未配置 Key 时不应继续调用接口,应引导用户前往 http://hd.gf.com.cn/skills-market 申请与配置

将 Key 写入 Agent 运行环境能读到的位置(例如 shell 环境变量或客户端约定的 secrets 配置),再发起查询。

典型用法

在对话里做对比

启用 Skill 并配置 GF_SKILLS_APIKEY 后,用自然语言说明要比对的股票即可,例如:列出代码或名称,并要求同时给出 PE、PB、行业均值与估值百分位。Agent 会按 SKILL.md 走广发接口,而不是凭空编造行情。

直接调用网关(核对用)

下列示例来自技能包 SKILL.md,用于理解请求结构;实际研究中通常仍通过 Agent 调用。

curl -X POST 'https://mcp-api.gf.com.cn/gf-skills/skills/mcp/call' \
--header 'Content-Type: application/json' \
--header "Authorization: Bearer ${GF_SKILLS_APIKEY}" \
--data '{
  "service_name": "quant",
  "tool_name": "common_basic_post",
  "args": {
    "stock_codes": ["SZ000776", "SZ000001"]
  }
}'

请求体中的 service_name、tool_name 与 args.stock_codes 需与文档一致;证券代码格式须符合接口要求。

适用场景与注意

适合谁

  • 需要在 Cursor、Claude Code、Codex 等环境里做多标的估值横向对比的开发者或研究员。
  • 已能申请广发 Skills 市场 API Key、并愿意把查询约束在官方接口能力范围内的人。

限制与注意

  1. 强依赖 Key 与网络:无 GF_SKILLS_APIKEY 不能调用;企业源 Skill,合规与配额以广发侧规则为准。
  2. 不是通用行情终端:能力边界以简介和 SKILL.md 为准,未文档化的字段或市场不要假设支持。
  3. 投资免责:输出用于研究辅助,不构成投资建议;重大决策仍需独立核实源数据与披露文件。
  4. 安装路径:务必 --dir 指向当前 Agent 的 skills 目录,避免装到默认 ./skills/ 后「已安装但不可用」。

结尾

「财务对比」把广发证券的多标的估值查询收敛成 Agent Skill:装好 @org-mijzrode/gfstockvaluation、配置 GF_SKILLS_APIKEY,即可在对话里对齐市值、PE、PB、行业均值与估值百分位。详情与安装入口见 SkillHub 技能页 与 API 地址。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜