🚀 Trợ Lý Tiếp Thị Liên Kết & Tình Báo E-Commerce (affiliate-marketplace)

🚀 Trợ Lý Tiếp Thị Liên Kết & Tình Báo E-Commerce (affiliate-marketplace)

Bộ công cụ AI tất-cả-trong-một giúp bạn: Săn sản phẩm Win (Shopee, TikTok Shop, FastMoss) ➔ Tình báo KOC & bóc tách Hook triệu view ➔ Tự động tạo kịch bản 6 cảnh CRO & đóng gói Video AI trên VideoFactory.

🏢 Vị Trí Trong Hệ Sinh Thái Agency

Dự án này là trụ cột Tình Báo Sàn TMĐT (Marketplace Intelligence) trong mạng lưới 3 dự án Agency:

┌─────────────────────────────────────────────────────────────────────────────┐
│ 🛍️ Products (affiliate-product) [BẠN ĐANG Ở ĐÂY]                            │
│    GitHub: https://github.com/tody-agent/affiliate-product                  │
│    Vai trò: Săn sản phẩm Win, Thẩm định Shop, FastMoss Hotlist, KOC Rankings│
└──────────────────────┬──────────────────────────────┬───────────────────────┘
                       │                              │
        [Commerce Data & Reviews]            [Verified Media Sync]
                       │                              │
                       ▼                              ▼
┌──────────────────────────────────────────┐   ┌──────────────────────────────┐
│ 🎬 VideoFactory (videofactory)           │◀──│ 🔬 Research (omniresearch)   │
│    https://github.com/tody-agent/        │   │    https://github.com/       │
│    videofactory                          │   │    tody-agent/omniresearch   │
│    Vai trò: AI Video Studio & Rendering  │   │    Vai trò: STT & Video Intel│
└──────────────────────────────────────────┘   └──────────────────────────────┘

🌐 Mạng Lưới 3 Kho Mã Nguồn & Thư Mục Liên Kết

Dự Án	Thư Mục Local	GitHub Repository	Vai Trò & Giao Tiếp Dữ Liệu
🛍️ Products (Hiện tại)	/Volumes/Agency/Products		Tình Báo Sàn TMĐT & Săn SP Win: Săn sản phẩm Win, phân tích sàn Shopee/TikTok Shop, FastMoss Hotlist & 28d GMV, Seller Audit, SKU Variants, và KOC Leaderboards.
🔬 Research	/Volumes/Agency/Research		Tình Báo Video & Đảo Ngược Kịch Bản: Ingest 25+ nguồn, MLX Whisper STT trên Apple Silicon, bóc tách 12 Hook Archetypes, tạo edl.json & Obsidian Vault.
🎬 VideoFactory	/Volumes/Agency/VideoFactory		Xưởng Sản Xuất Video AI Tự Động: OmniVoice TTS (giọng Adam tiếng Việt), HyperFrames HTML5 Animatics, Remotion Assembler, Google Flow Veo 3.1.

🌟 Bộ Công Cụ Này Giúp Gì Cho Bạn?

• 🔍 Săn Sản Phẩm Bán Chạy (Winning Products): Quét Shopee & TikTok Shop, tự động tính điểm tiềm năng bán hàng (Affiliate Win Index) theo 6 tiêu chí: Nỗi đau khách hàng, Độ bắt mắt thị giác, Vùng giá mua nhanh (150k - 450k), Sức khỏe Shop, Ads đối thủ và Độ phủ KOC.
• 🌟 Học Hỏi KOC Triệu View: Quét bảng xếp hạng Creator theo từng ngành hàng (Làm đẹp, Công nghệ, Gia dụng...), bóc tách các video bán chạy nhất và giải mã công thức mở đầu (Viral Hook).
• 📊 Tình Báo Đối Thủ (FastMoss Benchmark): Xem doanh số 28 ngày, chi phí quảng cáo (Ads Spend), tỷ lệ hoàn vốn (ROAS) và tỷ lệ tự bán vs KOC của đối thủ.
• 🎬 Tự Động Tạo Video Tiếp Thị AI: Chuyển đổi dữ liệu sản phẩm và Hook KOC thành kịch bản 6 cảnh chuẩn CRO 45s (PAS / AIDA) và tạo ngay thư mục dự án sẵn sàng dựng video trên VideoFactory.
• 🛡️ An Toàn 100% (Zero-Playwright): Đọc dữ liệu mượt mà qua trình duyệt Google Chrome cá nhân, không lo bị chặn bot hay khóa tài khoản.

⚡ Bắt Đầu Nhanh Trong 3 Bước

Bước 1: Trò Chuyện Trực Tiếp Với AI

Sau khi cài đặt plugin, bạn có thể mở Google Antigravity, Claude Code, OpenAI Codex hoặc Cursor và ra lệnh bằng tiếng Việt thông thường.

Bước 2: Thử Các Mẫu Câu Lệnh Tiêu Biểu

💬 "Tìm cho tôi 5 sản phẩm chuột công thái học bán chạy nhất trên Shopee và TikTok Shop, đánh giá shop nào uy tín nhất."

💬 "Xem bảng xếp hạng KOC ngành Làm đẹp trên TikTok Shop tuần này, chọn Creator bán chạy nhất và bóc tách hook của họ."

💬 "Thẩm định link sản phẩm này: https://www.tiktok.com/view/product/... xem có nên làm video affiliate không."

💬 "Tạo cho tôi một kịch bản video 6 cảnh chuẩn CRO cho sản phẩm Đèn Photoolex với giọng đọc Adam tiếng Việt."

Bước 3: Hoặc Dùng Dòng Lệnh Nhanh (affiliate / afflite CLI)

# 1. Kiểm tra kết nối & phiên làm việc Chrome:
affiliate status

# 2. Mở & xác thực phiên đăng nhập TikTok Shop / FastMoss / Shopee:
affiliate login all

# 3. Kiểm tra sức khỏe hệ thống:
affiliate doctor

# 4. Thẩm định một sản phẩm tiềm năng:
affiliate validate "https://www.tiktok.com/view/product/1729463065317050819"

# 5. Xem bảng xếp hạng KOC ngành Làm đẹp:
affiliate creator-rankings --industry beauty --period week

# 6. Tự động đóng gói dự án Video AI:
affiliate make-video "đèn photoolex"

🗂️ Bản Đồ 23 Trợ Lý Skill (Theo Nhu Cầu Của Bạn)

Hệ thống cung cấp 23 Trợ lý Skill chuyên biệt, tự động kích hoạt khi bạn trò chuyện:

graph LR
    User([👤 Bạn / Marketer / Creator]) --> Chat[💬 Trò chuyện tự nhiên với AI]
    
    Chat --> G1["🛍️ Nghiên cứu Shopee & TikTok Shop"]
    Chat --> G2["🌟 Tình báo KOC & Hook triệu view"]
    Chat --> G3["📈 Tình báo đối thủ & Thị trường FastMoss"]
    Chat --> G4["🎬 Dựng Video AI & VideoFactory"]
    Chat --> G5["⚙️ Điều phối & Thẩm định"]

    G1 --> S_Shop["shopee-search • shopee-product • shopee-seller<br/>tiktok-search • tiktok-product • tiktok-seller"]
    G2 --> S_Creator["tiktok-affiliate • verified-koc-videofactory"]
    G3 --> S_FastMoss["fastmoss-benchmark • fastmoss-hotlist-crawler<br/>fastmoss-category-trends • fastmoss-hashtag-analyzer<br/>fastmoss-top-ai-videos • fastmoss-mcn-crawler"]
    G4 --> S_Video["aff-video-product"]
    G5 --> S_Master["afflite-master • aff-winning-validator • affiliate-marketplace"]

💻 Bảng Lệnh CLI Tiện Lợi (affiliate / afflite Cheatsheet)

Dành cho bạn khi muốn thao tác nhanh trong Terminal (hỗ trợ cả lệnh affiliate và alias afflite):

📚 Trung Tâm Tài Liệu Chuyên Sâu (Technical Documentation)

Toàn bộ tài liệu kỹ thuật, sơ đồ cơ sở dữ liệu, đặc tả API và cẩm nang chuyên sâu được lưu trữ tại thư mục docs/:

• 🚀 Hướng Dẫn Khởi Đầu Nhanh: Cài đặt môi trường trong 5 phút và cấu hình biến hệ thống.
• 🤖 Đặc Tả 25 MCP Tools & Cấu Hình Agent: Danh mục 25 công cụ MCP native, input schema, output và hướng dẫn kết nối Antigravity / Claude / Codex / Cursor.
• 🗄 Sơ Đồ CSDL & Hướng Dẫn Python API: Sơ đồ ERD chi tiết của 6 cơ sở dữ liệu SQLite WAL và code mẫu lập trình Python.
• 🎬 Dây Chuyền Sản Xuất Video AI (Veo 3.1): Quy chuẩn kịch bản 6 cảnh CRO 45s, công thức prompt Veo 3.1 và cấu trúc HyperFrames.
• 📈 Chiến Lược Scale Ma Trận 50-100 Kênh: Quy trình vận hành hằng ngày, bộ chỉ số KPI và cẩm nang scale kênh MMO tự động.
• 🎯 Tình Báo KOC Thật (Provenance Data): Quy chuẩn thu thập KOC thật có đối chứng, chống bịa đặt số liệu và claim.
• 📊 Cẩm Nang Khai Thác SQL Data: Công thức truy vấn SQL sẵn dùng để khai phóng dữ liệu trên 6 database SQLite.
• 🤖 Sổ Tay Dành Riêng Cho AI Agent: Hướng dẫn phối hợp 23 skills và tự động hóa quy trình cho AI Agents.
• 🩺 Chẩn Đoán & Câu Hỏi Thường Gặp (FAQ): Khắc phục sự cố, cấp quyền Chrome và giải đáp thắc mắc.
• 📘 Cẩm Nang JTBD Thực Chiến: 5 bản đồ Jobs-To-Be-Done giúp dịch chuyển từ làm tay sang tự động 100x.

🛡️ Hỗ Trợ & Bảo Trì

Dự án được phát triển và vận hành bởi Antigravity Agency. Mọi thắc mắc hoặc yêu cầu tính năng mới, vui lòng chạy bin/afflite doctor để kiểm tra hoặc tra cứu tại docs/faq.md.