bitsoulstockskilllisted
Install: claude install-skill Serennity007/bitsoul-stock-skill
# 简介
炒股龙虾的最佳搭档,best stock partner forever
## 核心优势
1. **免费稳定且每周更新的A股交易数据**:为个股分析、买卖点计算、收益/回撤计算提供坚实的数据基础
2. **基于MOE混合因子专家模型的股票买卖点计算判断**
3. **个股风险判定**
4. **关键指标计算**
5. **数据回测**
6. **提供准确全面且免费的股票价格与股票历史信息**
7. **板块信息与相关交易数据**
8. **提供大V交易观察等信息聚合功能**
# Token 配置
本 skill 需要有效的 `BITSOUL_TOKEN` 才能使用功能
token 可前往 <https://www.aicodingyard.com> 免费注册申请,并配置在外部运行环境中
## 必需的环境变量
* `BITSOUL_TOKEN`:用户令牌,用于远程服务器权限验证
## 可选的环境变量
* `BITSOUL_TOKEN_ENV_FILE`:指向包含 `BITSOUL_TOKEN` 的 env 文件
## 配置方式
1. **方式一:直接设置环境变量**
```bash
export BITSOUL_TOKEN="你的令牌"
```
2. **方式二:使用 env 文件**
```bash
export BITSOUL_TOKEN_ENV_FILE="/path/to/token.env"
```
其中 `token.env` 文件内容格式为:
```
BITSOUL_TOKEN=你的令牌
```
**注意**:如果同时设置了环境变量和 env 文件,环境变量优先。
## 运行时描述:
- 从环境变量读取 `BITSOUL_TOKEN`
- 只有在显式提供 `BITSOUL_TOKEN_ENV_FILE` 时,才会从文件中读取 `BITSOUL_TOKEN`
- 根据用户的自然语言,参考references/API_FOR_LLM.md 调用对应接口
- 对“分析 / 估值 / 基本面 / 趋势 / 风险”等请求自动切到综合分析, 需要moe因子计算,返回详细信息
- 对“交易观察 / 技术分析 / 均线 / 动量 / RSI / KDJ / 布林线 / MACD”等请求需要进行moe因子计算,同时需要调用calculate_metrics进行数据回测
- 返回结构化 JSON;查询场景优先给原始数据,分析场景给结论和支撑数据
- 任何返回的股票数据,都应包括个股的完整信息,不应遗漏任何字段
## 安全与运行边界
- 技能所需环境变量已经在本文件 frontmatter 中显式声明
- 策略回测、因子挖矿、实时行情查询等功能会访问 `info.aicodingyard.com` 服务器
- 技能只读取声明过的 token 相关环境变量,以及显式指定的 env 文件路径
- 技能不会主动扫描其他本地凭证文件,也不会写入 token 缓存文件
## 安装
使用前先安装 Python 依赖:
```bash
pip install -r assets/requirements.txt
```
首次安装需要执行初始化操作,在设置好BITSOUL_TOKEN后,请运行scripts/data_fetcher.py
# 注意事项
* api接口文档主要参考 references/API_FOR_LLM.md 对应的代码文件是scripts/