📘 Giới thiệu
MCP Server cho phép bạn tích hợp Facebook Ads Library vào Claude, giúp truy vấn, phân tích quảng cáo của bất kỳ thương hiệu nào một cách trực tiếp ngay trong Claude. Bạn có thể xem quảng cáo đang chạy, phân tích hình ảnh, nội dung, video và so sánh chiến lược giữa các thương hiệu.
✅ Yêu cầu trước
- 🧠 Tài khoản Claude (Claude Desktop hoặc Cursor)
- 🐍 Python 3.12+
- 📦 pip (Python package manager)
- 🔐 API Key từ Scrape Creators (đăng ký tại đây)
- 💻 Git (để clone repo)
- 🧩 Tùy chọn: Smithery CLI nếu bạn muốn cài đặt tự động
🧩 Bước 1: Clone GitHub Repository
git clone https://github.com/trypeggy/facebook-ads-library-mcp.git
cd facebook-ads-library-mcp
📦 Bước 2: Cài đặt các dependencies
pip install -r requirements.txt
🔐 Bước 3: Cấu hình API Key
Tạo file cấu hình (tùy ứng dụng bạn dùng):
📂 Claude Desktop
Tạo file tại:
~/Library/Application Support/Claude/claude_desktop_config.json
🧠 Cursor
Tạo file tại:
~/.cursor/mcp.json
Thêm API Key từ Scrape Creators (đây là trang cung cấp API truy cập dữ liệu real time từ các nền tảng social media, bạn cần đăng ký tài khoản để sử dụng) vào file cấu hình. File cấu hình sẽ trông giống như sau:
Nội dung cấu hình mẫu:
{
"mcpServers": {
"fb_ad_library": {
"command": "python",
"args": [
"{{PATH_TO_SRC}}/facebook-ads-library-mcp/src/mcp_server.py",
"--scrapecreators-api-key",
"{{YOUR_SCRAPECREATORS_API_KEY}}"
]
}
}
}
Thay {{PATH_TO_SRC}} bằng đường dẫn đầy đủ đến thư mục src và {{YOUR_SCRAPECREATORS_API_KEY}} bằng khóa API của bạn.
▶️ Bước 4: Chạy MCP Server
cd src
python mcp_server.py --scrapecreators-api-key YOUR_API_KEY
🔌 Bước 5: Kết nối với Claude
Mở Claude Desktop, vào:
Settings → Developer → Add MCP Server
Thêm địa chỉ sau:
https://mcp.apify.com/sse?actors=insight_api_labs/facebook-ad-library
🔍 Bước 6: Sử dụng trong Claude
Dưới đây làví dụ cụ thể trong bài hướng dẫn tích hợp Facebook Ads Library vào Claude qua MCP, giúp bạn dễ hình dung cách ứng dụng vào công việc thực tế:
🇻🇳 Bạn là chủ shop online bán mỹ phẩm nội địa Trung, đang muốn tìm hiểu:
- Đối thủ cùng ngành đang chạy quảng cáo gì?
- Họ dùng hình ảnh, thông điệp nào thu hút khách hàng?
- Họ tập trung vào video, ảnh hay nội dung chữ?
- Chiến lược nào hiệu quả?
🎯 Prompt mẫu trong Claude:
Show me all the live ads "The Gioi Skinfood" is currently running on Facebook
Claude sẽ truy xuất qua MCP và trả kết quả:
- 💄 Tổng số quảng cáo đang chạy
- 🖼️ Loại nội dung (ảnh, video, reel)
- ✍️ Thông điệp chính (ví dụ: “Da trắng bật tông sau 7 ngày”, “Da căng bóng chuẩn Hàn Quốc”)
- 🔥 Insight: Nội dung quảng cáo nào lặp lại nhiều, từ đó suy ra USP (lợi điểm bán hàng độc đáo)
🛍️ Một ví dụ khác:
Bạn đang làm freelance chạy quảng cáo cho một thương hiệu thời trang local brand tại Hà Nội, bạn muốn học hỏi chiến dịch của Coolmate để tối ưu chiến dịch cho khách hàng của mình.
Prompt sử dụng:
Compare the messaging and ad formats between "Coolmate" and "Swe.vn"
Claude sẽ phân tích:
- Sự khác nhau về thông điệp
- Format chủ yếu dùng: video, carousel, hay static image
- Tone of voice: Coolmate thiên về lifestyle, còn Swe.vn dùng ưu đãi khuyến mãi
- Insight: Coolmate nhấn mạnh “trải nghiệm khách hàng – hoàn trả 60 ngày”, còn Swe.vn đẩy mạnh khuyến mãi sốc
👨🏫 Một ví dụ cho giáo viên dạy marketing:
Bạn muốn dạy học viên phân tích cách các trung tâm tiếng Anh tại Việt Nam đang chạy ads trên Facebook.
Prompt:
What kind of ads are "VUS", "ILA Vietnam", and "Apollo English" running? Compare their messaging and video usage.
Claude trả về bảng so sánh:
| Trung tâm | Loại quảng cáo | Nội dung chính | Định dạng |
|---|---|---|---|
| VUS | Ưu đãi học phí | "Giảm 50% học phí cho học sinh đầu vào mới" | Ảnh + text |
| ILA Vietnam | Trải nghiệm học tập | "Học thử miễn phí - Đăng ký ngay!" | Video |
| Apollo English | Khóa học hè | "Summer Camp 2024 - Học và chơi cùng giáo viên nước ngoài" | Carousel |
🤖 Lợi ích cụ thể khi dùng Claude + MCP
- Không cần truy cập trực tiếp Facebook Ads Library
- Tiết kiệm thời gian cuộn tìm quảng cáo thủ công
- Có thể tự động hóa việc phân tích đối thủ theo tuần/tháng
- Thích hợp cho agency, marketer, chuyên viên truyền thông, giảng viên marketing và chủ shop online
🧪 Một số công cụ MCP hỗ trợ
| 🧰 Tên công cụ | 📄 Mô tả |
|---|---|
get_meta_platform_id | Trả về platform ID từ brand name |
get_meta_ads | Lấy toàn bộ quảng cáo của một brand/page |
🧰 Tùy chọn: Cài đặt tự động bằng Smithery
npx -y @smithery/cli install @trypeggy/facebook-ads-library-mcp --client claude
Sau đó khởi động lại Claude hoặc Cursor.
🖼️ Ví dụ sử dụng
Bạn có thể:
- Tìm video quảng cáo
- Phân tích nội dung văn bản trong ads
- So sánh chiến dịch giữa nhiều công ty
- Nhận insights về thông điệp, hình ảnh, định dạng và tệp khách hàng mục tiêu
⚠️ Lưu ý
- MCP không thể hiển thị hình ảnh nếu Facebook yêu cầu đăng nhập
- Claude không tự lấy được dữ liệu Facebook nên MCP là cầu nối quan trọng
- Bạn có thể xem video demo tại repo gốc (file:
MCP.demo.mp4)
Video Demo tích hợp facebook ads library vào claude
🚀 Kết luận
Tích hợp Facebook Ads Library vào Claude qua MCP giúp bạn không chỉ truy cập nhanh chóng vào dữ liệu quảng cáo mà còn có thể sử dụng Claude như một công cụ phân tích chiến dịch mạnh mẽ. Dành cho marketer, growth hacker, hoặc bất kỳ ai muốn tìm hiểu sâu hơn về chiến lược quảng cáo digital.
Chúc bạn thành công! 💡
