Arkvol Skill
Скилл запрашивает у Arkvol данные по рынкам Китая, Гонконга и США и пересказывает их с датой, показателями и границами применения
- 200 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Запросы и ключ API уходят во внешний сервис arkvol.com, а утечка ключа дает чужой доступ к вашему аккаунту
- Сервер принудительно требует обновления скилла, и обновление подтягивает новый код из репозитория
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/arkvol-skillОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Запросы и ключ API уходят во внешний сервис arkvol.com, а утечка ключа дает чужой доступ к вашему аккаунту
- Сервер принудительно требует обновления скилла, и обновление подтягивает новый код из репозитория
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Arkvol Skill подключает агента к сервису arkvol.com, который собирает показатели по рынкам акций материкового Китая, Гонконга и США. Агент отвечает на вопросы на естественном языке: настроение рынка и индекс жадности и страха по A-акциям, технологические сектора, фонды и ETF, среднесрочный тренд США и ротация «великолепной семерки», глобальные потоки капитала, температура китайских госбумаг, акции у 52-недельных минимумов. Скрипт `scripts/query.py` выбирает нужную страницу по вопросу (`alla`, `alla-tech`, `funds-greed`, `us7-rotation`, `debt` и другие) и забирает данные по ключу API. Ответ содержит дату данных, ключевые показатели и границы применения. Скилл не дает рекомендаций купить или продать конкретные бумаги и не составляет списков акций, это записано и в README, и в самом `SKILL.md`. Перед каждым запросом он проверяет версию на сервере: если сервис требует обновления, запрос останавливается до обновления скилла.
Для кого. Частным инвесторам и аналитикам, которые следят за рынками Китая и США и хотят получать сводку показателей по вопросу в чате, а решения принимать самостоятельно.
Подходит, если
- Перед торговой сессией надо понять, как выглядит настроение на рынке A-акций
- Интересует, расширяется или сжимается глобальный поток капитала и как ведут себя китайские госбумаги
- Нужно сравнить ротацию между «великолепной семеркой» и остальным рынком США на среднем горизонте
- Список акций у 52-недельных минимумов собирается как исходный материал для собственного анализа
Не подходит, если
- Нужны конкретные советы, что купить или продать: скилл их не дает по правилам проекта
- Нужны котировки в реальном времени или торговля: скилл читает аналитические агрегаты сервиса
- Нет ключа Arkvol: данные выдаются только по ключу API
- Агент не может обращаться к arkvol.com: все запросы идут на сервер сервиса
Пример запроса к агенту
Как сейчас выглядит настроение на рынке A-акций по данным Arkvol? Назови дату данных и ключевые показателиОграничения
- Нужен ключ API из личного кабинета arkvol.com: полный ключ показывается один раз. Хранить его следует в `~/.arkvol/arkvol-entry.json`, а не в скилле, репозитории и логах.
- Запросы идут на сервер Arkvol, данные поставляет сервис. Версии скилла ниже 0.3.1 сервер блокирует, поэтому перед запросом идет проверка версии и при необходимости обновление.
- Рекомендаций по конкретным бумагам и списков акций скилл не выдает, это зафиксировано в соблюдении китайского законодательства.
- README написан по-китайски с английской половиной ниже, в репозитории нет файла лицензии.
Как отключить. Папку скилла удаляют из каталога скиллов агента. Ключ стирают из `~/.arkvol/arkvol-entry.json` и перевыпускают или отключают на странице ключей arkvol.com, особенно если он попал в чат или журнал.
Частые вопросы
Как установить Arkvol Skill?
Попросите агента установить скилл из репозитория `https://github.com/joutaojian/arkvol-skill` и настройте ключ. Ключ создается на arkvol.com в разделе API Key и записывается в `~/.arkvol/arkvol-entry.json`.
Где хранить ключ API?
В `~/.arkvol/arkvol-entry.json` в поле `api_key`. Скрипт читает ключ из `--api-key`, из файла по `--config`, из этого файла и из `shared/arkvol-entry.json` внутри скилла. Публиковать скилл вместе с ключом нельзя.
Какие вопросы можно задавать?
О настроении A-акций, технологических секторах, фондах и ETF, Гонконге, среднесрочном тренде США, ротации «великолепной семерки», глобальном потоке капитала, температуре госбумаг Китая и акциях у 52-недельных минимумов.
Даст ли скилл совет, что покупать?
Нет. Скилл оценивает состояние рынка и называет границы применения данных. Рекомендаций по конкретным бумагам и списков акций он не выдает.
Почему скилл остановился и просит обновиться?
Перед запросом он проверяет версию на сервере. Если вернулся код выхода 3, `update_required: true` или HTTP 426, нужна новая версия: обновите скилл из репозитория и перезагрузите агента.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыСкилл с данными рынка акций Китая: котировки, отчеты, финансы, новости и еще 11 категорий из 34 источников без ключей
Скилл для разбора секторов китайского рынка А-акций: политика, СМИ, потоки денег, компании и ETF с источниками и датами
Скилл помогает агенту получать данные китайских акций и сохранять ответы источников вместе с временем и пропусками
Скилл с данными по американским и мировым рынкам: опционы, VIX, короткие продажи, сделки инсайдеров, ставки и курсы, без ключей API
Скилл ищет узкие места в цепочке поставок отрасли и отбирает акции китайских бирж, Гонконга и США с проверкой по котировкам
Четыре скилла для китайского рынка акций: котировки и индикаторы, сигналы отката в тренде, симулированный счет и бэктест
Коротко о README
README двуязычный. В нем описаны сервис, оговорка о соответствии законодательству Китая, роль скилла как образцового скилла с ключом API, получение ключа, установка через просьбу агенту, обновление, правила безопасности и условия использования. Английская часть повторяет те же разделы.
Бейдж для README
Исходный SKILL.md
---
name: arkvol-greed-index
description: 查询并深度分析 Arkvol A股、港股、美股、基金、ETF、宽基、贪婪指数、科技板块、七巨头、Mag7、全球资金流、美元美债流动性、中国国债温度和52周低位数据。用于市场情绪、指标解释、筛选、排名、比较、预测、估值、目标价、仓位和策略分析；不提供具体证券买入/卖出推荐或荐股名单。
---
# 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`，再次检查版本，再执行原查询。