Kahlaoui-Ismail/token-research-agent
GitHub: Kahlaoui-Ismail/token-research-agent
一个 AI 驱动的加密货币 Token 安全分析员，利用多链数据源与 Claude 推理提供结构化的风险评分与终端报告。
Stars: 0 | Forks: 0
# 🐋 Token Research Agent
一个 AI 驱动的加密货币 Token 安全分析员。给它任意一个 Ethereum 或 Solana 的 Token 地址，它会获取多链链上数据，通过 Claude 进行结构化风险分析，并在终端输出彩色编码的报告。
## 
## 功能
1. **自动检测链** — `0x…` 地址 → Ethereum，base58 → Solana
2. **并行获取多源数据**：
- [DexScreener](https://dexscreener.com/) — 价格、流动性、交易量、Pair 存续时长（ETH 与 SOL）
- [Etherscan](https://etherscan.io/) — 合约验证、持币人数量（仅 ETH）
- [Honeypot.is](https://honeypot.is/) — 蜜罐标记、买入/卖出/转账手续费（仅 ETH）
- [Solscan](https://solscan.io/) — Token 元数据、前 10 持币人集中度（仅 SOL）
- [RugCheck](https://rugcheck.xyz/) — 风险评分与风险项（仅 SOL）
3. **运行 Agentic Claude 循环** — Claude 使用工具调用获取并推理数据
4. **打印彩色终端报告** — 以颜色区分风险等级
## 技术栈
| 层级 | 技术 |
|---|---|
| 语言 | Python 3.12 |
| HTTP 客户端 | `httpx`（异步） |
| AI | Anthropic SDK（`anthropic`） |
| 数据校验 | Pydantic v2 |
| 终端 UI | `rich` |
| 容器 | Docker / Docker Compose |
## 安装与配置
### 1. 克隆并安装
```
git clone https://github.com/your-username/token-research-agent.git
cd token-research-agent
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
```
### 2. 配置环境变量
```
cp .env.example .env
```
编辑 `.env` 并填写你的密钥：
| 变量 | 获取来源 |
|---|---|
| `ANTHROPIC_API_KEY` | [console.anthropic.com](https://console.anthropic.com/) |
| `ETHERSCAN_API_KEY` | [etherscan.io/apis](https://etherscan.io/apis) |
### 3. 运行
```
# 以太坊代币
python -m agent.main 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
# Solana 代币
python -m agent.main EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
```
## 示例输出
```
╔══════════════════════════════════╗
║ 🐋 TOKEN RESEARCH AGENT ║
╚══════════════════════════════════╝
Token: USDC
Chain: ETH
Score: 91/100 ✅ SAFE
POSITIVE SIGNALS:
• Verified contract
• High liquidity ($320M)
• No honeypot detected
• Active trading volume
ON-CHAIN SUMMARY:
USDC is a fully-backed stablecoin issued by Circle...
VERDICT:
Low-risk asset. Widely audited, regulated issuer...
```
## Docker
```
# 构建
docker compose build
# 运行
docker compose run token-researcher 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
```
## 项目结构
```
token-research-agent/
├── agent/
│ ├── main.py # Entry point + rich terminal output
│ ├── claude_agent.py # Agentic tool-use loop with Claude
│ ├── models.py # Pydantic TokenReport model
│ └── fetchers/
│ ├── dexscreener.py # Market data (ETH + SOL)
│ ├── etherscan.py # On-chain data (ETH)
│ ├── solscan.py # On-chain data (SOL)
│ ├── rugcheck.py # Risk report (SOL)
│ └── honeypot.py # Honeypot check (ETH)
├── .env.example
├── Dockerfile
├── docker-compose.yml
├── requirements.txt
└── README.md
```
## 风险等级
| 分数 | 标签 | 颜色 |
|---|---|---|
| 75 – 100 | SAFE | 🟢 绿色 |
| 50 – 74 | CAUTION | 🟡 黄色 |
| 25 – 49 | RISKY | 🟠 橙色 |
| 0 – 24 | LIKELY SCAM | 🔴 红色 |
标签：AI代理, AI安全分析, Anthropic, CIS基准, Claude, CVE检测, DexScreener, DEX分析, Docker, Docker Compose, .env, Etherscan, Honeypot, httpx, NIDS, Pydantic, Python, Python 3.12, Rich, RugCheck, SEO关键词, Solana, Solscan, Token审计, Token风险评估, 以太坊, 加密货币安全, 加密货币研究工具, 区块链安全, 反诈骗, 安全防御评估, 容器化, 工具使用, 异步HTTP, 数据验证, 无后门, 智能合约审计, 环境配置, 终端UI, 终端报告, 结构化报告, 自动化分析, 请求拦截, 跨站脚本, 运行时操纵, 链上数据, 颜色编码