Bản nghiên cứu & chuẩn hóa bởi Bitsness

Bộ AI Marketing Agent & Skill trên Claude Code

Hướng dẫn cài đặt, vận hành và kiểm soát dành cho doanh nghiệp vừa và nhỏ — giúp một nhân sự có năng lực điều phối xử lý nhiều đầu việc của một team marketing.

Xem hướng dẫn cài đặt ↓Nhận bộ hướng dẫn miễn phí

Hệ thống không thay thế hoàn toàn một phòng marketing. Giá trị nằm ở khả năng tăng năng suất, chuẩn hóa quy trình và giữ con người ở bước kiểm duyệt cuối.

01 · Tổng quan

Bộ công cụ này thực chất là gì?

Đây là một bộ cấu hình mở rộng cho Claude Code, không phải phần mềm marketing độc lập. Hệ thống kết hợp Skill, Subagent, script Python và template để tạo quy trình làm việc có cấu trúc.

Một nhân sự có thể điều phối nhiều đầu việc marketing với AIHệ thống hỗ trợ nghiên cứu, SEO, nội dung, quảng cáo, tối ưu chuyển đổi và báo cáo trong cùng một quy trình. Doanh nghiệp cung cấp dữ liệu và mục tiêu; AI hỗ trợ thực thi; con người kiểm tra và phê duyệt kết quả.

1 + 14

Cách đếm 15 Skill

1 Skill điều phối /market và 14 Skill chuyên môn.

Subagent chuyên trách

Nội dung, chuyển đổi, cạnh tranh, kỹ thuật và chiến lược.

Dòng lệnh khả dụng

/market quick là nhánh do orchestrator xử lý trực tiếp nên số lệnh nhiều hơn số thư mục Skill.

02 · Kiến trúc

Luồng xử lý từ yêu cầu đến báo cáo

Hệ thống chỉ tạo giá trị khi luồng dữ liệu, quyền công cụ và quy trình phê duyệt được thiết kế rõ ràng.

Nhập lệnh

Người dùng cung cấp URL, chủ đề, sản phẩm hoặc tên khách hàng.

Định tuyến

Skill /market chọn Skill chuyên môn phù hợp.

Giao việc

Lệnh audit có thể giao cho 5 Subagent phân tích các góc khác nhau.

Thu thập tín hiệu

Script Python đọc HTML công khai, robots.txt và sitemap.

Tổng hợp

Claude tạo báo cáo Markdown hoặc PDF trong thư mục dự án.

Thành phần chính

Skill điều phối và 14 Skill chuyên môn
5 Subagent chạy trong ngữ cảnh riêng
4 script Python
Template email, proposal, content calendar và launch checklist

Nguyên tắc vận hành

Actionable hơn lý thuyết
Ưu tiên theo mức tác động
Gắn với kết quả kinh doanh
Đầu ra phải có ví dụ và sẵn sàng kiểm duyệt

03 · Cài đặt

Hướng dẫn cài đặt từng bước

Mọi khối lệnh trên trang đều có nút Sao chép. Hãy đọc nội dung script bên thứ ba trước khi chạy và chỉ cấp quyền cần thiết.

BƯỚC 1

Điều kiện trước khi cài đặt

Tài khoản Claude phù hợp hoặc tài khoản Console/API

Git; trên Windows nên có Git for Windows hoặc WSL

Python 3 nếu muốn chạy script hỗ trợ

ReportLab nếu muốn xuất PDF

Quyền hợp pháp để phân tích website mục tiêu

Thư mục riêng cho từng khách hàng

BƯỚC 2

Cài Claude Code

Anthropic hiện khuyến nghị Native Install. Có thể dùng Homebrew trên macOS hoặc WinGet trên Windows.

macOS, Linux hoặc WSL

curl -fsSL https://claude.ai/install.sh | bash
claude --version
claude doctor
claude

Windows PowerShell

irm https://claude.ai/install.ps1 | iex
claude --version
claude doctor
claude

Windows CMD

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
claude --version
claude doctor
claude

Lựa chọn khác

# macOS — Homebrew
brew install --cask claude-code

# Windows — WinGet
winget install Anthropic.ClaudeCode

Windows: Git for Windows được khuyến nghị để Claude Code dùng Bash tool. WSL 2 phù hợp hơn khi cần Linux toolchain hoặc sandboxing.

BƯỚC 3

Cài AI Marketing Suite

Nên tải mã nguồn, đọc README và install.sh trước khi chạy. Đây là dự án bên thứ ba, không phải sản phẩm chính thức của Anthropic.

macOS, Linux, WSL hoặc Git Bash

git clone https://github.com/zubair-trabzada/ai-marketing-claude.git
cd ai-marketing-claude

# Đọc trước khi chạy
less README.md
less install.sh

chmod +x install.sh
./install.sh

Windows PowerShell — sao chép thủ công

git clone https://github.com/zubair-trabzada/ai-marketing-claude.git
cd ai-marketing-claude

New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null
New-Item -ItemType Directory -Force "$HOME\.claude\agents" | Out-Null

Copy-Item -Recurse -Force ".\market" "$HOME\.claude\skills\market"
Get-ChildItem ".\skills" -Directory | ForEach-Object {
  Copy-Item -Recurse -Force $_.FullName "$HOME\.claude\skills\$($_.Name)"
}
Copy-Item -Force ".\agents\market-*.md" "$HOME\.claude\agents"

New-Item -ItemType Directory -Force "$HOME\.claude\skills\market\scripts" | Out-Null
Copy-Item -Force ".\scripts\*.py" "$HOME\.claude\skills\market\scripts"

New-Item -ItemType Directory -Force "$HOME\.claude\skills\market\templates" | Out-Null
Copy-Item -Force ".\templates\*.md" "$HOME\.claude\skills\market\templates"

Sau khi thêm hoặc sửa Agent trực tiếp trên ổ đĩa, hãy khởi động lại phiên Claude Code để cấu hình được nạp. Skill có thể hỗ trợ live change detection tùy phiên bản.

BƯỚC 4

Cài hỗ trợ xuất PDF

python -m pip install reportlab

Lưu ý tiếng Việt: script PDF gốc dùng Helvetica và khổ Letter. Muốn xuất báo cáo tiếng Việt ổn định, cần đăng ký font Unicode và đổi sang khổ A4.

BƯỚC 5

Kiểm tra sau cài đặt

claude
/skills
/market quick https://bitsness.vn

Skill “market” và các Skill “market-*” xuất hiện

Kiểm tra thư mục ~/.claude/agents hoặc dùng /agents

Chạy quick trước audit để kiểm tra quyền truy cập

Không bật tự động phê duyệt rộng khi chưa hiểu lệnh

BẢO MẬT

Quy tắc dữ liệu tối thiểu

Không đưa mật khẩu, token API, danh sách lead, dữ liệu khách hàng hoặc tài liệu nội bộ nhạy cảm vào thư mục làm việc nếu chưa có chính sách bảo mật, phân quyền và thỏa thuận xử lý dữ liệu phù hợp.

04 · Danh mục

15 Skill và 16 lệnh khả dụng

Bảng dưới đây làm rõ chức năng, đầu ra và cách gọi. Có thể tìm kiếm theo tên lệnh hoặc nhóm chức năng.

Lệnh	Nhóm chức năng	Đầu ra chính
`/market`	Skill điều phối	Định tuyến toàn bộ lệnh /market.
`/market audit <url>`	Kiểm toán marketing	Phân tích đa chiều và tạo MARKETING-AUDIT.md.
`/market quick <url>`	Đánh giá nhanh	Snapshot ngắn về headline, CTA, giá trị và trust signal.
`/market copy <url>`	Tối ưu copy	Đề xuất copy trước/sau và COPY-SUGGESTIONS.md.
`/market emails <topic/url>`	Chuỗi email	Tạo chuỗi email chào mừng, nuôi dưỡng hoặc ra mắt.
`/market social <topic/url>`	Lịch mạng xã hội	Tạo lịch nội dung 30 ngày.
`/market ads <url>`	Nội dung quảng cáo	Tạo hook, headline, primary text và định hướng creative.
`/market funnel <url>`	Phân tích funnel	Đánh giá hành trình, điểm rơi và ma sát chuyển đổi.
`/market competitors <url>`	Nghiên cứu đối thủ	So sánh thông điệp, giá, trust signal và định vị.
`/market landing <url>`	CRO landing page	Đánh giá cấu trúc, CTA, bằng chứng và trở ngại chuyển đổi.
`/market launch <product>`	Kế hoạch ra mắt	Tạo playbook, timeline và checklist ra mắt.
`/market proposal <client>`	Proposal khách hàng	Tạo đề xuất phạm vi, deliverable, timeline, giá và ROI giả định.
`/market report <url>`	Báo cáo Markdown	Tổng hợp kết quả thành MARKETING-REPORT.md.
`/market report-pdf <url>`	Báo cáo PDF	Tạo báo cáo PDF khi đã cài reportlab.
`/market seo <url>`	SEO content audit	Kiểm tra metadata, heading, liên kết, schema và nội dung.
`/market brand <url>`	Brand voice	Phân tích giọng thương hiệu và tạo guideline.

Lưu ý cách đếm: bảng có 16 dòng lệnh vì /market quick là nhánh do Skill điều phối xử lý trực tiếp. “15 Skill” không đồng nghĩa chỉ có 15 lệnh.

05 · Subagent

Vai trò của 5 Agent

Subagent chạy trong ngữ cảnh riêng, giúp tách các tác vụ nghiên cứu khỏi cuộc hội thoại chính. Việc chạy song song còn phụ thuộc cách Claude lập kế hoạch, quyền công cụ và phiên bản đang dùng.

market-content

Nội dung & thông điệp

Headline, value proposition, CTA, độ rõ ràng, tính thuyết phục và cấu trúc nội dung.

market-conversion

Chuyển đổi & funnel

Form, ma sát, social proof, urgency, signup flow, landing page và cơ hội CRO.

market-competitive

Định vị cạnh tranh

Đối thủ, khác biệt hóa, giá, thông điệp, category và khoảng trống thị trường.

market-technical

Kỹ thuật & khả năng được tìm thấy

SEO on-page, metadata, schema, liên kết, tracking và cấu trúc website.

market-strategy

Chiến lược & tăng trưởng

Pricing, acquisition, retention, referral, ưu tiên hành động và rủi ro kinh doanh.

06 · Vận hành

Quy trình chuẩn cho SME

Không bắt đầu bằng việc tạo hàng loạt nội dung. Hãy chuẩn hóa dữ liệu, phân tích nền tảng, thiết kế kế hoạch rồi mới sản xuất và kiểm duyệt.

BƯỚC 01

Chuẩn bị workspace

Tạo thư mục riêng, đưa dữ liệu không nhạy cảm và viết CLAUDE.md quy định ngôn ngữ, ngành, từ cấm và quy trình duyệt.

BƯỚC 02

Phân tích nền tảng

Chạy brand, quick, audit và competitors. Không dùng điểm số làm kết luận cuối cùng.

BƯỚC 03

Thiết kế kế hoạch

Dùng funnel, landing, launch và copy để tạo chiến lược cùng tài sản marketing.

BƯỚC 04

Sản xuất nội dung

Tạo email, social và ads dựa trên dữ liệu đã được xác nhận.

BƯỚC 05

Kiểm duyệt & báo cáo

Kiểm tra pháp lý, tính chính xác, thương hiệu, giá, cam kết rồi mới xuất Markdown/PDF.

07 · Thực hành

Ví dụ lệnh cho Bitsness

Mỗi khối lệnh có thể sao chép trực tiếp. Hãy thay URL, chủ đề và tên khách hàng bằng dữ liệu thật.

Phân tích nền tảng

Kiểm tra nhanh trước buổi tư vấn và xác định ưu tiên cải thiện.

/market quick https://bitsness.vn
/market brand https://bitsness.vn
/market audit https://bitsness.vn
/market competitors https://bitsness.vn

Tối ưu chuyển đổi

Phân tích funnel, landing page và kế hoạch ra mắt.

/market funnel https://bitsness.vn
/market landing https://bitsness.vn
/market launch "Khóa học AI cho SME"
/market copy https://bitsness.vn

Sản xuất nội dung

Tạo chuỗi email, lịch nội dung và góc quảng cáo.

/market emails "Ra mắt khóa học ứng dụng AI cho SME"
/market social "Ứng dụng AI trong doanh nghiệp"
/market ads https://bitsness.vn

Proposal & báo cáo

Tạo bản nháp, sau đó thay giá, timeline và ROI bằng dữ liệu thật.

/market proposal "Công ty ABC"
/market report https://bitsness.vn
/market report-pdf https://bitsness.vn

08 · Kiểm duyệt

Checklist trước khi sử dụng kết quả

AI tạo bản nháp hỗ trợ ra quyết định. Người phụ trách vẫn phải xác minh dữ liệu, chính sách, thương hiệu và quyền sử dụng trước khi triển khai.

Hạng mục	Câu hỏi kiểm tra
Nguồn dữ liệu	Mọi số liệu có nguồn, ngày và phạm vi rõ ràng?
Sự thật & giả định	Đã đánh dấu nội dung nào là quan sát, suy luận hoặc giả thuyết?
Đối thủ	Đối thủ có thật và đúng phân khúc/thị trường không?
SEO	Đã kiểm tra lại bằng trình duyệt, GSC, Lighthouse/PageSpeed hoặc công cụ chuyên dụng chưa?
Thông điệp	Có đúng sản phẩm, khách hàng và giọng thương hiệu không?
Quảng cáo	Có vi phạm chính sách nền tảng hoặc đưa ra cam kết không có bằng chứng không?
Proposal	Giá, phạm vi, timeline, điều khoản và ROI đã được người có thẩm quyền duyệt chưa?
Dữ liệu cá nhân	Có lộ dữ liệu khách hàng, token, thông tin đăng nhập hoặc tài liệu nội bộ không?
Hành động	Mỗi đề xuất có owner, deadline, chi phí và tiêu chí hoàn thành không?
Đầu ra cuối	Đã đọc toàn bộ file Markdown/PDF trước khi gửi khách hàng chưa?

09 · Rủi ro

Giới hạn kỹ thuật cần biết

Đây là phần quan trọng nhất để tránh biến một bộ prompt hữu ích thành công cụ tạo ra kết luận sai hoặc tự động hóa thiếu kiểm soát.

Không render JavaScript đầy đủ

Script dùng HTML tĩnh nên có thể bỏ sót nội dung SPA, lazy loading, popup hoặc nội dung sau đăng nhập.

Không phải crawler toàn site

Phân tích chủ yếu tập trung vào URL đầu vào; không bảo đảm thu thập toàn bộ site.

Tín hiệu thiên về tiếng Anh

Danh sách CTA, testimonial và pricing pattern trong bản gốc chủ yếu là tiếng Anh.

Không đo Core Web Vitals thật

Chưa tích hợp Lighthouse hoặc PageSpeed Insights trong phiên bản gốc.

Không có dữ liệu nội bộ

Không tự biết GA4, Search Console, Ads, CRM, doanh thu hoặc retention nếu chưa kết nối.

Điểm số là heuristic

Trọng số là quy ước của tác giả, không phải tiêu chuẩn ngành đã được kiểm định.

Rủi ro SSL

Một số script gốc tắt xác minh chứng chỉ SSL; cần sửa trước khi dùng nghiêm túc.

PDF tiếng Việt

Helvetica mặc định có thể lỗi tiếng Việt và dùng khổ Letter thay vì A4.

Chi phí token

Nhiều agent và phiên phân tích dài có thể tiêu tốn token đáng kể.

Prompt injection từ website

Nội dung web có thể chứa chỉ dẫn độc hại; không nên cấp quyền rộng cho AI.

10 · Nâng cấp

Đề xuất phiên bản Bitsness

Định vị phù hợp là “Marketing Copilot có kiểm soát cho SME”, tập trung vào dữ liệu, bằng chứng, quy trình duyệt và khả năng tùy biến theo doanh nghiệp.

Chuẩn hóa tiếng Việt

Bổ sung CTA, trust signal, đơn vị tiền tệ, pricing pattern và ngữ cảnh ngành Việt Nam.

Crawler có kiểm soát

Dùng Playwright để render JavaScript, đặt giới hạn domain, số trang, tốc độ và robots.txt.

SEO thực tế hơn

Tích hợp Lighthouse/PageSpeed Insights, Search Console, sitemap crawl và status code.

Dữ liệu marketing thật

Kết nối GA4, Google Ads, Meta Ads, CRM và email platform qua MCP/API với quyền tối thiểu.

Evidence-first

Mọi nhận định đi kèm URL, trích dẫn, thời điểm và mức độ tin cậy.

Phân loại nhận định

Đánh dấu [Dữ liệu], [Quan sát], [Suy luận] hoặc [Giả thuyết cần kiểm chứng].

Human approval gate

Không gửi email, chạy ads, sửa website hoặc xuất bản nếu chưa được duyệt.

Bảo mật

Bật xác minh SSL, sandbox script, allowlist domain, log hành động và không lưu secrets trong Markdown.

Template theo ngành

Tạo tiêu chí riêng cho SaaS, e-commerce, dịch vụ, giáo dục, local business và B2B.

010

Đánh giá chất lượng

Xây dựng bộ test website mẫu, so sánh với chuyên gia và theo dõi tỷ lệ khuyến nghị được chấp nhận.

11 · FAQ

Câu hỏi thường gặp

Các câu trả lời dưới đây phản ánh đúng phạm vi của bộ mã nguồn gốc và cách dùng an toàn trong doanh nghiệp.

Tôi không biết lập trình có dùng được không?

Có thể dùng theo hướng dẫn, nhưng cần biết thao tác terminal cơ bản và hiểu quyền mà Claude Code yêu cầu. Nên có người kỹ thuật hỗ trợ lần cài đầu.

Bộ này có miễn phí hoàn toàn không?

Mã nguồn gốc theo giấy phép MIT, nhưng Claude Code, model, API hoặc công cụ tích hợp có thể phát sinh phí hoặc giới hạn sử dụng.

Có thể dùng trên ChatGPT, Codex hoặc Cursor không?

Một số Skill theo chuẩn Agent Skills có thể chuyển đổi, nhưng bộ gốc được cấu trúc cho Claude Code và Subagent của Claude. Cần kiểm thử lại khi chuyển nền tảng.

Có thể dùng cho website khách hàng không?

Chỉ khi có quyền hợp pháp và tuân thủ điều khoản website. Không truy cập khu vực đăng nhập, dữ liệu cá nhân hoặc hệ thống nội bộ khi chưa được cho phép.

Có thể tin tuyệt đối vào báo cáo không?

Không. Báo cáo là bản nháp hỗ trợ ra quyết định. Cần đối chiếu dữ liệu thật, công cụ chuyên dụng và chuyên gia.

Tại sao lệnh /market không xuất hiện?

Kiểm tra thư mục ~/.claude/skills/market/SKILL.md, mở lại Claude Code nếu cấu hình mới được thêm và dùng /skills để xác nhận.

Tại sao PDF lỗi tiếng Việt?

Do font Helvetica mặc định không hỗ trợ đầy đủ tiếng Việt. Cần sửa script để đăng ký font Unicode và dùng khổ A4.

Một nhân sự có thể làm việc của cả team không?

Có thể xử lý khối lượng đầu việc lớn hơn, nhưng hiệu quả phụ thuộc năng lực marketing, chất lượng dữ liệu, khả năng kiểm duyệt và độ phức tạp của doanh nghiệp.

Dành cho cộng đồng AI NextGen Business

Nhận bộ hướng dẫn cài đặt và cập nhật tài liệu AI cho doanh nghiệp

Tham gia nhóm để nhận hướng dẫn, trao đổi kinh nghiệm triển khai Agent, Skill, AI Workflow và các mô hình doanh nghiệp tinh gọn.

Tham gia nhóm Zalo