---
name: meta-ads-analyzer
description: Claude Code skill + MCP server cho Meta Ads — AI media buyer phân tích campaign + grade ad + tell you what to do. FB Ads dominant VN.
---

# Skill: Meta Ads Analyzer — AI media buyer

## Skill này làm gì

Skill này biến Claude thành **AI media buyer chuyên Meta Ads** cho fanpage + ads account của bạn. Em đọc dữ liệu Facebook Ads Manager qua MCP server `meta-ads-analyzer`, chấm điểm từng ad theo Breakdown Effect + Learning Phase + ROAS, rồi nói thẳng cho bạn biết nên scale ad nào, kill ad nào, fix ngân sách ra sao — bằng tiếng Việt.

Khác media buyer thuê ngoài giá 5-15tr/tháng: skill này chạy 24/7, audit hàng tuần tự động, không bị "vibe check" cảm tính.

## Khi nào dùng

- Audit FB Ads campaigns hàng tuần (mỗi sáng T2 / cuối tháng)
- Grade từng ad performance (Breakdown Effect, Learning Phase, ROAS, CPM, CTR, Frequency)
- Get scaling recommendations: scale ad nào +20%, kill ad nào, duplicate winner sang ad set mới
- Diagnose campaign tụt — tìm ad set ăn budget không ra đơn
- So sánh creative A/B/C — cái nào win, cái nào fatigue

## Cách cài (Claude Code skill, 10 phút)

```bash
cd ~/Projects
git clone https://github.com/mathiaschu/meta-ads-analyzer.git
cd meta-ads-analyzer
npm install
npm run build
```

Lấy Meta Marketing API access token:
- Vào https://developers.facebook.com/tools/explorer/
- Chọn app → cấp quyền: `ads_read`, `ads_management`, `business_management`
- Copy long-lived access token (60 ngày)

Lấy Ad Account ID:
- Ads Manager → Settings → Account ID (dạng `act_xxxxxxxxx`)

Add MCP server vào `~/.claude/mcp.json`:

```json
{
  "mcpServers": {
    "meta-ads-analyzer": {
      "command": "node",
      "args": ["~/Projects/meta-ads-analyzer/dist/index.js"],
      "env": {
        "META_ACCESS_TOKEN": "<paste_token_here>",
        "META_AD_ACCOUNT_ID": "act_<paste_id_here>"
      }
    }
  }
}
```

Restart Claude Code → `/mcp` → thấy "meta-ads-analyzer" status connected.

## Câu lệnh chủ đạo (Vietnamese)

```
Bạn là media buyer Meta Ads chuyên cho doanh nghiệp Việt Nam.
Dùng MCP `meta-ads-analyzer` đọc dữ liệu Ad Account của tôi 7 ngày qua.

Phân tích:
1. Top 3 ad tốt nhất theo ROAS (kèm CPM, CTR, frequency)
2. Top 3 ad tệ nhất — chẩn đoán lý do (creative fatigue / audience sai / budget thấp / Learning Phase chưa thoát)
3. Ad set nào ăn ngân sách >30% mà ROAS <1.5 → cần kill
4. Ad nào đang trong Learning Phase >7 ngày chưa thoát → flag
5. Breakdown Effect: ad nào có 1 demographic ăn >60% impression (rủi ro lệch audience)

Cuối cùng nói rõ bằng tiếng Việt:
- Scale ad nào +20% ngân sách tuần tới (top 2)
- Duplicate winner nào sang ad set mới (test audience khác)
- Pause ad nào ngay (top 3 tệ nhất)
- Refresh creative ad set nào (frequency >3.5)

Format: bảng markdown ngắn gọn + 5 dòng kết luận hành động.
```

## Quyền hạn cần thiết

- **Meta Marketing API access token** scopes:
  - `ads_read` — đọc campaigns / ad sets / ads / insights
  - `ads_management` — cần nếu muốn pause/scale ad từ Claude (optional)
  - `business_management` — đọc BM structure
- **Ad Account ID** (`act_xxxxxxxxx`)
- **System User token** (recommended) thay personal — không hết 60 ngày
- **Page-level access** nếu muốn correlate với organic post

KHÔNG paste token vào chat. Lưu `~/.claude/mcp.json` env section.

## Lưu ý cho doanh nghiệp Việt Nam

- **FB Ads = kênh chính VN** (TikTok #2, Google Ads #3 cho SME) — skill perfect fit
- **Vietnamese prompt wrapper** cho output natural, không kẹt jargon Anh
- **Currency mặc định VND** — đảm bảo Ad Account setting đúng VND
- **Múi giờ GMT+7** — set timezone Asia/Ho_Chi_Minh
- **Compliance**: KHÔNG share token + ad data ra ngoài MCP local
- **Salekit + Skool conversion tracking**: Pixel ID fire đúng event `Lead` / `Purchase`
- **Threshold VND**: setup default ROAS target 2.0 — chuẩn ngành VN SME ecom/edu

## Mẹo dùng hiệu quả

1. **Chạy audit định kỳ T2 8h sáng** — schedule qua `/schedule` skill hoặc `cron`
2. **Combine với `aiboss-image-gen`** — flag "creative fatigue" → gọi sinh 5 creative variant brand Eroca → A/B test
3. **KHÔNG cho skill auto-pause ad** giai đoạn đầu — chỉ `ads_read`. Tự tay pause để học pattern. Sau 2-3 tháng có baseline mới bật `ads_management`

---

**Tác giả:** Eroca Thanh · 2026-05-28
