TL;DR

Meta vừa ra mắt Ads CLI - một công cụ command-line cho phép developer và AI agents quản lý toàn bộ chiến dịch quảng cáo Meta trực tiếp từ terminal, không cần viết code API tùy chỉnh, không cần đăng ký Developer App. Cùng với đó là một MCP server chính thức tại mcp.facebook.com/ads. Cả hai đều miễn phí, ra mắt open beta ngày 29/04/2026.

Vấn đề trước đây

Trước tháng 4/2026, nếu muốn tự động hóa quảng cáo Meta, developer phải đối mặt với ba con đường đều đau đầu:

  • Đăng ký Developer App chính thức - queue review 1-3 ngày, token xoay vòng thủ công, rủi ro bị flag là automation
  • Dùng tool cộng đồng (Pipeboard, GoMarble) - tính phí subscription, không có đảm bảo compliance từ Meta
  • Xuất CSV thủ công - chậm, không realtime, không thể tích hợp vào workflow tự động

Đặc biệt với AI agents, không có path nào được Meta chính thức chấp thuận. Tự động hóa theo cách phi chính thức có thể dẫn đến ban account.

Ads CLI là gì

Meta Ads CLI là một Python package (yêu cầu Python 3.12+) bọc Marketing API v25.0 thành một executable meta duy nhất. Cài đặt qua pip install meta-ads-cli hoặc uv, xác thực một lần bằng Meta Business OAuth, chọn ad account mặc định, và bắt đầu dùng ngay.

meta auth login
meta config set default_account act_123456789
meta ads campaign list
meta ads insights get --campaign_id 123 --date-preset last_7d

Đi kèm là MCP server tại mcp.facebook.com/ads - dành cho Claude Desktop, ChatGPT, Cursor. Quy tắc phân chia đơn giản: MCP cho phân tích và khám phá, CLI cho thực thi và automation.

29 tools, 5 nhóm chức năng

Cả CLI lẫn MCP server đều expose cùng 29 tools chia thành 5 nhóm:

  • Campaign management (5 tools): tạo, liệt kê, cập nhật, xóa campaigns, ad sets, ads và creatives
  • Product catalog (10 tools): quản lý shopping feeds, product sets, diagnostics - nhóm lớn nhất
  • Accounts & Pages (3 tools): truy cập và liệt kê ad accounts, Pages
  • Dataset quality (4 tools): giám sát health Conversions API signal, tracking lỗi
  • Insights & benchmarks (7 tools): performance trends, anomaly detection, opportunity scoring, auction ranking

Một chi tiết đáng chú ý: mọi resource tạo bằng CLI đều mặc định ở trạng thái PAUSED. Phải kích hoạt thủ công - biện pháp an toàn tránh chi tiêu ngoài ý muốn.

Thiết kế cho automation

CLI được xây dựng từ đầu cho scripting và CI/CD, không phải chỉ cho dùng tay:

  • Exit codes chuẩn hóa: 0 (success), 3 (auth error), 4 (API error) - dễ bắt lỗi trong bash script
  • 3 output formats: table (đọc nhanh), JSON (pipe vào jq), plain/TSV (pipe vào awk, sort)
  • Flags không cần input: --no-input và --force chặn mọi prompt tương tác
  • Credentials qua env vars: không cần truyền trong command argument - an toàn hơn

Ví dụ một cron job báo cáo hàng ngày:

meta ads insights get \
  --campaign_id $CAMPAIGN_ID \
  --date-preset yesterday \
  --format json | jq '.spend'
Meta Ads CLI terminal hiển thị danh sách chiến dịch
Meta Ads CLI - terminal hiển thị campaign list với trạng thái và số liệu

Ai hưởng lợi nhiều nhất

Dựa trên thiết kế và phản hồi từ early testers, những nhóm hưởng lợi rõ nhất:

  • Developer và AI agent builders: Claude Code, Codex, CI runners có một interface CLI xác định để gọi - không cần viết Python wrapper từ đầu
  • E-commerce operator: 10 catalog tools cho phép quản lý product feed, dynamic ads ở quy mô lớn
  • Agency nhỏ và mid-size: cron job báo cáo mỗi sáng thứ Hai, tự động detect anomaly spend/CPM
  • Team từng bị chặn bởi Developer App: OAuth một lần, không còn queue review

Nhóm không phù hợp: cần real-time bidding sub-second, cross-platform reporting (Meta + Google + TikTok cùng lúc), hoặc white-labeled dashboard per-client.

Hạn chế cần biết

Sau vài tuần early testers dùng, một số điểm còn thiếu đã được ghi nhận:

  • Không truy cập thuật toán bidding nội tại của Meta, Advantage+ features, hay auction internals
  • Không quản lý custom audiences hoặc lookalike - Meta vẫn giữ đây cho phần thủ công
  • Thiếu một số custom conversion metrics (Cost per Add-to-Cart bị báo cáo thiếu)
  • Attribution window settings đôi khi bị bỏ qua trong testing sớm
  • MCP session 58 tools tiêu thụ ~55,000 input tokens - chi phí thực khi dùng với LLM có token pricing
  • Rollout theo sóng - chưa phải tất cả account đều có access ngay

Pricing và availability

CLI hoàn toàn miễn phí - open-source Python package. MCP server cũng miễn phí. Điểm cần lưu ý: để dùng MCP với Claude hoặc ChatGPT, cần subscription paid tương ứng (Claude Pro/Team, ChatGPT Premium).

Hiện đang ở open beta từ 29/04/2026, rollout theo sóng. Pricing sau beta chưa được công bố. Authentication dùng Meta Business OAuth với 3 scope tiers: read-only, read/write, và financial.

Kết

Meta Ads CLI và MCP server đánh dấu một thay đổi thực sự trong cách Meta định vị hạ tầng developer: không chỉ là API cho ứng dụng gọi vào, mà là một executable có thể chạy trong shell, CI/CD pipeline, hay AI agent. Điều này phản ánh xu hướng rõ ràng: LLMs đang tiếp quản các workflow campaign management vốn cần custom software.

Với compliance path chính thức từ Meta, không còn lo ngại về ban account khi tự động hóa. Đây là tín hiệu mạnh Meta muốn developer và AI agents trở thành một phần của ecosystem quảng cáo - không chỉ là end user của Ads Manager.

Tài liệu chính thức: Ads CLI Overview - Meta for Developers | Announcement: Introducing Ads CLI