Manus Integration

Overview

Manus is an AI Agent platform that provides intelligent automation capabilities. This module integrates Manus functionality into ShipAny, enabling:

Account Management: Bind, claim, and manage Manus accounts
Task Execution: Submit and track AI agent tasks
Credits System: Manage user credits for Manus operations
Order Processing: Handle purchases and subscriptions

Architecture

ShipAny (Next.js)          Manus Python Backend
┌──────────────────┐       ┌──────────────────┐
│  Frontend Pages  │       │  Flask API       │
│  /manus/*        │◄─────►│  /api/manus/*    │
├──────────────────┤       ├──────────────────┤
│  API Routes      │       │  Automation      │
│  /api/manus/*    │◄─────►│  - Auto Register │
├──────────────────┤       │  - Credits Boost │
│  Database        │       │  - Batch Tasks   │
│  PostgreSQL      │       └──────────────────┘
└──────────────────┘

Quick Start

1. Database Setup

Run migrations to create Manus tables:

pnpm db:migrate

2. Environment Configuration

Add to your .env.local:

# Manus Python Backend (optional, for advanced features)
MANUS_PYTHON_API_URL=http://localhost:5000
MANUS_API_KEY=your-api-key

3. Access the Module

User Portal: /manus - Main dashboard for users
Admin Panel: /admin/manus - Administration interface

Features

For Users

Feature	Path	Description
Dashboard	`/manus`	Overview of account status and tasks
Accounts	`/manus/accounts`	Manage bound Manus accounts
Tasks	`/manus/tasks`	Submit and track AI agent tasks
Orders	`/manus/orders`	View purchase history
Profile	`/manus/profile`	User profile and statistics
Tools	`/manus/tools`	Verification and debugging tools

For Administrators

Feature	Path	Description
Dashboard	`/admin/manus`	System overview and metrics
Users	`/admin/manus/users`	User management
Accounts	`/admin/manus/accounts`	Account pool management
Orders	`/admin/manus/orders`	Order administration
Packages	`/admin/manus/packages`	Pricing package configuration
Settings	`/admin/manus/settings`	System configuration
Auto Register	`/admin/manus/auto-register`	Batch account registration
Credits Boost	`/admin/manus/credits-boost`	Batch credits management

Database Schema

The Manus module uses the following tables:

manus_users - User-specific Manus settings
manus_accounts - Account pool for distribution
manus_account_bindings - User-account relationships
manus_orders - Purchase records
manus_tasks - Task submission history
manus_packages - Pricing configurations
manus_invitations - Invitation tracking
manus_configs - Module settings

API Endpoints

Public APIs

POST /api/manus/accounts/claim   - Claim an available account
POST /api/manus/orders/create    - Create a new order
POST /api/manus/tasks/create     - Submit a new task
GET  /api/manus-auth/verify      - Verify authentication token

Next Steps

Account Management - Learn about account binding
Task System - Understanding the task workflow
Admin Guide - Administrator documentation

Manus Integration

On this page