内容
<p align="center">
<img src="assets/logo.png" alt="Bitget Signal - 人工智能加密货币市场分析技能 宏观链上情绪技术新闻" width="120" />
</p>
<h1 align="center">bitget-signal — 比特格官方人工智能加密货币市场分析技能</h1>
<p align="center">
<strong>为 Claude Code、Codex 和 OpenClaw 添加 5 项市场分析技能 — 宏观政策、链上鲸鱼流动、情绪指标、技术分析和市场新闻 — 由比特格官方数据支持。无需账户,无需 API 密钥。</strong>
</p>
<p align="center">
<a href="https://www.npmjs.com/package/@bitget-ai/bitget-signal"><img src="https://img.shields.io/npm/v/%40bitget-ai%2Fbitget-signal.svg?style=flat-square&color=e25c5c&label=npm" alt="Bitget Signal npm 包版本 - AI 代理市场分析技能" /></a>
<a href="https://modelcontextprotocol.io"><img src="https://img.shields.io/badge/MCP-compatible-8A2BE2?style=flat-square" alt="模型上下文协议 MCP 兼容,用于桌面 AI 集成" /></a>
<img src="https://img.shields.io/badge/Node.js-%E2%89%A520-026e00?style=flat-square" alt="需要 Node.js 版本 20 或更高" />
<a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square" alt="MIT 开源许可 - 免费用于商业用途" /></a>
</p>
<p align="center">
<a href="#快速开始">快速开始</a> ·
<a href="#功能">功能</a> ·
<a href="#安装">安装</a> ·
<a href="#与交易工具的区别">与交易工具的区别</a> ·
<a href="#安全性">安全性</a> ·
<a href="#常见问题">常见问题</a>
</p>
---
## 概述
`@bitget-ai/bitget-signal` 是比特格官方的**加密货币市场分析技能包**,也是 [Bitget Agent Hub](https://github.com/Bitget-AI/agent_hub) 的 Signal Stack。它为 Claude Code、Codex 和 OpenClaw 添加了 5 项市场分析技能,由比特格官方公共 MCP 数据服务支持。
**无需比特格账户,无需 API 密钥。** 只需安装并开始询问加密货币市场。
---
## 快速开始
### 前置条件
- **Node.js ≥ 20**
- **Python**,带有 `pandas` 和 `numpy`(可选,仅适用于 `technical-analysis` 技能)
### 一行安装
```bash
npx @bitget-ai/bitget-signal --target all
```
安装后,**重启您的 AI 工具**,使新技能生效。
### 验证安装
询问您的 AI: *"当前的比特币恐惧与贪婪指数是多少?"*
如果它返回数据,则技能文件和 MCP 数据服务器都已正确配置。
---
## 功能
每个技能都连接到一个专门的比特格官方数据来源。每个技能都有明确的触发短语,因此您的 AI 助手可以调用正确的技能,而无需您具备技术知识。
| 询问您的 AI | 技能 | 支持 |
|---|---|---|
| *"美联储政策如何影响 BTC?"* · *"BTC 是否与纳斯达克相关?"* | `macro-analyst` | 美联储政策、FOMC 新闻、收益率曲线、跨资产相关性(BTC vs 金、DXY、纳斯达克、标普、10 年期) |
| *"鲸鱼是否在链上移动资产?"* · *"ETF 资金流入还是流出?"* | `market-intel` | 链上资本流动、ETF 数据、DeFi TVL、周期指标 |
| *"市场是恐惧还是贪婪?"* · *"资金利率是否为正?"* | `sentiment-analyst` | 恐惧与贪婪指数、长/短比率、OI、资金利率、交易者比率、Reddit 信号 |
| *"BTC RSI 是否超买?"* · *"支撑位在哪里?"* | `technical-analysis` | 6 类 23 个指标(趋势、波动性、振荡器、成交量、动量、支撑/阻力) |
| *"今天加密货币市场有什么重要新闻?"* | `news-briefing` | 44 个 RSS/Atom 源、社交趋势板块、叙事综合 |
> `technical-analysis` 技能需要本地 Python 环境(`pandas`、`numpy`)。其他四个技能不需要 Python。
---
## 安装
### 步骤 1:安装技能
```bash
# 所有支持的 AI 工具(Claude Code + Codex + OpenClaw)
npx @bitget-ai/bitget-signal --target all
# 默认 - 仅 Claude Code
npx @bitget-ai/bitget-signal
# 特定目标
npx @bitget-ai/bitget-signal --target claude,codex
# 交互式选择器
npx @bitget-ai/bitget-signal --interactive
```
安装程序按顺序执行的操作:
1. 将五个技能文件夹复制到您的 AI 工具的技能目录中。
2. 在您的工具的 MCP 配置中注册公共 `bitget-signal` MCP 服务器(HTTP 传输)。
| 目标 | 技能位置 | MCP 配置 |
|---|---|---|
| Claude Code | `~/.claude/skills/` | 通过 `claude mcp add` |
| Codex | `~/.codex/skills/` | 编写到 `~/.codex/config.toml` |
| OpenClaw | `~/.openclaw/skills/` | 编写到 `~/.openclaw/config.json` |
### 步骤 2:重启 AI 工具
关闭并重新打开您的 AI 工具,以加载新技能和 MCP 服务器。
### 步骤 3:测试
询问您的 AI: *"当前的比特币恐惧与贪婪指数是多少?"*
预期:返回当前指数值并进行解释。
---
## 什么是技能,什么是 MCP 服务器?
`bitget-signal` 是**两个捆绑在一起的东西**:
- **五个技能文件** — 标记语言,教您的 AI 助手每个技能的作用以及何时调用它。纯文本,无运行时进程。
- **MCP 服务器注册** — 您的 AI 主机指向比特格的公共市场数据 MCP(HTTP 传输)。当 AI 调用工具时,请求发送到公共服务器,返回结果。无需通过您的机器的代理,无需凭证。
技能是*提示*,MCP 服务器是*工具*。安装程序通过一条命令连接两者。
---
<a id="vs-trading"></a>
## 与交易工具的区别
| | `bitget-signal`(此包) | `bitget-agent-skill`(交易) |
|---|---|---|
| **目的** | 分析市场数据 | 在您的比特格账户上交易 |
| **是否需要 `bitget-agent-cli`?** | 否 — 独立运行 | 是 — 必须一起安装 |
| **是否需要 API 密钥?** | 否 | 是(您的比特格凭证) |
| **触发条件** | *"BTC 是否超买?"* · *"鲸鱼流动"* · *"美联储政策"* | *"买入 / 卖出 / 查看仓位 / 取消订单"* |
两者可以一起安装 — 使用 `bitget-signal` 进行分析,然后使用 `bitget-agent-skill` + `bitget-agent-cli` 进行交易。
---
## 即将推出:比特格独家信号
除了通用技能外,`bitget-signal` 还将提供比特格才能提供的信号 — 直接从比特格交易所数据构建:
- **`top-trader-flow`** — 比特格顶级跟单交易领导者的聚合、匿名仓位。
- **`derivatives-structure`** — 永续合约基差、期限结构和资金费率曲线,来自比特格订单簿。
- **`large-flow-detect`** — 实时检测比特格交易对中的鲸鱼级订单。
这些将作为附加技能在此同一包中提供 — 无需重新安装。
---
## 安全性
- ✅ **无需凭证**:仅访问公共市场数据 — 无需比特格账户或 API 密钥。
- ✅ **比特格维护的 MCP 服务器**:通过比特格的公共 MCP 服务交付数据,基于 HTTP。
- ✅ **技能文件无运行时进程**:纯 Markdown,无本地资源消耗。
---
## 从旧包名迁移
如果您之前使用旧名称安装:
```diff
- npm install -g bitget-skill-hub # 已弃用
- npm install -g bitget-ai-analyst # 已弃用
+ npx @bitget-ai/bitget-signal # 规范名称
```
还请删除旧的 `market-data` MCP 条目从您的 AI 主机配置 — 新安装注册服务器名称为 `bitget-signal`。
---
## 更新
重新运行安装程序是幂等的:它刷新技能文件,并跳过已配置的 MCP 条目。
```bash
npx @bitget-ai/bitget-signal --target all
```
---
## 相关项目
| 包 | 目的 |
|---|---|
| **[bitget-agent-cli](https://github.com/Bitget-AI/agent-cli)** | 终端 AI 交易工具 |
| **[bitget-agent-skill](https://github.com/Bitget-AI/agent-skill)** | 交易的 AI 推理指南 |
| **[bitget-agent-sdk](https://github.com/Bitget-AI/agent-sdk)** | 用于构建比特格交易代理的 SDK |
| **[bitget-agent-mcp](https://github.com/Bitget-AI/agent-mcp)** | 桌面 AI MCP 服务器 |
| **[agent_hub](https://github.com/Bitget-AI/agent_hub)** | 生态系统入口点 |
---
## 常见问题
### 什么是 bitget-signal?
`bitget-signal` 是比特格官方的**加密货币市场分析技能包**,适用于 Claude Code、Codex 和 OpenClaw。它提供 5 种自然语言分析技能,涵盖宏观政策、链上流动、市场情绪、技术指标和市场新闻。无需账户或 API 密钥。
### 我可以在没有 API 密钥的情况下获取比特格市场数据吗?
是的。`bitget-signal` 仅访问公共市场数据 — 无需比特格账户或 API 密钥。
### 如何安装?
运行 `npx @bitget-ai/bitget-signal --target all`,然后重启您的 AI 工具。
### 技术分析是否需要 Python?
`technical-analysis` 技能需要 `pandas` 和 `numpy`。其他四个技能不需要 Python。
### 数据是否来自比特格官方?
是的。市场数据由比特格提供和维护,通过公共 MCP 服务交付。
### 我可以在使用交易工具的同时使用此工具吗?
绝对可以 — 而且推荐。 使用 `bitget-signal` 进行分析,然后使用 `bitget-agent-skill` + `bitget-agent-cli` 进行交易。
### 此工具涵盖哪些分析维度?
五个维度:宏观政策、链上智能、市场情绪、技术分析(23 个指标)和市场新闻(44 个来源)。
### 如何验证技能是否正常工作?
重启您的 AI 工具后,询问: *"当前的比特币恐惧与贪婪指数是多少?"* 如果它返回数据,则设置正确。
### 如何更新?
参见上面的 [更新](#更新) 部分。
### 是否免费?
是的。采用 MIT 许可,免费使用。数据后端由比特格维护,无需费用。
---
## 许可证
[MIT 许可证](LICENSE) — 免费用于个人和商业用途。
---
<sub>官方比特格代理中心工具 · 信号栈。市场分析内容仅供信息目的,不构成投资建议。加密货币市场存在风险。</sub>
<sub>比特格代理中心生态系统的一部分 · 为交易者、分析师和 AI 爱好者构建。</sub>