Claude Ads: skill Claude Code kiểm toán tài khoản quảng cáo của bạn

Có thể bạn đã lướt qua đoạn video trên Instagram: "làm công việc của agency quảng cáo 3.000 mỗi tháng chỉ trong mười phút". Đằng sau cái hook hơi mang tính chào hàng đó là một dự án mã nguồn mở hoàn toàn có thật: Claude Ads, một skill cho Claude Code đọc dữ liệu tài khoản quảng cáo của bạn và cho bạn biết cái gì hiệu quả, cái gì đang hỏng và nên sửa gì trước. Hơn 10.000 sao trên GitHub vào tháng 10 năm 2026, giấy phép MIT.

Cập nhật ngày 21 tháng 10 năm 2026 cho Claude Ads v2.1.0, phát hành ngày 16 tháng 10 năm 2026. Phiên bản đầu tiên của bài viết này mô tả v1.7.1. Từ v2, skill bao phủ mười hai nền tảng thay vì tám, không còn cho điểm trên thang 100, và các tác giả giờ khuyên không nên dùng kiểu cài đặt một dòng mà chúng tôi từng hướng dẫn. Mọi thứ dưới đây đã được đối chiếu với README và các tệp của skill ở v2.1.0.

Claude Ads chính xác là gì

Claude Ads là một skill Claude Code do Daniel Agrici tạo ra. Một skill là một gói gồm các chỉ dẫn, tài liệu tham chiếu và agent mà agent lập trình của bạn nạp khi cần: ở đây là bí quyết của một chuyên gia kiểm toán quảng cáo trả phí, được chia thành các mô-đun. Đây không phải sản phẩm của Anthropic, và nó chẳng liên quan gì đến quảng cáo bên trong Claude: Anthropic đã viết vào tháng 2 năm 2026 rằng Claude sẽ tiếp tục không có quảng cáo.

Skill có ở hai nơi: bản phát hành công khai tại AgriciDaniel/claude-ads (MIT, không cần làm thành viên) và một bản sao của cộng đồng tại AI-Marketing-Hub/claude-ads, nơi thành viên của một cộng đồng trả phí được truy cập sớm.

Những gì v2.1.0 mang theo:

• 12 nền tảng quảng cáo: Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, Apple, Amazon, Reddit, Pinterest, Snapchat và X.
• 33 skill phía sau một lệnh /ads duy nhất, mỗi nền tảng một skill cộng thêm các skill xuyên suốt (attribution, tracking phía máy chủ, sáng tạo, landing page, ngân sách, lập kế hoạch, báo cáo).
• 25 định nghĩa agent: một worker kiểm toán cho mỗi nền tảng, các worker cho tracking, ngân sách, sáng tạo, chính sách và tuân thủ quy định, bốn agent sáng tạo (người viết nội dung quảng cáo, chiến lược gia sáng tạo, bộ chuyển đổi định dạng, nhà thiết kế hình ảnh) cùng các agent nghiên cứu và xác minh.
• Bốn kết quả có thể có cho mỗi mục kiểm tra: pass, fail, unknown hoặc not_applicable. Unknown nghĩa là thiếu dữ liệu, và skill không bao giờ đoán.
• Hiện chưa có điểm sức khỏe. Dự án tự gọi mình là một bản ứng viên đang phát triển, và cả mười hai hồ sơ chấm điểm sức khỏe tài khoản đều bị tắt. Thay vào đó, một bản kiểm toán báo cáo các phát hiện, những điểm chưa biết và mức độ bao phủ bằng chứng: bao phủ từ 80% trở lên thì được xếp loại, từ 60 đến 79% là tạm thời, dưới 60% là không đủ bằng chứng.

Những con số cũ bạn có thể đã đọc ở đâu đó, 250 mục kiểm tra, điểm trên thang 100 kèm xếp loại từ A đến F, tám nền tảng, là mô tả của v1. Đó không còn là những gì skill nói về chính nó.

Nó vận hành bên trong như thế nào

Một bộ điều phối nắm phạm vi của lượt chạy, các quy tắc, việc tổng hợp và báo cáo cuối cùng. Các worker phân tích những phần việc có giới hạn rõ ràng, mỗi worker một nền tảng hoặc một chủ đề, và trả về phát hiện theo một schema cố định. Nếu một worker bắt buộc thất bại, lượt chạy bị đánh dấu là chưa đầy đủ: nó không bao giờ được trình bày như một bản kiểm toán hoàn chỉnh.

Thiết lập, kiểm toán, xem lại: ba bước trong luồng của v2, lấy từ repo chính thức.

Nếu bạn đã dùng Claude Code để viết code, bạn sẽ nhận ra mô hình này: đó là cơ chế của sub-agent và agent team, áp dụng cho marketing thay vì code. Từ v2.1.0, các agent không còn cố định một model: Claude Code chạy chúng trên model của cuộc trò chuyện chính của bạn, trừ khi có thiết lập nào cụ thể hơn.

Kết quả của một lượt chạy là một tệp JSON có phiên bản. Các báo cáo Markdown, HTML và PDF là những cách hiển thị của chính tệp đó, vì vậy /ads report có thể hiển thị lại một lượt chạy cũ mà không cần chạy gì cả.

Trên thực tế, luồng làm việc gói gọn trong năm bước:

1. Chạy /ads setup và trả lời các câu hỏi: mô hình kinh doanh, mục tiêu, chuyển đổi chính, chi tiêu hằng tháng, các nền tảng đang chạy, và ai phê duyệt thay đổi. Nó dặn bạn tuyệt đối không dán API key hay token vào đó.
2. Mang bằng chứng đến: một tệp xuất tài khoản dạng CSV hoặc JSON, ảnh chụp màn hình, hoặc một bản tóm tắt dán vào kèm khoảng thời gian, đơn vị tiền tệ và múi giờ.
3. Chạy /ads audit google, hoặc /ads audit all. Bạn nhận được những gì đạt, những gì không đạt và những gì còn thiếu.
4. Chạy /ads report để xem lại một lượt chạy cũ.
5. Chạy /ads next để xem điểm nghẽn quan trọng nhất.

Mười hai nền tảng

Mỗi nền tảng có skill riêng, worker kiểm toán riêng, tài liệu tham chiếu các mục kiểm soát riêng và bản khai báo capability riêng. Một manifest capability trong repo ghi lại những gì có thể đọc hoặc thay đổi trực tiếp trên từng nền tảng. Bên trên các nền tảng là những bản kiểm toán xuyên suốt: attribution (định nghĩa chuyển đổi, cửa sổ thời gian, GA4, đối tác đo lường di động) và tracking phía máy chủ (gắn thẻ phía máy chủ, Conversions API và Events API, khử trùng lặp, chất lượng dữ liệu sự kiện). Đây thường là điểm mù của các bản kiểm toán do con người làm, vì chúng đòi hỏi cả kỹ năng về media lẫn kỹ thuật.

Các lệnh

Mọi thứ chạy qua /ads. Khi cài dưới dạng plugin Claude Code, các lệnh có namespace và bắt đầu bằng /claude-ads:ads; khi cài độc lập, chúng bắt đầu bằng /ads. README liệt kê các lệnh sau:

Các lối tắt nền tảng đi thẳng tới một bản kiểm toán: /ads google, /ads meta, /ads youtube, /ads linkedin, /ads tiktok, /ads microsoft, /ads apple, /ads amazon, /ads reddit, /ads pinterest, /ads snapchat và /ads x.

Các lệnh chuyên biệt của v1 vẫn được skill định tuyến: /ads dna cho hồ sơ thương hiệu và ưu đãi của một website, /ads attribution, /ads tracking, /ads creative, /ads landing, /ads budget, /ads math cho CPA, ROAS, MER, LTV:CAC và điểm hòa vốn, /ads competitor, /ads generate cho hình ảnh từ một brief đã được duyệt, /ads photoshoot cho các biến thể ảnh sản phẩm, và /ads test là tên khác của /ads experiment. Một yêu cầu bằng ngôn ngữ thường cũng đi tới cùng các skill đó. Không skill nào dựng video: phần việc video dừng ở ý tưởng và brief.

Cài đặt an toàn

Giờ các tác giả viết thẳng ra: ưu tiên luồng plugin của host hoặc một gói lưu trữ của bản phát hành đã đối chiếu checksum, và không bao giờ pipe một trình cài đặt từ xa thẳng vào shell. Phiên bản đầu tiên của bài viết này hướng dẫn đúng điều đó, một curl | bash và một irm | iex: đừng dùng chúng.

Bên trong Claude Code, luồng plugin:

/plugin marketplace add agricidaniel/claude-ads
/plugin install claude-ads@ai-marketing-hub-claude-ads

Nếu bạn đã thêm marketplace trước v2.0.0, Claude Code vẫn giữ nó dưới một bí danh cũ. Hãy gỡ nó trước:

/plugin marketplace remove agricidaniel-claude-ads

Từ một bản clone bạn đã đọc qua, trên macOS hoặc Linux:

git clone https://github.com/AgriciDaniel/claude-ads.git
cd claude-ads
bash install.sh --source=local

Trên Windows, trong PowerShell, từ cùng bản clone đó: .\install.ps1 -Source local.

Để cố định một phiên bản, bash install.sh --source=git --ref=v2.1.0 checkout đúng tag đó và báo lỗi nếu không tìm thấy. Con đường đã được xác minh vẫn là tệp zip của bản phát hành: mỗi bản phát hành trên GitHub công bố tệp zip, một manifest, một danh mục thành phần phần mềm (SBOM) và một tệp SHA256SUMS, và mọi dòng của sha256sum -c SHA256SUMS phải báo OK trước khi bạn giải nén. Các bản phát hành có checksum, nhưng không được ký số.

Những gì cần có: CPython 3.11 hoặc 3.12 cho các dependency được quản lý, glibc 2.28 trở lên trên Linux, các thư viện WeasyPrint và Pango cho báo cáo PDF, và một trình duyệt Playwright nếu bạn muốn chụp từ trình duyệt.

Trình cài đặt còn có --target=codex, --target=gemini và các đích cho Cursor, Windsurf và Goose. README đánh dấu chúng là thử nghiệm: chỉ Claude Code được xác minh, và các host khác có thể xử lý cùng các tệp đó theo cách khác.

Quy trình trong video, nhìn lại

Video Instagram làm skill này nổi tiếng cho thấy ba bước. Đây là ba bước đó với v2.1.0.

Bước 1: cài skill. Qua luồng plugin ở trên, không phải một dòng lệnh dán vào.

Bước 2: mô tả doanh nghiệp của bạn, rồi lập kế hoạch. /ads setup hỏi về ưu đãi, mục tiêu, chuyển đổi, ngân sách và các nền tảng của bạn. Nếu bạn có website, /ads dna <url> trích xuất hồ sơ thương hiệu và ưu đãi của bạn để kế hoạch xuất phát từ định vị thực tế. Sau đó /ads plan xây dựng kế hoạch kênh, chiến dịch, ngân sách và đo lường.

Bước 3: báo cáo. /ads report hiển thị lượt chạy đã lưu dưới dạng Markdown, HTML hoặc PDF, sẵn sàng gửi cho khách hàng hoặc ban lãnh đạo của bạn.

Chỗ video đơn giản hóa: kết quả chỉ tốt bằng bằng chứng bạn đưa vào. Đưa câu trả lời mơ hồ thì nhận kế hoạch mơ hồ. Chạy kiểm toán mà không có tệp xuất hay ảnh chụp màn hình thì nhận một báo cáo đầy unknown, điều đó trung thực, nhưng không phải là một chẩn đoán. Và ở v2.1.0 không có điểm số nào để khoe: bạn nhận được các phát hiện và biết được bao nhiêu phần của tài khoản có thể đánh giá.

Dữ liệu và tài khoản của bạn

Skill chạy trong terminal của bạn và phân tích bằng chứng bạn đưa cho nó. Thông tin xác thực nên nằm trong biến môi trường, keychain của hệ điều hành hoặc một trình quản lý bí mật; không bao giờ nằm trong repo, các hồ sơ, báo cáo hay log.

Thay đổi lớn hơn kể từ v1 nằm ở phía ghi. v2 có /ads launch và /ads optimize, nhưng mọi adapter đều chỉ đọc theo mặc định và các thay đổi chỉ là bản nháp. Để áp dụng một thay đổi, skill cần đủ cả sáu điều sau:

1. một capability đã được kiểm thử và bật cho đúng thao tác đó;
2. ID tài khoản và ID đối tượng rõ ràng;
3. một diff trước và sau dễ đọc, kèm những gì nó ảnh hưởng;
4. sự phê duyệt của chủ tài khoản, trong giới hạn đã đặt cho tài khoản;
5. một khóa idempotency, một nơi ghi nhật ký kiểm toán, một phương án rollback và một khoảng thời gian xác minh;
6. một bước kiểm tra rằng tài khoản vẫn khớp với những gì thay đổi dự kiến.

Không đặt giới hạn thì không có thao tác ghi nào, và xóa vĩnh viễn không được hỗ trợ trong v2.

Nó thay thế được gì, và không thay thế được gì

Hãy thẳng thắn, vì câu "thay thế agency 3.000 mỗi tháng của bạn" cần được nói rõ hơn.

Những gì Claude Ads làm tốt: phần mang tính hệ thống của công việc. Chạy mọi mục kiểm soát trên một tài khoản mà không bỏ sót mục nào, đối chiếu tracking với những gì nền tảng yêu cầu, phát hiện độ bão hòa của nội dung sáng tạo, tính lại các ngưỡng hòa vốn, và nói rõ những gì không thể kiểm tra. Đó là phần khách quan, lặp lại được của một bản kiểm toán, phần mà ngay cả một chuyên gia tư vấn giỏi cũng làm chậm hơn máy.

Những gì nó không làm: tự bấm nút thay bạn theo mặc định, hay biết bối cảnh mà agency của bạn biết: tính mùa vụ của bạn, những thử nghiệm đã thất bại, mối quan hệ với người phụ trách bên Google của bạn. Và như mọi kết quả từ AI, các khuyến nghị của nó cần được kiểm tra lại trước khi bạn bỏ ngân sách media thật vào.

Cách nhìn đúng: Claude Ads không thay thế óc phán đoán, nó thay thế những giờ được tính tiền để rà checklist. Với một chủ doanh nghiệp tự chạy chiến dịch, đó là một mức kiểm toán họ chưa từng có. Với một agency, nó biến bản kiểm toán từng mất nửa ngày cho mỗi tài khoản thành một điểm kiểm tra hằng tuần.

Claude Ads trong AgentsRoom: bộ phận quảng cáo cạnh bộ phận dev của bạn

Đây là lúc mọi thứ trở nên thú vị nếu bạn đã dùng agent để viết code. Một skill như Claude Ads, chạy thủ công trong terminal, là một công cụ. Cùng skill đó, giao cho một agent chuyên trách trong một buồng lái đa agent, là một bộ phận kinh doanh hoạt động liên tục.

AgentsRoom được xây dựng chính xác cho việc này: mỗi agent có một vai trò, một trạng thái trực tiếp và màu riêng, và bạn giám sát cả đội agent từ một cửa sổ duy nhất. Không có gì bắt bạn chỉ chạy agent viết code. Hãy tạo một agent với vai trò quảng cáo, cài skill Claude Ads trên Claude Code của nó, và nó trở thành media buyer junior của bạn: nó nhận ticket kiểm toán trên backlog, chạy các lệnh /ads, và trả báo cáo làm đầu ra.

Vòng lặp đầy đủ trông như sau. Agent Ads chạy /ads audit all trên các tệp xuất sáng thứ Hai của bạn và đăng phát hiện lên backlog. Những vấn đề kỹ thuật nó phát hiện (một chuyển đổi GA4 bị đếm hai lần, một Consent Mode cấu hình sai, một landing page quá chậm) trở thành ticket mà agent dev của bạn nhận và sửa trong code, mỗi ticket trong worktree riêng để các agent chạy song song không bao giờ giẫm chân nhau. Trong khi đó, một agent SEO giữ cho các landing page khớp với những chiến dịch đang chạy. Bạn đọc báo cáo, và bạn là người phê duyệt một thay đổi trước khi nó chạm tới tài khoản quảng cáo.

Hãy giữ agent Ads trên Claude Code, host duy nhất mà Claude Ads xác minh. Các agent code của bạn có thể chạy trên bất kỳ CLI nào bạn thích: AgentsRoom chạy chúng cạnh nhau trong cùng một cửa sổ, bất kể nhà cung cấp nào, và bảng tương thích liệt kê những gì được hỗ trợ.

Bộ phận bên cạnh luôn là bộ phận khó tích hợp nhất: dev không nói ngôn ngữ media, media không nói ngôn ngữ dev. Một đội agent dùng chung một backlog thu hẹp khoảng cách đó tốt hơn bất kỳ cuộc họp hằng tuần nào.

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

Claude Ads có phải do Anthropic làm ra không?

Không. Claude Ads là một skill mã nguồn mở cho Claude Code do Daniel Agrici viết và phát hành theo giấy phép MIT tại github.com/AgriciDaniel/claude-ads. Anthropic làm ra Claude và Claude Code; skill này chạy bên trên chúng.

Claude có hiển thị quảng cáo không?

Không. Trong bài viết ngày 4 tháng 2 năm 2026, Claude is a space to think, Anthropic viết rằng Claude sẽ tiếp tục không có quảng cáo: không có liên kết tài trợ bên cạnh các cuộc trò chuyện, và không có câu trả lời nào bị nhà quảng cáo chi phối. Claude Ads dùng để kiểm toán tài khoản quảng cáo của chính bạn, không liên quan đến quảng cáo bên trong Claude.

Claude Ads có còn chấm điểm trên thang 100 không?

Không còn trong v2.1.0. Cả mười hai hồ sơ chấm điểm sức khỏe tài khoản đều bị tắt, nên bản kiểm toán báo cáo các phát hiện, những điểm chưa biết và mức độ bao phủ bằng chứng thay cho điểm số. Mỗi mục kiểm tra kết thúc bằng pass, fail, unknown hoặc not_applicable, và unknown nghĩa là thiếu dữ liệu.

Claude Ads có thể thay đổi chiến dịch quảng cáo của tôi không?

Không tự ý làm được. Mọi adapter đều ở chế độ chỉ đọc theo mặc định và các thay đổi chỉ là bản nháp. Để áp dụng một thay đổi cần có một capability đã bật cho đúng thao tác đó, ID tài khoản và ID đối tượng rõ ràng, một diff trước và sau, sự phê duyệt của chủ tài khoản trong giới hạn của tài khoản, một phương án rollback, và một bước kiểm tra rằng tài khoản không thay đổi từ lúc đó. Xóa vĩnh viễn không được hỗ trợ trong v2.

Claude Ads có chạy được với Codex hay Gemini CLI không?

Trình cài đặt có các đích Codex, Gemini, Cursor, Windsurf và Goose, nhưng README đánh dấu chúng là thử nghiệm: chỉ Claude Code được xác minh. Hãy cài nó trên Claude Code nếu bạn muốn đi theo con đường được hỗ trợ.

Cài skill, chạy /ads audit đầu tiên của bạn, và nếu bạn muốn nó chạy mà không cần đến bạn: tải AgentsRoom và trao cho bộ phận quảng cáo của bạn cùng hạ tầng như bộ phận dev.