# Spider JS MCP Skills

强大的 JavaScript 逆向分析工具集，提供 **Skill** 和 **MCP Server** 两种使用方式。

## 🎯 项目简介

本项目为 AI 提供完整的 JS 逆向分析能力，支持：
- 🔍 静态分析（提取 JS 文件、检测加密算法）
- 🌐 动态执行（Playwright 浏览器自动化）
- 🛡️ 五秒盾破解（Cloudflare、国内五秒盾等）
- 🧹 JS 反混淆（解码混淆代码）
- 🤖 智能检测（自动选择最优策略）

## 📦 两种使用方式

### 方式 1: MCP Server（推荐）

**适用于**: Claude Desktop, Cline, Codex CLI 等支持 MCP 的客户端

**优势**:
- ✅ 标准化 API
- ✅ 工具自动发现
- ✅ 支持动态执行
- ✅ 原生代码执行

**快速开始**:
```bash
# 使用 uvx 直接运行（无需 clone）
uvx --from git+ssh://git@github.com/sjhhh024-cmyk/Spider-JS-Mcp-Skills.git js-reverse-analyzer
```

**配置示例**:
```json
{
  "mcpServers": {
    "js-reverse-analyzer": {
      "command": "uvx",
      "args": [
        "--from",
        "git+ssh://git@github.com/sjhhh024-cmyk/Spider-JS-Mcp-Skills.git",
        "js-reverse-analyzer"
      ]
    }
  }
}
```

**详细文档**: [MCP Server README](mcp-server/README.md)

---

### 方式 2: Skill

**适用于**: 任何 AI（通过 view_file 读取指令）

**优势**:
- ✅ 无需额外配置
- ✅ 详细分析流程
- ✅ 可定制化
- ✅ 学习友好

**使用方法**:
AI 读取 `skill/SKILL.md` 后按照指令执行分析。

**详细文档**: [Skill README](skill/README.md)

---

## 🚀 快速开始

### MCP Server 安装

```bash
# 方式 1: 使用 uvx（推荐）
uvx --from git+ssh://git@github.com/sjhhh024-cmyk/Spider-JS-Mcp-Skills.git js-reverse-analyzer

# 方式 2: 克隆并本地安装
git clone git@github.com:sjhhh024-cmyk/Spider-JS-Mcp-Skills.git
cd Spider-JS-Mcp-Skills
pip install -e .
playwright install chromium
js-reverse-analyzer
```

### Skill 使用

```
AI: 请读取 skill/SKILL.md 并按照指令分析 <目标网站>
```

---

## 🛠️ 功能特性

### 13 个强大工具

#### 静态分析工具（8个）
1. `analyze_website` - 分析网站 JS 加密算法
2. `extract_js_files` - 提取所有 JS 文件
3. `detect_crypto_algorithm` - 检测加密算法
4. `generate_python_code` - 生成 Python 代码
5. `generate_report` - 生成分析报告
6. `validate_signature` - 验证签名正确性
7. `analyze_api_request` - 分析 API 请求
8. `beautify_js` - 美化 JS 代码

#### 动态执行工具（5个）
9. `analyze_with_browser` - 浏览器动态分析
10. `bypass_challenge` - 绕过验证挑战
11. `execute_js_safely` - 安全执行 JS
12. `detect_protection` - 检测保护措施
13. `deobfuscate_code` - 反混淆代码

---

## 📊 支持的算法和保护

### 加密算法
- ✅ MD5, SHA-1, SHA-256, SHA-512
- ✅ AES, RSA, DES, 3DES
- ✅ CRC32, Base64
- ✅ 自定义签名算法

### 验证挑战
- ✅ Cloudflare 5-second challenge
- ✅ 五秒盾（国内常见）
- ✅ reCAPTCHA（检测）
- ✅ 阿里云盾

### 反混淆
- ✅ 十六进制/Unicode 解码
- ✅ 变量名还原
- ✅ 数组访问简化
- ✅ 死代码移除

---

## 📁 项目结构

```
Spider-JS-Mcp-Skills/
├── README.md               # 本文件
├── pyproject.toml          # Python 项目配置
├── skill/                  # Skill 版本
│   ├── SKILL.md           # Skill 主文件
│   ├── README.md          # Skill 说明
│   └── examples/          # 使用示例
└── src/                    # MCP Server 源码
    ├── server.py          # MCP Server 主程序
    ├── analyzers/         # 分析器模块
    │   ├── js_analyzer.py
    │   ├── crypto_detector.py
    │   ├── browser_executor.py
    │   ├── protection_detector.py
    │   └── smart_analyzer.py
    └── utils/             # 工具模块
        ├── http_client.py
        └── deobfuscator.py
```

---

## 📖 文档

- [MCP Server 完整文档](mcp-server/)
  - [安装指南](mcp-server/INSTALLATION.md)
  - [配置示例](mcp-server/MCP_CONFIG.md)
  - [发布指南](mcp-server/GIT_PUBLISH.md)
  
- [Skill 完整文档](skill/)
  - [使用指南](skill/README.md)
  - [示例分析](skill/examples/)

---

## 🎯 实战案例

### 案例 1: 分析 vbdata.cn

成功分析出 CRC32 + MD5 签名算法，准确度 5/5 星。

[查看完整报告](skill/examples/vbdata_analysis.md)

---

## 🤝 贡献

欢迎提交 Issue 和 Pull Request！

## 📄 许可证

MIT License

## 🙏 致谢

- [MCP SDK](https://github.com/modelcontextprotocol/python-sdk)
- [Playwright](https://playwright.dev/)
- [jsbeautifier](https://github.com/beautify-web/js-beautify)

---

**⭐ 如果这个项目对您有帮助，请给个 Star！**

## 📮 联系方式

- GitHub: [@sjhhh024-cmyk](https://github.com/sjhhh024-cmyk)
- Issues: https://github.com/sjhhh024-cmyk/Spider-JS-Mcp-Skills/issues