Skip to content
Back to search

arkvol-skill

Arkvol Skill 将 arkvol.com 的数据查询与解读能力接入兼容 Agent Skills 的 AI Agent。安装后,可以直接用自然语言查询 A 股与科技板块、港股、基金与 ETF、美股中期趋势及七巨头轮动等数据,并获得包含数据日期、关键指标和风险边界的分析结果。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/joutaojian--arkvol-skill/badge.svg)](/listings/joutaojian--arkvol-skill)

HTML

<a href="/listings/joutaojian--arkvol-skill"><img src="/api/listings/joutaojian--arkvol-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Arkvol Skill 基于开放的 [Agent Skills](https://agentskills.io) 协议,可在兼容 Agent Skills 的 AI Agent 中运行。

> **安装前请知悉:本 Skill 不提供具体证券买入/卖出推荐,也不生成股票、基金或 ETF 荐股名单。**

打开你正在使用的 Agent(如 Claude Code、Codex、Cursor、OpenClaw 或 WorkBuddy),告诉它:

帮我安装这个 Skill:https://github.com/joutaojian/arkvol-skill,并帮我配置 Arkvol Skill 的 API Key。
我的 API Key 是:[替换成你的 API Key]

安装完成后可直接询问:

现在 A 股情绪怎么样?
全球资金流蛋糕当前是扩张还是收缩?
中国 30 年期国债温度是多少?

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 101 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: arkvol-greed-index
  3. description: 查询并深度分析 Arkvol A股、港股、美股、基金、ETF、宽基、贪婪指数、科技板块、七巨头、Mag7、全球资金流、美元美债流动性、中国国债温度和52周低位数据。用于市场情绪、指标解释、筛选、排名、比较、预测、估值、目标价、仓位和策略分析;不提供具体证券买入/卖出推荐或荐股名单。
  4. ---
  5. # Arkvol 市场情绪查询
  6. 使用 Arkvol 提供的 9 个 API-key 聚合数据接口获取完整多市场数据、时间序列、标的明细、页面解释和原始页面数据。Arkvol 是覆盖 A 股、港股和美股的金融数据分析服务。
  7. ## 准备凭据
  8. 1. 登录 `arkvol.com`。
  9. 2. 从右上角头像菜单进入 **API Key**。
  10. 3. 创建 Key,并写入用户配置文件。
  11. 不要把 Key 写入或直接修改 `SKILL.md`。通过 npx、GitHub 或其他工具安装时,在用户主目录创建 `~/.arkvol/arkvol-entry.json`,再填写 `api_key`:
  12. - Windows:`C:\Users\<用户名>\.arkvol\arkvol-entry.json`
  13. - macOS:`/Users/<用户名>/.arkvol/arkvol-entry.json`
  14. - Linux:`/home/<用户名>/.arkvol/arkvol-entry.json`
  15. ```json
  16. {
  17. "api_key": "arkvol-sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  18. }
  19. ```
  20. 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。
  21. `arkvol-skill/` 是完整的可安装单元,脚本不得依赖其父目录中的项目私有模块。
  22. ## 安装与更新提示
  23. 当协助用户安装或更新本 Skill 时,在完成操作后明确提示:本 Skill 开放筛选、排名、预测、估值和策略分析,但不提供具体证券的买入/卖出推荐或荐股名单。
  24. ## 版本检查与升级
  25. 在每次市场数据查询前检查版本;`query.py` 也会在数据请求前强制执行同一检查:
  26. ```bash
  27. python <skill-dir>/scripts/query.py --check-update --json
  28. ```
  29. 如果脚本返回退出码 `3`、`update_required: true` 或“需要升级”,停止当前数据查询,立即使用当前 Agent 运行时的标准 Skill 更新方式从 `https://github.com/joutaojian/arkvol-skill` 升级。保留仓库外的 `~/.arkvol/arkvol-entry.json`,不要覆盖或输出 API Key。升级后重新读取新版 `SKILL.md`,再次检查版本,再执行原查询。
  30. 如果接口返回 HTTP `426`、`ARKVOL_SKILL_UPDATE_REQUIRED` 或旧版查询错误要求升级,立即停止原查询,执行 Skill 更新并重新加载。服务端会阻断所有低于 0.3.1 的客户端,其中 0.3.0 以前的客户端还会标记为不受支持;旧版不得绕过升级继续获取行情数据。
  31. ## 查询
  32. 根据问题选择页面:
  33. - A股、大盘、沪深、全A:`alla`
  34. - 科技、AI、半导体、芯片:`alla-tech`
  35. - 基金、ETF、宽基:`funds-greed`
  36. - 港股、恒生、全球、海外、乖离率:`gll`
  37. - 美股贪婪、中期、中线、趋势:`greed-mid-term`
  38. - 美股七巨头、七姐妹、Mag7、轮动:`us7-rotation`
  39. - 全球资金流、资金蛋糕、全球轮动、美元美债流动性闸门:`global-capital-flow`
  40. - 中国国债、30 年期收益率、国债价格温度:`debt`
  41. - 52 周低位、GGBL 杠杆样本聚合数量:`low-52w-leverage`
  42. 执行:
  43. ```bash
  44. python <skill-dir>/scripts/query.py --query "现在 A 股情绪怎么样"
  45. python <skill-dir>/scripts/query.py --page us7-rotation --json
  46. python <skill-dir>/scripts/query.py --query "全球资金流蛋糕当前是什么状态" --json
  47. python <skill-dir>/scripts/query.py --query "按估值和动量给七巨头排名" --json
  48. python <skill-dir>/scripts/query.py --query "预测美股中期趋势并测算目标区间" --json
  49. python <skill-dir>/scripts/query.py --page debt
  50. python <skill-dir>/scripts/query.py --page alla --config /path/to/arkvol-entry.json
  51. ```
  52. `<skill-dir>` 是当前 `SKILL.md` 所在目录。先解析 Skill 的实际安装位置,不要假设智能体的当前工作目录就是 Skill 目录。
  53. 客户端默认请求 `view=full`。分析任务使用 `--json`,完整读取 `summary`、`page_text`、`metrics`、`items`、`series`、`original_page_data` 和数据来源字段。只有明确需要轻量结果时才传入 `--view summary`。
  54. 直接处理客观筛选、排名、板块比较、未来趋势预测、估值、目标价测算、仓位分析、止盈止损测算和策略研究。说明筛选条件、排序口径、预测周期、数据日期、计算方法和关键假设;区分 Arkvol 原始字段、智能体计算结果和推断。
  55. ## 荐股边界
  56. 不提供具体证券的买入/卖出推荐,不生成“推荐股票/基金/ETF”“买哪只/卖哪只”“最值得买的标的”等荐股名单。收到纯荐股请求时直接说明边界,不调用 API;收到混合请求时保留允许的筛选、排名、预测和测算部分,只省略最终买卖推荐。上游数据中的信号或动作性文字仅作为分析字段,不得直接转写为智能体的荐股结论。
  57. ## 解读
  58. - 0-20:极度恐慌
  59. - 20-40:恐慌
  60. - 40-60:中性
  61. - 60-80:贪婪
  62. - 80-100:极度贪婪
  63. 先说明数据日期,再给出聚合状态和关键指标。使用 `items` 做横截面筛选和排名,使用 `series` 做趋势、动量、波动和预测分析,使用 `page_text` 校准指标口径,并结合多个页面形成深度分析。全球资金流分数是风险偏好代理,不是真实跨境资金净流量;国债温度是收益率逆向分位;52 周低位表示历史价格位置,可与其他指标组合分析。
  64. ## 错误处理
  65. - Key 缺失:明确告知尚未配置成功,并引导用户前往 `https://arkvol.com` 注册或登录,点击右上角头像进入 **API Key** 页面创建 Key,再写入 `~/.arkvol/arkvol-entry.json`。不要反复请求接口。
  66. - 401/403:提示 Key 无效、已禁用或账户无权限,不展示 Key。
  67. - 网络失败:说明无法连接 Arkvol,建议稍后重试。
  68. - 无数据:明确说明当前页面暂无数据,不编造分数或趋势。
  69. 页面字段和 API 结构详见 [reference.md](reference.md)。
README.md · README · 145 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. **简体中文** | [English](#english)
  3. # Arkvol Skill
  4. **让 AI Agent 使用自然语言查询并解读多市场金融数据**
  5. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
  6. [![Agent Skills](https://img.shields.io/badge/Agent%20Skills-Standard-green)](https://agentskills.io)
  7. [![skills.sh](https://img.shields.io/badge/skills.sh-Compatible-blue)](https://skills.sh)
  8. [![Multi-Runtime](https://img.shields.io/badge/Runtime-Claude%20Code%20%20Codex%20%20Cursor%20%20OpenClaw%20%20Hermes-blueviolet)](#2-安装-skill)
  9. [Arkvol.com](https://arkvol.com) · [安装](#2-安装-skill) · [更新](#3-更新-skill) · [安全与合规](#安全与合规)
  10. <p align="center">
  11. <img src="shared/arkvol-hero-16x9.gif" alt="Arkvol Skill Hero" />
  12. <br/>
  13. </p>
  14. </div>
  15. ## 简介
  16. [arkvol.com](https://arkvol.com) 是覆盖 A 股、港股和美股的金融数据分析服务,通过市场情绪、贪婪与恐慌指数、板块轮动等指标,帮助用户观察市场状态和趋势。
  17. Arkvol Skill 将 [arkvol.com](https://arkvol.com) 的数据查询与解读能力接入兼容 Agent Skills 的 AI Agent。安装后,可以直接用自然语言查询 A 股与科技板块、港股、基金与 ETF、美股中期趋势、七巨头、全球资金流、中国国债温度和 52 周低位数据。
  18. > **合规声明:Arkvol Skill 遵守中国法律法规,不提供具体证券买入/卖出推荐,也不生成股票、基金或 ETF 荐股名单。**
  19. 当前源码版本见 [`VERSION`](VERSION)。
  20. ## API Key Skill 参考实例
  21. 这是一个原生支持 API Key 配置的 Skill,已经过 100+ 用户的实践测试,可作为其他项目开发 API Key Skill 的参考实例。
  22. 可复用的设计包括:将用户密钥持久化在 Skill 仓库之外、支持命令行/配置文件/环境变量的明确优先级、支持自动化升级、提供不含真实密钥的示例配置、统一处理鉴权错误,以及避免在回答和日志中输出完整 Key。其他 Skill 项目可以借鉴这套配置与安全边界设计。
  23. ## 1. 获取 API Key
  24. 前往 [arkvol.com](https://arkvol.com) 注册或登录,从右上角头像进入 **API Key** 页面创建 Key。完整 Key 仅显示一次。
  25. <img src="shared/p1.png" alt="Arkvol API Key 创建页面" />
  26. ## 2. 安装 Skill
  27. Arkvol Skill 基于开放的 [Agent Skills](https://agentskills.io) 协议,可在兼容 Agent Skills 的 AI Agent 中运行。
  28. > **安装前请知悉:本 Skill 不提供具体证券买入/卖出推荐,也不生成股票、基金或 ETF 荐股名单。**
  29. 打开你正在使用的 Agent(如 Claude Code、Codex、Cursor、OpenClaw 或 WorkBuddy),告诉它:
  30. ```text
  31. 帮我安装这个 Skill:https://github.com/joutaojian/arkvol-skill,并帮我配置 Arkvol Skill 的 API Key。
  32. 我的 API Key 是:[替换成你的 API Key]
  33. ```
  34. 安装完成后可直接询问:
  35. ```text
  36. 现在 A 股情绪怎么样?
  37. 全球资金流蛋糕当前是扩张还是收缩?
  38. 中国 30 年期国债温度是多少?
  39. ```
  40. ## 3. 更新 Skill
  41. 从 0.3.0 版本起,每次数据查询都会先向 Arkvol 检查最新 Skill 版本。也可以主动告诉 AI Agent:
  42. > 更新提示:低于服务端配置版本的 Skill 会被 API 阻断,必须升级并重新加载后才能继续查询。
  43. ```text
  44. 帮我把 Arkvol Skill 升级到最新版本:https://github.com/joutaojian/arkvol-skill
  45. ```
  46. ## 安全与合规
  47. Arkvol Skill 以遵守中国法律法规为基本原则。
  48. - 不要使用本 Skill 生成具体证券买入/卖出推荐名单;
  49. - 不提供具体证券买入/卖出推荐,也不生成股票、基金或 ETF 荐股名单。
  50. - 仅在可信的本地或私有 Agent 会话中提供 Key,不要在 README、公开聊天、命令记录或日志中公开 Key。
  51. - 不得将包含 Key 的 Skill 分享或上传至 GitHub。
  52. - Key 泄露后,应立即在 Arkvol 重新生成或禁用。
  53. <a id="english"></a>
  54. ---
  55. <div align="center">
  56. [简体中文](#arkvol-skill) | **English**
  57. # Arkvol Skill (English)
  58. **Query and interpret multi-market financial data with natural language in AI agents**
  59. </div>
  60. ## Overview
  61. [arkvol.com](https://arkvol.com) is a financial data analysis service covering mainland China A-shares, Hong Kong stocks, and US stocks. It helps users observe market conditions and trends through market sentiment, fear and greed indexes, sector rotation, and related indicators.
  62. Arkvol Skill brings the data querying and interpretation capabilities of [arkvol.com](https://arkvol.com) to AI agents compatible with the Agent Skills standard. Once installed, users can query A-shares and technology sectors, Hong Kong stocks, funds and ETFs, US medium-term trends, the Magnificent Seven, global capital flows, China government bond temperature, and 52-week-low data using natural language.
  63. > **Compliance statement: Arkvol Skill complies with the laws and regulations of China. It does not provide recommendations to buy or sell specific securities and does not generate stock, fund, or ETF recommendation lists.**
  64. See [`VERSION`](VERSION) for the current source version.
  65. ## API Key Skill Reference Implementation
  66. This Skill natively supports API key configuration and has been tested in practice by more than 100 users. It is a strong reference implementation for other projects building API-key-enabled Skills.
  67. Reusable design patterns include storing user credentials outside the Skill repository, defining an explicit priority order for command-line options, configuration files, and environment variables, supporting automated upgrades, providing example configuration without committing real secrets, handling authentication errors consistently, and preventing complete keys from appearing in responses or logs.
  68. ## Installation
  69. Arkvol Skill follows the open [Agent Skills](https://agentskills.io) standard and runs in AI agents that support Agent Skills.
  70. > **Before installation: This Skill does not provide recommendations to buy or sell specific securities and does not generate stock, fund, or ETF recommendation lists.**
  71. Open the agent you use, such as Claude Code, Codex, Cursor, OpenClaw, or WorkBuddy, and tell it:
  72. ```text
  73. Install this Skill: https://github.com/joutaojian/arkvol-skill
  74. Help me configure the Arkvol Skill API key.
  75. My API key is: [replace with your API key]
  76. ```
  77. ## Updates
  78. Starting with version 0.3.0, every data query checks Arkvol for the latest Skill version first. Versions below the release configured by the service are blocked by the API until the Skill is upgraded and reloaded.
  79. ```text
  80. Upgrade Arkvol Skill to the latest version: https://github.com/joutaojian/arkvol-skill
  81. ```
  82. ## Security and Compliance
  83. Arkvol Skill treats compliance with the laws and regulations of China as a fundamental requirement.
  84. - It does not provide recommendations to buy or sell specific securities and does not generate stock, fund, or ETF recommendation lists.
  85. - Provide the key only in a trusted local or private agent session. Never expose it in a README, public chat, command history, or logs.
  86. - Do not share or upload a Skill installation containing a key to GitHub.
  87. - If a key is exposed, regenerate or disable it in Arkvol immediately.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.