API và MCP

Hỏi SpyWinAds ngay trong ChatGPT và Claude.

Cho ChatGPT, Claude, Cursor hoặc script của bạn tra video quảng cáo Facebook bằng SpyWinAds: video quảng cáo đã bao nhiêu tuổi, và mọi store đang chạy cùng video đó.

https://spywinads.com/mcp
Chỉ đọc dữ liệu5 công cụGói miễn phí: 30 lượt mỗi ngàyĐăng nhập OAuth

Kết nối

ChatGPT

  1. Mở mục Plugin ở thanh bên trái, bấm Thêm ở góc trên bên phải rồi chọn Thêm server MCP tùy chỉnh.
  2. Dán https://spywinads.com/mcp.
  3. Khi một công cụ cần tài khoản, ChatGPT sẽ mời bạn đăng nhập SpyWinAds và bấm Allow.

Claude.ai / Claude Desktop

  1. Vào Customize → Connectors → Add custom connector.
  2. Dán https://spywinads.com/mcp, chọn Sign in when needed.
  3. Đăng nhập khi Claude hỏi rồi bấm Allow.

Claude Code · Cursor · VS Code

Claude Code: chạy lệnh rồi gõ /mcp để đăng nhập.

claude mcp add --transport http spywinads https://spywinads.com/mcp

Cursor, VS Code, Windsurf, script: dùng khoá API gửi trong header:

{ "mcpServers": { "spywinads": {
  "url": "https://spywinads.com/mcp",
  "headers": { "Authorization": "Bearer YOUR_KEY" } } } }

Không bao giờ đặt khoá trong đường link. Bạn thu hồi khoá và gỡ ứng dụng đã kết nối bất cứ lúc nào trong Cài đặt → API và MCP của SpyWinAds.

Hỏi trợ lý AI

“Video quảng cáo này mới hay là video cũ được lấy ra chạy lại? https://www.facebook.com/ads/library/?id=…”
“Store example.com đang chạy những video quảng cáo Facebook nào, bao nhiêu store khác dùng cùng video?”
“Chép sản phẩm Shopify này ra file CSV để tôi nhập vào store: https://store.com/products/…”

Công cụ

Chỉ đọc dữ liệu. 5 công cụ. Gói miễn phí: 30 lượt mỗi ngày. Quyền: ads:read để tra dữ liệu quảng cáo công khai và product:export để tạo file CSV sản phẩm. Không đọc dữ liệu tài khoản, không ghi gì.

spywin_lookup_video_adĐầu vào

Link Thư viện quảng cáo Meta hoặc mã quảng cáo

Trả về

Tuổi thật của video (ngày file lên Facebook lần đầu, sai số 1–2 ngày), quảng cáo đầu tiên, số quảng cáo đang chạy, số shop đang chạy và đã từng chạy cùng video, các shop chạy sớm nhất trong kho

spywin_spy_store_adsĐầu vào

Tên miền store

Trả về

Quảng cáo đang chạy, quảng cáo mới trong 7 ngày, số video, sản phẩm, fanpage, các video nổi bật kèm tuổi thật và số shop

spywin_get_page_adsĐầu vào

Link hoặc mã fanpage Facebook

Trả về

Tổng quảng cáo và quảng cáo đang chạy, số video, các video nổi bật, các store mà fanpage dẫn khách tới

spywin_export_shopify_productĐầu vào

Link sản phẩm Shopify

Trả về

Tên, giá, biến thể, ảnh, link tải file CSV để nhập vào Shopify (giữ 24 giờ) và các video quảng cáo của sản phẩm trong kho. Quyền product:export

spywin_get_video_reuse_researchĐầu vào

—

Trả về

Các số chính của báo cáo SpyWinAds Video Reuse Index, kèm link phương pháp và dữ liệu. Không cần đăng nhập

Lấy khoá API miễn phí

Dành cho script và trình soạn code (Cursor, VS Code). ChatGPT và Claude không cần khoá: chúng đăng nhập bằng tài khoản SpyWinAds của bạn. Nhập email, chúng tôi gửi link xác nhận và hiện khoá một lần.

Đã có tài khoản SpyWinAds? Tạo khoá ngay trong app: Cài đặt → API và MCP.

REST API

curl -H "Authorization: Bearer YOUR_KEY" \
  "https://spywinads.com/api/v1/store?domain=example.com"

Các đường gọi: /api/v1/video?ad= · /api/v1/store?domain= · /api/v1/page?page= · /api/v1/product?url= · /api/v1/research/video-reuse. Tài liệu OpenAPI: /api/v1/openapi.json (dùng được với GPT Actions và n8n).

Giới hạn và dữ liệu

  • Gói miễn phí: 30 lượt mỗi ngày (đặt lại lúc 0 giờ, giờ Việt Nam), tối đa 20 lượt mỗi phút. Tài khoản đang dùng thử: 100 lượt mỗi ngày.
  • Dữ liệu: quảng cáo Meta (Facebook, Instagram) hiển thị ở Mỹ, lấy từ kho SpyWinAds. Số đếm là số tối thiểu, không phải doanh số. Không có số tiền chi quảng cáo, lượt tiếp cận hay doanh thu. “Store sớm nhất” là sớm nhất trong kho, không phải chủ video.
  • Mỗi lượt gọi trả về đúng những gì công cụ miễn phí trên web hiển thị; không có tìm kiếm trong toàn bộ kho.
  • Kho chưa có? Kết quả kèm link tới công cụ trên web, nơi bạn gửi yêu cầu quét miễn phí.

Thắc mắc: support@spywinads.com · Chính sách bảo mật ›