Stock Query

从 GodKnows 投资分析平台获取股票实时行情，数据来源 Yahoo Finance。本技能为通用技能，安装到统一目录后可供 Cursor、Qoder 等多种 agent 引用。

安装

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

npx skills add http://skills.whatis.vip --skill stock-query -g

安装后技能根目录为 ~/.agents/skills/stock-query/。Cursor、Qoder 等可配置为直接引用 ~/.agents/skills/，或由 npx skills add 在安装时同步到各自 agent 目录（如 ~/.cursor/skills/、~/.qoder/skills/）。下文的 <SKILL_ROOT> 即该技能根目录（例如 ~/.agents/skills/stock-query）。

配置（与安装位置解耦）

推荐：使用统一配置路径 ~/.config/godknows/config.json（与技能安装位置无关，便于多端共用）。格式：
```
{ "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（含 api_base、token、username、password_b64），与 company-checkup、cashflow-viewer 等技能共用。token 过期时：执行 bash <SKILL_ROOT>/scripts/login.sh（不传参），会从 config 读取账号密码并刷新 token，无需再向用户索要。

后续使用

直接使用 config 中的 token。若 API 返回 errorCode: "NOT_LOGIN"，执行 bash <SKILL_ROOT>/scripts/login.sh（不传参）从 config 刷新 token 即可。

执行流程

1. 查询单个股票行情

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

返回格式：

{
  "success": true,
  "data": {
    "ticker": "AAPL",
    "price": 175.50,
    "previousClose": 174.20,
    "change": 1.30,
    "changePercent": 0.75,
    "volume": 52345678,
    "marketCap": 2750000000000
  }
}

2. 批量查询股票

bash <SKILL_ROOT>/scripts/query.sh "AAPL,GOOGL,NVDA" [api_base] [token]

逗号分隔多个股票代码，返回数组。

3. 查询财务摘要

bash <SKILL_ROOT>/scripts/query.sh <ticker> financial [api_base] [token]

返回 FCF、PE、市值、流通股等财务数据。

支持的股票代码格式

市场	格式	示例
美股	股票代码	AAPL, GOOGL, NVDA
港股	代码.HK	00700.HK, 09988.HK

错误处理

errorCode: "NOT_LOGIN" → 执行 login.sh 刷新 token
success: false → 股票代码可能不正确
网络超时 → 提示 API 不可达