<p align="center">
  <img src="assets/logo.png" alt="Bitget Signal - AI Cryptocurrency Market Analysis Skills Macro On-chain Sentiment Technical News" width="120" />
</p>

<h1 align="center">bitget-signal — Official Bitget AI Cryptocurrency Market Analysis Skills</h1>

<p align="center">
  <strong>Adds 5 market analysis skills to Claude Code, Codex & OpenClaw — macro policy, on-chain whale flows, sentiment indicators, technical analysis, and market news — powered by Bitget's official data. No account. No API key.</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 package version - market analysis skills for AI agents" /></a>
  <a href="https://modelcontextprotocol.io"><img src="https://img.shields.io/badge/MCP-compatible-8A2BE2?style=flat-square" alt="Model Context Protocol MCP compatible for desktop AI integration" /></a>
  <img src="https://img.shields.io/badge/Node.js-%E2%89%A520-026e00?style=flat-square" alt="Requires Node.js version 20 or higher" />
  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square" alt="MIT open source license - free for commercial use" /></a>
</p>

<p align="center">
  <a href="#quick-start">Quick Start</a> ·
  <a href="#capabilities">Capabilities</a> ·
  <a href="#installation">Installation</a> ·
  <a href="#vs-trading">vs Trading Tools</a> ·
  <a href="#security">Security</a> ·
  <a href="#faq">FAQ</a>
</p>

---

## Overview

`@bitget-ai/bitget-signal` is Bitget's **official cryptocurrency market analysis skill package** and the Signal Stack of the [Bitget Agent Hub](https://github.com/Bitget-AI/agent_hub). It adds 5 market analysis skills to Claude Code, Codex, and OpenClaw, backed by Bitget's official public MCP data service.

**No Bitget account. No API key.** Just install and start asking about crypto markets.

---

## Quick Start

### Prerequisites

- **Node.js ≥ 20**
- **Python** with `pandas` and `numpy` (optional, only for the `technical-analysis` skill)

### One-Line Install

```bash
npx @bitget-ai/bitget-signal --target all
```

After installation, **restart your AI tool** so the new skills take effect.

### Verify Installation

Ask your AI: *"What is the current Bitcoin Fear & Greed Index?"*

If it returns data, both the skill files and the MCP data server are correctly configured.

---

## Capabilities

Each of the 5 skills connects to a dedicated Bitget official data source. Each skill carries explicit trigger phrases so your AI assistant invokes the right one without you needing to be technical.

| Ask Your AI | Skill | Powered By |
|---|---|---|
| *"How is Fed policy affecting BTC?"* · *"Is BTC correlated with Nasdaq?"* | `macro-analyst` | Fed policy, FOMC news, yield curve, cross-asset correlation (BTC vs Gold/DXY/Nasdaq/S&P/10Y) |
| *"Are whales moving assets on-chain?"* · *"Is ETF money flowing in or out?"* | `market-intel` | On-chain capital flows, ETF data, DeFi TVL, cycle indicators |
| *"Is the market fearful or greedy?"* · *"Are funding rates positive?"* | `sentiment-analyst` | Fear & Greed Index, long/short ratio, OI, funding rates, taker ratio, Reddit signals |
| *"Is BTC RSI overbought?"* · *"Where's the support level?"* | `technical-analysis` | 23 indicators across 6 categories (trend, volatility, oscillator, volume, momentum, support/resistance) |
| *"What's important in crypto today?"* | `news-briefing` | 44 RSS/Atom feeds, social trending boards, narrative synthesis |

> The `technical-analysis` skill requires a local Python environment (`pandas`, `numpy`). The other four skills do not need Python.

---

## Installation

### Step 1: Install Skills

```bash
# All supported AI tools (Claude Code + Codex + OpenClaw)
npx @bitget-ai/bitget-signal --target all

# Default — Claude Code only
npx @bitget-ai/bitget-signal

# Specific targets
npx @bitget-ai/bitget-signal --target claude,codex

# Interactive picker
npx @bitget-ai/bitget-signal --interactive
```

What the installer does, in order:

1. Copies the five skill folders into your AI tool's skill directory.
2. Registers the public `bitget-signal` MCP server (HTTP transport) in your tool's MCP config.

| Target | Skill location | MCP config |
|---|---|---|
| Claude Code | `~/.claude/skills/` | via `claude mcp add` |
| Codex | `~/.codex/skills/` | written to `~/.codex/config.toml` |
| OpenClaw | `~/.openclaw/skills/` | written to `~/.openclaw/config.json` |

### Step 2: Restart AI Tool

Close and reopen your AI tool to load the new skills and MCP server.

### Step 3: Test

Ask your AI: *"What is the current Bitcoin Fear & Greed Index?"*

Expected: returns the current index value with interpretation.

---

## What's a skill, and what's the MCP server?

`bitget-signal` is **two things bundled**:

- **The five skill files** — markdown that teaches your AI assistant what each skill does and when to invoke it. Pure text, no runtime process.
- **An MCP server registration** — your AI host gets pointed at Bitget's public market-data MCP (HTTP transport). When the AI calls a tool, the request goes to the public server and results come back. No proxy through your machine, no credentials needed.

The skills are the *prompt*; the MCP server is the *tools*. The installer wires up both in one command.

---

<a id="vs-trading"></a>

## How It Differs from Trading Tools

| | `bitget-signal` (this package) | `bitget-agent-skill` (trading) |
|---|---|---|
| **Purpose** | Analyze market data | Trade on your Bitget account |
| **Requires `bitget-agent-cli`?** | No — runs standalone | Yes — must be installed together |
| **Requires API key?** | No | Yes (your Bitget credentials) |
| **Triggers on** | *"Is BTC overbought?"* · *"Whale flows"* · *"Fed policy"* | *"Buy / sell / check positions / cancel order"* |

Both can be installed side by side — use `bitget-signal` to analyze, then `bitget-agent-skill` + `bitget-agent-cli` to act.

---

## Coming Next: Bitget-Exclusive Signals

Beyond generic skills, `bitget-signal` will ship signals only Bitget can produce — built directly from Bitget's exchange data:

- **`top-trader-flow`** — aggregated, anonymised positioning of Bitget's top copy-trading leaders.
- **`derivatives-structure`** — perp basis, term structure, and funding-rate curve from Bitget's orderbook.
- **`large-flow-detect`** — whale-sized order detection on Bitget pairs in real time.

These will ship as additional skills inside this same package — no reinstall required.

---

## Security

- ✅ **No credentials required**: accesses only public market data — no Bitget account or API key.
- ✅ **MCP server maintained by Bitget**: data delivered via Bitget's public MCP service over HTTP.
- ✅ **Skill files have no runtime process**: pure Markdown, no local resource consumption.

---

## Migration from Old Package Names

If you previously installed under an older name:

```diff
- npm install -g bitget-skill-hub          # deprecated
- npm install -g bitget-ai-analyst         # deprecated
+ npx @bitget-ai/bitget-signal             # canonical name
```

Also remove the old `market-data` MCP entry from your AI host config — the new install registers the server under the name `bitget-signal`.

---

## Updates

Re-running the installer is idempotent: it refreshes the skill files and skips any MCP entry that is already configured.

```bash
npx @bitget-ai/bitget-signal --target all
```

---

## Related Projects

| Package | Purpose |
|---|---|
| **[bitget-agent-cli](https://github.com/Bitget-AI/agent-cli)** | Terminal AI trading tool |
| **[bitget-agent-skill](https://github.com/Bitget-AI/agent-skill)** | AI reasoning guide for trading |
| **[bitget-agent-sdk](https://github.com/Bitget-AI/agent-sdk)** | SDK for building Bitget trading agents |
| **[bitget-agent-mcp](https://github.com/Bitget-AI/agent-mcp)** | Desktop AI MCP server |
| **[agent_hub](https://github.com/Bitget-AI/agent_hub)** | Ecosystem entry point |

---

## FAQ

### What is bitget-signal?

`bitget-signal` is Bitget's **official cryptocurrency market analysis skill package** for Claude Code, Codex, and OpenClaw. It provides 5 natural language analysis skills covering macro policy, on-chain flows, sentiment, technical indicators, and market news. No account or API key required.

### Can I get Bitget market data without an API key?

Yes. `bitget-signal` accesses only public market data — no Bitget account or API key required.

### How do I install?

Run `npx @bitget-ai/bitget-signal --target all`, then restart your AI tool.

### Does technical analysis need Python?

The `technical-analysis` skill requires `pandas` and `numpy`. The other four skills do not need Python.

### Is the data officially from Bitget?

Yes. Market data is provided and maintained by Bitget, delivered via a public MCP service.

### Can I use this alongside trading tools?

Absolutely — and recommended. Use `bitget-signal` to analyze, then `bitget-agent-skill` + `bitget-agent-cli` to trade.

### What analysis dimensions does this cover?

Five dimensions: macro policy, on-chain intelligence, market sentiment, technical analysis (23 indicators), and market news (44 sources).

### How do I verify the skill is working?

After restarting your AI tool, ask: *"What is the current Bitcoin Fear & Greed Index?"* If it returns data, setup is correct.

### How do I update?

See the [Updates](#updates) section above.

### Is it free?

Yes. MIT-licensed and free. The data backend is maintained by Bitget at no cost.

---

## License

[MIT License](LICENSE) — free for personal and commercial use.

---

<sub>Official Bitget Agent Hub tool · Signal Stack. Market analysis content is for informational purposes only and does not constitute investment advice. Cryptocurrency markets carry risk.</sub>

<sub>Part of the **[Bitget Agent Hub](https://github.com/Bitget-AI/agent_hub)** ecosystem · Built for traders, analysts, and AI enthusiasts.</sub>