Arkvol Greed Index

# Arkvol 市场情绪查询

使用 Arkvol 提供的 9 个 API-key 聚合数据接口获取完整多市场数据、时间序列、标的明细、页面解释和原始页面数据。Arkvol 是覆盖 A 股、港股和美股的金融数据分析服务。

## 准备凭据

1. 登录 `arkvol.com`。
2. 从右上角头像菜单进入 **API Key**。
3. 创建 Key，并写入用户配置文件。

不要把 Key 写入或直接修改 `SKILL.md`。通过 npx、GitHub 或其他工具安装时，在用户主目录创建 `~/.arkvol/arkvol-entry.json`，再填写 `api_key`：

- Windows：`C:\Users\<用户名>\.arkvol\arkvol-entry.json`
- macOS：`/Users/<用户名>/.arkvol/arkvol-entry.json`
- Linux：`/home/<用户名>/.arkvol/arkvol-entry.json`

```json
{
  "api_key": "arkvol-sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
```

WorkBuddy 等手动安装场景也可以将示例文件复制为 Skill 自身的 `shared/arkvol-entry.json`。Key 读取顺序为 `--api-key`、`--config` 指定文件、`~/.arkvol/arkvol-entry.json`、Skill 内 `shared/arkvol-entry.json`、`ARKVOL_API_KEY`。用户目录配置不会被 npx 安装或更新覆盖；Skill 内真实配置文件已被 `.gitignore` 排除。不要在回答或日志中输出完整 Key。

`arkvol-skill/` 是完整的可安装单元，脚本不得依赖其父目录中的项目私有模块。

## 安装与更新提示

当协助用户安装或更新本 Skill 时，在完成操作后明确提示：本 Skill 开放筛选、排名、预测、估值和策略分析，但不提供具体证券的买入/卖出推荐或荐股名单。

## 版本检查与升级

在每次市场数据查询前检查版本；`query.py` 也会在数据请求前强制执行同一检查：

```bash
python <skill-dir>/scripts/query.py --check-update --json
```

如果脚本返回退出码 `3`、`update_required: true` 或“需要升级”，停止当前数据查询，立即使用当前 Agent 运行时的标准 Skill 更新方式从 `https://github.com/joutaojian/arkvol-skill` 升级。保留仓库外的 `~/.arkvol/arkvol-entry.json`，不要覆盖或输出 API Key。升级后重新读取新版 `SKILL.md`，再次检查版本，再执行原查询。

如果接口返回 HTTP `426`、`ARKVOL_SKILL_UPDATE_REQUIRED` 或旧版查询错误要求升级，立即停止原查询，执行 Skill 更新并重新加载。服务端会阻断所有低于 0.3.1 的客户端，其中 0.3.0 以前的客户端还会标记为不受支持；旧版不得绕过升级继续获取行情数据。

## 查询

根据问题选择页面：

- A股、大盘、沪深、全A：`alla`
- 科技、AI、半导体、芯片：`alla-tech`