<div align="center">

# ⚡ Web3 Social Matrix Onboarding Assistant
### Web3 社交三件套批量自动上号助手 · 多指纹雷达探测 · AI Agent / MCP 智能体自动化

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Node: >=18.0.0](https://img.shields.io/badge/Node.js-%3E%3D18.0.0-green.svg)](https://nodejs.org/)
[![Protocol: MCP](https://img.shields.io/badge/Protocol-MCP%202024--11--05-blue.svg)](https://modelcontextprotocol.io/)
[![Telegram](https://img.shields.io/badge/Telegram-@oxbaimao-2BA2E1.svg?logo=telegram)](https://t.me/oxbaimao)

---

**[🇨🇳 中文使用说明](#-中文说明文档) | [🇺🇸 English Documentation](#-english-documentation)**

</div>

---

> ### 🔥 【官方一手号源直供 · 独家防封三件套】
> 
> **专为 Web3 空投玩家、自动化工作室打造的优质账号供应链**：
> - 🐦 **推特 (Twitter / X)**：高权重老号、纯手工白号、带 AuthToken / Cookie、带 2FA 密钥、带辅助邮箱。
> - 🎮 **Discord**：已验证直通号、独立 User Token、带 2FA、过最新反爬机制。
> - 📮 **谷歌 (Gmail)**：独享高质量老号/新号、包含辅助邮箱与密码、支持 POP3/IMAP、无异常锁号。
> - 🤖 **AI 会员充值**：ChatGPT Plus / Claude Pro 官方充值、极速开通、长期稳定售后！
> 
> 🛒 **立即联系官方唯一飞机客服**：[👉 点击跳转 Telegram: @oxbaimao (https://t.me/oxbaimao)](https://t.me/oxbaimao)  
> *（批量采购享专属折扣，量大从优，附赠指纹防关联隔离技术指导与定制格式支持！）*

---

# 🇨🇳 中文说明文档

## 💡 项目简介

**Web3 社交三件套自动上号助手** 是专为 Web3 空投交互、多号工作室、矩阵运营及 **AI Agent 智能体** 研发的全自动化上号利器。支持 **Twitter/X、Discord、Google/Gmail** 一键全自动登录，内置本地多指纹浏览器探测雷达，并无缝集成 **Anthropic Model Context Protocol (MCP)** 协议，让 AI 智能体（Claude / Cursor / Antigravity 等）可直接自动化接管上号流水线。

---

## 🌟 核心特性

### 1. 📡 智能指纹浏览器雷达探测 (Browser Discovery Radar)
- **多平台自动识别**：一键探测本地已启动的指纹浏览器 API 端口：
  - **比特指纹 (BitBrowser)**：`127.0.0.1:54345` / `54346`
  - **AdsPower (ADS)**：`127.0.0.1:50325` / `50326`
  - **MoreLogin**：`127.0.0.1:40000` / `40001`
  - **Hubstudio**：`127.0.0.1:20188`
  - **ixBrowser**：`127.0.0.1:53200`
  - **通用 CDP 调试端口**：`9222`, `9223`, `9224`, `9333` 等
- **可视化窗口分配**：卡片式展示所有在线窗口与序号，支持按账号顺序 **“⚡ 自动分配”**、多窗口独立分配 (1对1) 或单窗口复用。

### 2. 💎 三件套综合流水线 (Trinity 3-Slot Pipeline)
- 单窗口一键跑通 **谷歌 ➔ 推特 ➔ Discord** 完整链路，每个窗口独立注入 Cookie 与 Session，打造完整交互环境。
- 提供 3-Slot 独立分槽面板，支持分别粘贴或上传 TXT，系统自动按行对齐。

### 3. 🤖 推特 / Discord / 谷歌 全协议自动化引擎
- **Twitter (推特)**：
  - 支持 `auth_token` Cookie 秒速直登。
  - 支持 账号 + 密码 + 2FA (RFC 6238 TOTP) + 辅助邮箱全自动表单交互登录。
  - 自动校验 Suspended / Locked 存活状态。
- **Discord**：
  - 支持 `User Token` 免密秒级注入直达。
  - 自动通过 Discord 官方接口提取用户名、手机绑定状态及 Nitro 标识。
- **Google / Gmail**：
  - 账号密码自动化录入，支持识别辅助邮箱安全挑战并自动跳过确认页。

### 4. 📝 智能自适应解析与自定义模板
- 自适应常见格式（如 5段冒号、5段横线、Tab 分隔、逗号格式等）。
- 支持任意自定义模板语法（如 `{email}:{emailPassword}:{password}:{2fa}:{token}`）。

### 5. 🤖 AI Agent / MCP (Model Context Protocol) 接入
- 内置标准 stdio 协议 MCP 服务端 (`mcpServer.js`)，支持让 Claude Desktop、Cursor、Antigravity 等智能体直接调用指纹探测、2FA 生成与批量上号工具。

---

## 🚀 快速上手

### 1. 环境要求
- [Node.js](https://nodejs.org/) v18.0 或更高版本
- 本地安装并启动任一指纹浏览器客户端（如比特指纹、AdsPower、MoreLogin 等）

### 2. 一键启动
```bash
# 1. 克隆代码仓库
git clone https://github.com/ChiSonKon/web3-social-onboarding.git
cd web3-social-onboarding

# 2. 安装依赖
npm install

# 3. 启动控制台服务
npm start
```
*Windows 用户也可直接双击运行根目录下的 `start.bat` 或 `一键启动系统.bat`。*

启动成功后，浏览器访问：**`http://localhost:4000`**

---

## 📋 常见账号格式支持

### 🌟 5段冒号格式 (常见综合号源)
```text
demo_user@outlook.com:MailPass123!:AccPass123!:JBSWY3DPEHPK3PXP:MOCK_DISCORD_TOKEN_EXAMPLE_ABC123.DEF456.GHI789_DEMO_SAMPLE_TEST
```
*（对应：`邮箱:邮箱密码:账号密码:2FA密钥:Discord Token`，系统自动清洗空格并计算动态验证码）*

### 🐦 推特 5段格式
```text
Username123----Password123----JBSWY3DPEHPK3PXP----backup@outlook.com----backupPass123
```

### 📮 谷歌 4段格式
```text
demo_user@gmail.com----Password123----recovery_demo@outlook.com----JBSWY3DPEHPK3PXP
```

---

## 🤖 MCP 智能体接入指南

在您的 `claude_desktop_config.json` 或 Cursor MCP 配置中加入：

```json
{
  "mcpServers": {
    "web3-matrix-onboard": {
      "command": "node",
      "args": ["/本地绝对路径/web3-social-onboarding/mcpServer.js"]
    }
  }
}
```

### 开放的 Agent 工具 (Tools Schema)
| 工具名称 | 功能描述 |
| :--- | :--- |
| `scan_fingerprint_browsers` | 探测本地在线指纹浏览器与打开的窗口列表 |
| `parse_social_accounts` | 自动识别解析单行或多行社交账号数据 |
| `generate_2fa_totp` | 即时生成 6 位 TOTP 2FA 动态码 |
| `onboard_social_accounts` | 提交批量上号任务并在指纹浏览器中执行 |
| `query_onboarding_job` | 查询指定任务进度与执行日志 |
| `export_onboarding_results` | 导出上号产出的 Token 与 Cookie |
| `query_device_mac` | 查询网络适配器 MAC 地址与硬件指纹 |

---

## 📡 RESTful API 接口

| 方法 | 路径 | 说明 |
| :--- | :--- | :--- |
| `GET` | `/api/health` | 服务健康与版本状态 |
| `GET` | `/api/radar/scan` | 触发指纹浏览器扫描 |
| `POST` | `/api/parser/test` | 预览账号格式解析结果 |
| `POST` | `/api/totp/generate` | 生成 2FA 动态码 |
| `POST` | `/api/onboard` | 发起批量上号任务 (`jobId`) |
| `GET` | `/api/onboard/jobs/:jobId` | 获取任务实时状态与日志 |
| `GET` | `/api/export/:jobId` | 导出凭据 (`?format=json` 或 `?format=txt`) |
| `POST` | `/api/agent/call` | 统一 AI Agent Tool Calling 入口 |

---
---

# 🇺🇸 English Documentation

## 💡 Overview

**Web3 Social Matrix Onboarding Assistant** is an all-in-one automation tool built for Web3 airdrop hunters, studio operations, multi-account managers, and **autonomous AI Agents**. It fully automates account login for **Twitter/X, Discord, and Google/Gmail**, detects local fingerprint browsers with a built-in radar system, and integrates the **Anthropic Model Context Protocol (MCP)** for native AI Agent orchestration.

---

> ### 🔥 【Reliable Accounts Supply & Wholesale Direct】
> 
> Need fresh or aged social accounts with guaranteed anti-ban protection?
> - 🐦 **Twitter / X**: Aged accounts, clean fresh accounts, auth_token / cookie injection, 2FA secret keys, recovery emails.
> - 🎮 **Discord**: Verified accounts, direct user tokens, 2FA enabled, bypassed antibot verification.
> - 📮 **Google / Gmail**: Dedicated high-trust Gmail accounts, POP3/IMAP enabled, complete recovery access.
> - 🤖 **AI Subscriptions**: Official ChatGPT Plus & Claude Pro upgrades with fast delivery & after-sale support.
> 
> 🛒 **Contact Telegram Support**: [👉 https://t.me/oxbaimao (@oxbaimao)](https://t.me/oxbaimao)  
> *(Discounts available for bulk studio orders. Free environment setup & anti-association guidelines included!)*

---

## 🌟 Key Features

1. **📡 Multi-Fingerprint Browser Radar**:
   - Auto-scans BitBrowser (`54345`), AdsPower (`50325`), MoreLogin (`40000`), Hubstudio (`20188`), ixBrowser (`53200`), and raw CDP ports (`9222+`).
   - Visual window card selector with one-click **"⚡ Auto Assign"** (1-to-1 window mapping or single-window reuse).

2. **💎 Trinity 3-Slot Comprehensive Pipeline**:
   - Executes Google ➔ Twitter ➔ Discord in sequence within each fingerprint environment, injecting session cookies and tokens.

3. **🤖 Automated Platform Engines**:
   - **Twitter/X**: Fast auth_token login or full credentials + TOTP 2FA + recovery challenge.
   - **Discord**: Instant user token injection via LocalStorage or full credentials login with Nitro status verification.
   - **Google/Gmail**: Form automation with automated recovery email validation.

4. **📝 Universal Parser & Custom Syntax**:
   - Supports 5-segment colon, 5-segment dashes, CSV, and custom placeholder syntax (`{email}:{password}:{2fa}:{token}`).

5. **🤖 AI Agent / Model Context Protocol (MCP)**:
   - Native stdio MCP server (`mcpServer.js`) compatible with Claude Desktop, Cursor, Antigravity, and LangChain.

---

## 🚀 Quick Start

### Prerequisites
- [Node.js](https://nodejs.org/) v18.0 or higher
- Any supported fingerprint browser running locally

### Installation & Launch
```bash
# 1. Clone repository
git clone https://github.com/ChiSonKon/web3-social-onboarding.git
cd web3-social-onboarding

# 2. Install dependencies
npm install

# 3. Start server
npm start
```
*Windows users can also double click `start.bat` or `一键启动系统.bat`.*

Open your browser at: **`http://localhost:4000`**

---

## 🤖 MCP AI Agent Configuration

Add the following to your `claude_desktop_config.json` or Cursor MCP settings:

```json
{
  "mcpServers": {
    "web3-matrix-onboard": {
      "command": "node",
      "args": ["/absolute/path/to/web3-social-onboarding/mcpServer.js"]
    }
  }
}
```

---

## 🧪 Testing

Run the automated test suite (17 tests covering TOTP, parser, radar, engine, and MCP):
```bash
npm test
```

---

## 🤝 Community & Commercial Inquiries

- **Official Telegram**: [@oxbaimao](https://t.me/oxbaimao) (https://t.me/oxbaimao)
- **Account Source & Wholesale**: Contact Telegram for reliable 3-in-1 Web3 matrix accounts.

---

## 📄 License
Released under the [MIT License](LICENSE).