# Spider JS Mcp Skills

> MCP Server for JavaScript reverse engineering with dynamic execution

- **Type:** MCP server
- **Install:** `agentstack add mcp-sjhhh024-cmyk-spider-js-mcp-skills`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [sjhhh024-cmyk](https://agentstack.voostack.com/s/sjhhh024-cmyk)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [sjhhh024-cmyk](https://github.com/sjhhh024-cmyk)
- **Source:** https://github.com/sjhhh024-cmyk/Spider-JS-Mcp-Skills

## Install

```sh
agentstack add mcp-sjhhh024-cmyk-spider-js-mcp-skills
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [sjhhh024-cmyk](https://github.com/sjhhh024-cmyk)
- **Source:** [sjhhh024-cmyk/Spider-JS-Mcp-Skills](https://github.com/sjhhh024-cmyk/Spider-JS-Mcp-Skills)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-sjhhh024-cmyk-spider-js-mcp-skills
- Seller: https://agentstack.voostack.com/s/sjhhh024-cmyk
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
