内容
# Solana Safe Sniper — MCP 模板
[](https://api.cabal-hunter.com/mcp)
[](https://api.cabal-hunter.com)
[](https://api.cabal-hunter.com/demo)
[](https://api.cabal-hunter.com/api/info)
[](LICENSE)
> 阻止您的 AI 交易代理被协调的钱包 cabal 搞垮。
> 为 Claude Code、Cursor 和 ElizaOS 提供的直接插入模板。
**▶ 立即试用：[任意 Solana 代币的实时气泡地图 →](https://api.cabal-hunter.com/demo)** — 无需注册。
**Cabal-Hunter 是一个免费的 Solana 代币安全扫描器和 rug 检查器。** 它检测协调的钱包 cabal，同一区块的 Jito bundle 购买，连续拉盘部署者以及在任何 Solana mint（pump.fun、PumpSwap、Raydium）上的协调倾销 — 并回答一个重要问题：*您是退出流动性吗？* 使用 **MCP**（Claude、Cursor、ElizaOS），**REST API** 或免费的**视觉气泡地图**。
---
## 问题
您的自主交易代理正在读取 rug.check 分数，流动性锁和合同审计。
**没有一个能抓住一个 cabal。**
一个 cabal 是 15 个新鲜的钱包 — 所有这些钱包都由同一个主钱包资助，所有这些钱包都在启动后的前 90 秒内购买 — 静默积累 25-40% 的供应量，然后在您的机器人看到第一个蜡烛之前。合同干净。LP 被烧毁。一切都是绿色的。
然后他们同时倾销。进入您的流动性。
此模板集成了 **[Cabal-Hunter](https://api.cabal-hunter.com)** — 一个实时的链上资金追踪器 — 作为交易前的安全检查，以便您的代理在签署交换之前捕获协调的启动。
---
## 它回答的一个问题：您是退出流动性吗？
在 Solana 上，**超过一半的 pump.fun 启动在创建区块内被 sniper 购买** — 他们在底部购买，然后在零售（和机器人）涌入后倾销。Cabal-Hunter 的主要输出是一个单一的 **退出流动性风险** 判决（`LOW | ELEVATED | HIGH`），它综合考虑以下所有信号：* 内部人员是否准备好倾销？*
## Cabal-Hunter 的功能 — 六层检测
```
代币铸造地址
↓
0. 退出流动性风险 — 主要判决。综合考虑以下层（捆绑、集中、共享资助人、协调倾销、连续拉盘部署者）成 LOW | ELEVATED | HIGH：内部人员是否准备好倾销？
↓
1. 资金追踪 — 最高持有者追溯到启动：谁由同一个源钱包资助？（经典 cabal 签名）。每个集群都带有证据交易 [] — Solscan 上的实际资金交易。
↓
2. 同一区块捆绑检测 — 持有人在同一个区块中创建代币账户。检测隐秘启动，通过中介路由资金以逃避第 1 层。返回 `time_sync: true`。
↓
3. 协调倾销检测 — ≥2 持有人在同一个区块中出售了有意义的一部分（≥25% 的他们的份额）— 一个 cabal 在实时中退出。`coordinated_exit: true`，带有 sold_pct = 倾销的供应量百分比和销售交易链接。同一区块 + 有意义的大小 + 不同钱包 = 接近零的假阳性。
↓
4. 部署者跟踪记录 — 创建者钱包在链上解析（绑定曲线预毕业，泵 AMM 池后 — 适用于任何年龄的代币），他们的完整启动历史被拉取，每个先前的代币被检查：存活还是死亡？
↓
5. CEX 噪声过滤 — 由共享交易所或高容量基础设施钱包资助的持有人不是一个 cabal。他们从分数中排除，并透明地在 filtered_clusters[] 中显示，这样您就不会从刚刚从 Binance 取现的人那里得到假阳性。
↓
返回：Cabal 分数（0-100）+ 集群地图 + 部署者判决 + 链上收据 + 硬判决
```
部署者层是 cabal 无法避免的：**钱包轮换，部署者留下痕迹。** 响应 `"deployer": {"verdict": "SERIAL_RUGGER", "tokens_launched": 14, "dead": 13}` 会告诉您一切在第一个蜡烛之前。
**收据，不是魔法。** 每个集群和红旗都链接到潜在的 Solscan 交易（`evidence_txs[]`、`holders[].funding_tx`）— 自己验证踪迹，而不是相信分数。
**<100ms 响应** 预索引代币 — 每个 pump.fun 毕业都被自动扫描和缓存。
**免费层级：每月 100 次查询。** 然后每查询 $0.02 USDC，按原生 Solana 支付。无需账户。无需 API 密钥。无需订阅。
---
## 快速开始
### 1. Claude Code / Claude 桌面版
将以下内容添加到您的 MCP 配置（`~/.claude/mcp.json` 或项目 `.mcp.json`）中：
```json
{
"mcpServers": {
"cabal-hunter": {
"url": "https://api.cabal-hunter.com/mcp"
}
}
}
```
就这样。Claude 现在将在您要求分析 Solana 代币时自动调用 `check_cabal_risk`。
**示例提示：**
> "在我们购买这个代币之前，检查是否有任何协调的钱包：`EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`"
Claude 调用该工具，从您的连接钱包支付 $0.02 USDC，并返回完整的分析结果。
---
### 2. Cursor
将以下内容添加到项目根目录下的 `.cursor/mcp.json` 中：
```json
{
"mcpServers": {
"cabal-hunter": {
"url": "https://api.cabal-hunter.com/mcp"
}
}
}
```
---
### 3. ElizaOS（带有自动 x402 支付）
如果您正在使用 ElizaOS 和 `@hugen/plugin-x402-solana`，则会自动处理支付。 将以下内容添加到您的代理配置中：
```json
{
"plugins": ["@hugen/plugin-x402-solana"],
"mcpServers": {
"cabal-hunter": {
"url": "https://api.cabal-hunter.com/mcp"
}
}
}
```
您的代理将在任何交换前调用 `check_cabal_risk(mintAddress)`，如果 `cabalScore >= 35` 或 `isControlled === true`，则中止。
---
### 4. 直接 REST API
适用于无头脚本、自定义机器人或任何语言。**前 100 次调用/月免费 — 无需密钥，无需注册。** 直接调用：
```bash
curl "https://api.cabal-hunter.com/api/scan-cabal?mintAddress=YOUR_MINT_ADDRESS"
```
您将立即收到完整的分析结果，包含 `free_queries_remaining`，以便您始终了解自己的状态。 可机器读取的合约：[`/openapi.json`](https://api.cabal-hunter.com/openapi.json).
一旦免费层级用完，每次调用需支付 $0.02 USDC，通过 x402 — 您的代理只需支付，无需设置账单：
**步骤 1 — 请求分析（获取付款说明）：**
```bash
curl -X POST https://api.cabal-hunter.com/api/scan-cabal \
-H "Content-Type: application/json" \
-d '{"mintAddress": "YOUR_MINT_ADDRESS"}'
```
响应（HTTP 402）：
```json
{
"error": "payment_required",
"payment": {
"recipient": "ATYjZ1kWoHWhj74umGJ8wFqUeW1yeSGBbLi1UQpahPxt",
"amount_usdc": 0.02,
"memo_required": "ch-xxxx-xxxx-xxxx",
"instructions": "Send 0.02 USDC with this memo, then resubmit with X-Payment-Signature header"
}
}
```
**步骤 2 — 支付并重新提交：**
```bash
curl -X POST https://api.cabal-hunter.com/api/scan-cabal \
-H "Content-Type: application/json" \
-H "X-Payment-Signature: YOUR_TX_SIGNATURE" \
-d '{"mintAddress": "YOUR_MINT_ADDRESS"}'
```
**响应（HTTP 200）：**
```json
{
"mint": "YOUR_MINT",
"token_name": "EXAMPLE",
"risk": "HIGH",
"cabal_score": 72.4,
"is_controlled": true,
"time_sync": true,
"verdict": "AVOID — 4 wallets bought in the EXACT same block (bundled launch), controlling 34.1% of supply. DEPLOYER ALERT: this creator has launched 14 tokens, 13 of 13 checked are dead (100%).",
"coordinated_clusters": [
{
"type": "funding",
"master_full": "FvbEKF...9RUg",
"master_short": "FvbEKF…9RUg",
"wallet_count": 4,
"combined_pct": 34.1,
"risk": "HIGH",
"evidence_txs": ["4Y8auc5G...", "2XQx9LFv...", "AAbJ7rej..."]
}
],
"filtered_clusters": [
{
"funder_label": "high-volume wallet",
"master_short": "43ViqZ…Z6iy",
"wallet_count": 2,
"combined_pct": 4.4
}
],
"deployer": {
"creator": "5TbRN6...full address...",
"creator_short": "5TbRN6…2TGC",
"tokens_launched": 14,
"dead": 13,
"sampled": 13,
"dead_pct": 100.0,
"verdict": "SERIAL_RUGGER"
},
"holders": [
{ "rank": 1, "address": "...", "pct": 12.4, "cluster_id": 0, "funding_tx": "4Y8auc5G..." }
],
"wallets_checked": 12,
"analysis_time_ms": 487,
"source": "real_time"
}
```
### 5. 本地运行 MCP 服务器（Docker / Node）
如果您更喜欢自己运行连接器而不是使用托管的 `/mcp` 端点？此存储库附带一个薄的 **stdio MCP 服务器**，它公开 `check_cabal_risk(mintAddress)` 并代理到 Cabal-Hunter API（免费层级无需密钥；付费扫描在调用时使用 x402）：
```bash
# Node 18+
npm install
node server/index.mjs
# 或 Docker
docker build -t cabal-hunter-mcp .
docker run -i cabal-hunter-mcp
```
然后将任何 MCP 客户端指向本地命令：
```json
{
"mcpServers": {
"cabal-hunter": {
"command": "node",
"args": ["server/index.mjs"]
}
}
}
```
---
## 集成到您的交易逻辑中
```python
import requests
def is_safe_to_buy(mint_address: str, payment_sig: str) -> bool:
"""Returns True if token passes cabal check."""
resp = requests.post(
"https://api.cabal-hunter.com/api/scan-cabal",
json={"mintAddress": mint_address},
headers={"X-Payment-Signature": payment_sig}
)
if resp.status_code != 200:
return False # fail-safe: don't buy on error
data = resp.json()
# Block on: coordinated control, high score, bundled launch,
# or a deployer with a history of dead tokens
deployer_verdict = (data.get("deployer") or {}).get("verdict", "UNKNOWN")
return (
not data.get("is_controlled")
and data.get("cabal_score", 100) < 35
and not data.get("time_sync")
and deployer_verdict not in ("SERIAL_RUGGER", "POOR_TRACK_RECORD")
)
# 在您的机器人购买逻辑中：
if is_safe_to_buy(token_mint, my_payment_sig):
execute_swap(token_mint, sol_amount)
else:
print(f"Cabal detected — skipping {token_mint}")
```
---
## 视觉气泡地图（免费）
查看分析结果：彩色集群、资金连接、持有人分布：
```
https://api.cabal-hunter.com/map?mint=ANY_SOLANA_MINT
```
免费查看。分享此 URL，当您遇到 rug 时。每个持有人气泡都是可点击的，链接到 Solscan 进行深入研究。
---
## 定价
| 查询次数 | 费用 |
|---------|------|
| 每月前 100 次 | **免费**（每个 IP，无需注册） |
| 每次查询 | $0.02 USDC |
| 100 次查询 | $2.00 USDC |
| 1,000 次查询 | $20.00 USDC |
| 10,000 次查询 | $200.00 USDC |
一次避免的 rug 通常节省 10–100 倍的月查询费用。
支付原生于 Solana — 无需信用卡，无需账户，无需订阅。
---
## API 参考
| 端点 | 描述 | 认证 |
|----------|-------------|------|
| `POST /api/scan-cabal` | 完整的 cabal 分析 | $0.02 USDC |
| `GET /api/scan-cabal?mintAddress=` | GET 版本 | $0.02 USDC |
| `GET /map?mint=` | 视觉气泡地图 | 免费 |
| `GET /api/cex-funding?mint=` | 按交易所划分的资金明细（哪些 CEX 资助了持有人，每个占比） | 免费 |
| `GET /api/trade-analysis?mint=` | Cohort PnL（团队/Snipers/Insiders）+ 洗盘交易得分 + 退出流动性价格影响，一次调用 | 免费 |
| `POST /api/watch` | 注册一个 mint 的紧急倾销 webhook（在倾销/拉盘开始时推送） | 免费 |
| `GET /api/info` | 定价、端点 | 免费 |
### 紧急倾销 webhook（自动退出）
与其轮询，不让您的机器人订阅一个它持有的代币 — 我们在代币倾销或流动性耗尽开始时推送：
```bash
curl -X POST https://api.cabal-hunter.com/api/watch \
-H "Content-Type: application/json" \
-d '{"mint":"YOUR_MINT","webhook_url":"https://your-bot.com/dump-alert"}'
```
您的端点接收：
```json
{ "event":"dump_detected", "mint":"...", "reason":"price −34% since last check",
"coordinated": true, "price_usd": 0.0001, "liquidity_usd": 4200,
"action":"consider_immediate_exit", "ts": 1781370000 }
```
| `GET /health` | 运行状况检查 | 免费 |
| `POST /mcp` | MCP 工具端点 | 每调用 $0.02 USDC |
---
## 常见问题
**什么是 Solana cabal？**
一群钱包 — 通常来自同一个来源资助并在同一区块购买 — 静默积累代币供应量的很大一部分，然后同时倾销到所有人购买后。
**如何检查 Solana 代币是否是 rug？**
使用 Cabal-Hunter（MCP、REST API 或免费的气泡地图）。它追溯持有人资金到共享来源，检测同一区块的捆绑购买，标记连续拉盘部署者并实时检测协调的倾销，并返回 **退出流动性风险** 判决：`LOW`、`ELEVATED` 或 `HIGH`。
**它是免费的？**
是的 — 每个 IP 每月 100 次查询，无需注册或 API 密钥。超出此限额后，每查询 $0.02 USDC，原生于 Solana。
**AI 交易代理可以使用它吗？**
是的 — 这就是整个目的。MCP 服务器（`api.cabal-hunter.com/mcp`) 让 Claude、Cursor 和 ElizaOS 代理在任何交换前自动调用 `check_cabal_risk(mintAddress)`，而 REST API 涵盖其他语言。
---
## 许可证
MIT — 分叉它、构建它、集成它。如果您使用此构建了某些东西，请分享。
---
*由 [PF Capital](https://api.cabal-hunter.com) · 由 Helius 驱动 · 联系方式： api.cabal-hunter.com/api/info*
