Openworker E-Commerce MCP Server

MCP (Model Context Protocol) Server は、Openworker と連携して Chrome または Microsoft Edge を制御し、主要な E-Commerce プラットフォームである Shopee、TikTok Shop、Lazada での商品管理を目的として設計されています。

🚀 プロジェクトの目的 (Project Overview)

このシステムは、Seller Center ページにおける一般的なボットのブラウザ自動制御の問題を解決するために開発されました:

1. 実セッションでのログイン: ユーザーがログインしたままの Chrome/Edge を Remote Debugging Port（9222）経由で接続するため、再ログインや OTP/2FA の繰り返しは不要です。

2. Internal API Interception による高速更新: ブラウザから Session Cookies/Tokens を取得し、API 経由で直接更新コマンドを送信します。高速かつ正確で、UI 上のクリックだけに依存する必要はありません。

3. Safety Guard & Captcha Pause: 保存前に価格と在庫の範囲を検証し、Captcha に遭遇した場合は停止して待機し、ユーザーがすぐにロックを解除できるようにします。

Related MCP server: camoufox-mcp

👥 役割と作業内容 (Team & Development Roles)

• Jules（Google AI エージェント）: TypeScript コードの開発、各カテゴリの Tools（Browser Attach、Session Interceptor、API Client、Safety Guard）の開発、および Unit Tests の実施

• Controller Agent（Cowork / GitHub コントローラー）: プロジェクト構造の管理、コード/PR のレビュー、Task Issues の設計、Tag Release の作成、Openworker へのデプロイ

🛠️ プロジェクト構造 (Project Structure)

openworker-ecommerce-mcp/
├── src/
│   ├── index.ts                # Entry point หลักของ MCP Server
│   ├── types.ts                # Type Definitions & Schemas
│   ├── services/
│   │   ├── cdp-connection.ts   # ตัวจัดการเชื่อมต่อ Chrome/Edge CDP (Port 9222)
│   │   ├── session-extractor.ts# ตัวดึง Auth Cookies / Bearer Tokens จาก Tab
│   │   └── api-client.ts       # Internal API Wrapper สำหรับ Shopee/TikTok/Lazada
│   └── tools/
│       ├── browser-profile.ts  # Tool: browser_attach_existing
│       ├── ecommerce-search.ts # Tool: ecommerce_product_search
│       ├── ecommerce-update.ts # Tool: ecommerce_update_price_stock
│       └── safety-guard.ts     # Tool: ecommerce_safety_guard
├── docs/
│   ├── ARCHITECTURE.md         # สถาปัตยกรรมและรายละเอียด Tool Contracts
│   └── TASKS.md                # รายการงานสำหรับการพัฒนาราย Phase
├── JULES_PROMPT.md             # ข้อแนะนำการสั่งงาน Jules (Google AI Agent)
├── package.json
└── tsconfig.json

💻 接続のための Chrome / Edge の起動

使用を開始する前に、Remote Debugging コマンドで Chrome または Microsoft Edge を起動してください:

Windows (Chrome):

"C:\Program Files\Google\Chrome\Application\chrome.exe" --remote-debugging-port=9222 --user-data-dir="C:\ChromeAutomationProfile"

Windows (Edge):

"C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe" --remote-debugging-port=9222 --user-data-dir="C:\EdgeAutomationProfile"

⚙️ インストールと使用方法 (Installation & Build)

# ติดตั้ง dependencies
npm install

# Build TypeScript
npm run build

# ทดสอบรัน MCP Server
npm start

📄 ライセンス (License)

MIT License - 開発: tukimtk-design

🚀 Phase 7 の機能

Windows での自動起動

Windows で CDP 接続が失敗した場合、システムは正しい remote debugging port で Chrome/Edge を自動的に起動し、シームレスな 1 クリック体験を提供します。

Playwright E2E モック

モック化された E2E フローは次のコマンドで実行できます:

npm test

Openworker 自動インストーラー

PowerShell スクリプトを実行してプロジェクトをビルドし、MCP 設定を生成します:

.\scripts\install-openworker-mcp.ps1

🚀 Phase 8 の機能

マルチプラットフォーム在庫同期

Shopee、TikTok Shop、Lazada 間で在庫と価格を自動的に同期します。システムは安全範囲を調整し、操作をログに記録します。

ファジーバリアントマッチング

システムは文字列類似度（Levenshtein Distance）を使用して、プラットフォーム間で異なる名前の商品バリアントを照合し、SQLite を活用して成功した照合をキャッシュし、将来すぐに取得できるようにします。

🚀 Phase 9 の機能 (Enterprise)

Docker & Headless 実行

Xvfb を使用した公式 Playwright Docker イメージでクラウドに 24/7 デプロイします:

docker-compose up -d

Visual DOM 自己補正

ビューポートのスクリーンショットとバウンディングボックスをキャプチャし、予期しない DOM オーバーレイが発生した際に AI が自己補正できるようにします。

プロキシローテーション

マルチアカウント分離のためのローテーションプロキシをサポートします。