Arkvol Skill
A skill that queries Arkvol for China, Hong Kong and US market data and retells it with the date, indicators and limits of use
- 200 ★ on the repository
- Last commit
Extended access
Why this level
- Queries and the API key go to the external arkvol.com service, and a leaked key gives others access to your account
- The server forces skill updates, and an update pulls new code from the repository
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/arkvol-skillDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Queries and the API key go to the external arkvol.com service, and a leaked key gives others access to your account
- The server forces skill updates, and an update pulls new code from the repository
This is third-party code. Review the repository files before installing.
What it does
Arkvol Skill connects an agent to arkvol.com, a service that collects indicators for mainland China, Hong Kong and US equity markets. The agent answers natural-language questions: market sentiment and the greed and fear index for A-shares, tech sectors, funds and ETFs, the US medium-term trend and Magnificent Seven rotation, global capital flows, the temperature of Chinese government bonds, stocks near 52-week lows. The `scripts/query.py` script picks the right page for the question (`alla`, `alla-tech`, `funds-greed`, `us7-rotation`, `debt` and others) and fetches data with the API key. The answer carries the data date, key indicators and the limits of use. The skill gives no recommendations to buy or sell specific securities and builds no stock lists, as both the README and `SKILL.md` state. Before every query it checks the version on the server: if the service requires an update, the query stops until the skill is updated.
Who it is for. Private investors and analysts who follow the China and US markets and want an indicator summary from a question in chat while making decisions themselves.
Good fit when
- Before a trading session you want to see what the A-share sentiment looks like
- You wonder whether global capital flow is expanding or contracting and how Chinese government bonds behave
- You want to compare rotation between the Magnificent Seven and the rest of the US market on a medium horizon
- A list of stocks near 52-week lows is gathered as raw material for your own analysis
Not a fit when
- You want specific advice on what to buy or sell: the skill does not give it, by the project's rules
- You want real-time quotes or trading: the skill reads the service's analytical aggregates
- You have no Arkvol key: data is served only with an API key
- The agent cannot reach arkvol.com: every query goes to the service's server
Example request
What does A-share market sentiment look like now according to Arkvol? Give the data date and the key indicatorsLimitations
- An API key from the arkvol.com account is required, and the full key is shown only once. Keep it in `~/.arkvol/arkvol-entry.json`, not in the skill, repository or logs.
- Queries go to the Arkvol server and the service supplies the data. The server blocks skill versions below 0.3.1, so a version check runs first and an update if needed.
- The skill gives no recommendations on specific securities and no stock lists, which is recorded as compliance with Chinese law.
- The README is in Chinese with an English half below, and the repository has no license file.
How to disable. Delete the skill folder from the agent's skills directory. Erase the key from `~/.arkvol/arkvol-entry.json` and regenerate or disable it on the arkvol.com keys page, especially if it reached a chat or a log.
FAQ
How do I install Arkvol Skill?
Ask the agent to install the skill from the `https://github.com/joutaojian/arkvol-skill` repository and set up the key. The key is created on arkvol.com under API Key and written to `~/.arkvol/arkvol-entry.json`.
Where do I keep the API key?
In `~/.arkvol/arkvol-entry.json` in the `api_key` field. The script reads the key from `--api-key`, from the file given by `--config`, from that file and from `shared/arkvol-entry.json` inside the skill. Never publish the skill with a key.
Which questions can I ask?
About A-share sentiment, tech sectors, funds and ETFs, Hong Kong, the US medium-term trend, Magnificent Seven rotation, global capital flow, the temperature of Chinese government bonds and stocks near 52-week lows.
Will the skill advise what to buy?
No. It makes no recommendations to buy or sell specific securities and builds no stock lists, but assesses the market state and gives the limits of use of the data.
Why did the skill stop and ask for an update?
Before a query it checks the version on the server. If it returns exit code 3, `update_required: true` or HTTP 426, a newer version is required: update the skill from the repository and reload the agent.
Discussion
No questions or reviews yet.
Related
SkillsA skill with Chinese A-share market data: quotes, research reports, financials, news and 11 more categories from 34 sources, no keys
A skill for analysing sectors of the Chinese A-share market: policy, media, money flows, companies and ETFs with sources and dates
A skill helps an agent retrieve Chinese-equity data and preserve source responses with timestamps and explicit gaps
A skill with US and global market data: options, VIX, short selling, insider trades, rates and FX, with no API keys
A skill that finds bottlenecks in an industry's supply chain and shortlists A-share, Hong Kong and US stocks with data checks
Four skills for China's A-share market: quotes and indicators, trend-pullback signals, a simulated account and backtests
README in short
The README is bilingual. It describes the service, the compliance note on Chinese law, the skill's role as a reference skill with an API key, getting the key, installing by asking the agent, updating, security rules and terms of use. The English half repeats the same sections.
README badge
Original 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`，再次检查版本，再执行原查询。