Company Hot Stocks

从 GodKnows 投资分析平台获取热门股票列表。本技能为通用技能，安装到统一目录后可供 Cursor、Qoder 等多种 agent 引用。

安装

使用 skills CLI 从 registry 安装（全局安装到 ~/.agents/skills/）：

npx skills add http://skills.whatis.vip --skill company-hot-stocks -g

安装后技能根目录为 ~/.agents/skills/company-hot-stocks/。下文的 <SKILL_ROOT> 即该技能根目录。

配置（与 company-checkup 共用）

• 推荐：使用统一配置路径 ~/.config/godknows/config.json（与 company-checkup、company-latest-report 等共用）。格式：

  { "api_base": "http://money.whatis.vip", "username": "xxx", "password": "xxx", "token": "获取到的token" }
  

• 运行时将 api_base、token 通过环境变量 GODKNOWS_API_BASE、GODKNOWS_TOKEN 传给脚本。

首次使用

若尚无 token，向用户询问用户名和密码，在技能根目录下执行登录脚本：

bash <SKILL_ROOT>/scripts/login.sh <username> <password> [api_base]

登录成功后会写入 ~/.config/godknows/config.json。token 过期时：执行 bash <SKILL_ROOT>/scripts/login.sh（不传参）从 config 刷新 token。

后续使用

直接使用 config 中的 token。若 API 返回 errorCode: "NOT_LOGIN"，执行 bash <SKILL_ROOT>/scripts/login.sh 刷新 token。

执行流程

1. 获取热门股票列表

bash <SKILL_ROOT>/scripts/hot_stocks.sh [api_base] [token]

调用 GET /api/fundamental/hot-stock/list，返回格式示例：

{
  "success": true,
  "data": [
    {"ticker": "AAPL", "name": "Apple Inc.", "addedAt": "2024-01-15"},
    {"ticker": "00700.HK", "name": "腾讯控股", "addedAt": "2024-01-10"}
  ]
}

2. 格式化输出

将 JSON 格式化为表格：

• 标题：热门股票列表
• 列：股票代码、公司名称、添加日期

3. 错误处理

• errorCode: "NOT_LOGIN" → 执行 bash <SKILL_ROOT>/scripts/login.sh 刷新 token
• success: false → 提示获取失败及错误信息
• 网络超时 → 提示 API 不可达