KOLens
Đăng nhậpBắt đầu miễn phí
Claude · Custom Connector

Kết nối KOLens với Claude

Dán một URL vào hộp thoại Custom Connector của Claude.ai, nhấn Approve một lần, và Claude có thể tìm KOL, lấy ảnh chụp khán giả, theo dõi quảng cáo, quản lý watchlist và cảnh báo — tất cả bằng ngôn ngữ thường ngày. Sử dụng MCP + OAuth 2.1 với PKCE; thông tin đăng nhập của bạn không bao giờ rời khỏi kolens.ai.

https://kolens.ai/mcp

URL chính xác để dán vào Claude.

Mở Claude.ai Đọc hướng dẫn đầy đủ

Cài đặt trong 30 giây

  1. 1

    Mở Claude.ai và vào Settings → Connectors.

    Có trên Claude Pro, Team và Enterprise. Tìm Add custom connector ở cuối danh sách connector.

  2. 2

    Dán https://kolens.ai/mcp rồi nhấn Connect.

    Claude tự khám phá các OAuth endpoint của chúng tôi (RFC 9728/8414) và đăng ký động chính nó như một public client (RFC 7591). Bạn không cần tạo API key hay đụng đến secret nào.

  3. 3

    Đăng nhập tài khoản KOLens trên trang đồng ý.

    Bạn sẽ được chuyển đến https://kolens.ai/oauth/authorize. Chưa có tài khoản? Hãy tạo một tài khoản trước.

  4. 4

    Xem các scope được yêu cầu rồi nhấn Approve.

    Trang đồng ý liệt kê chính xác Claude yêu cầu gì — thường là read:kols, write:lists, run:scrape. Bạn có thể thu hồi bất kỳ scope nào từ Tài khoản → Connections bất cứ lúc nào.

  5. 5

    Xong — thử một truy vấn.

    Mở bất kỳ cuộc trò chuyện Claude nào và hỏi:

    • “Tìm KOL ốp điện thoại có hơn 50k người theo dõi ở Mỹ.”
    • “Lấy ảnh chụp khán giả cho @creatorbeta.”
    • “Thêm @creatoralpha vào watchlist A-list của tôi.”
    • “Đánh dấu tất cả cảnh báo rising_kol là đã đọc.”

15 công cụ, sẵn sàng ngay

Khám phá

  • list_kols — Lọc KOL theo từ khóa, số người theo dõi, tương tác, khu vực.
  • get_kol_profile — Hồ sơ đầy đủ + video gần đây + thông tin liên hệ.
  • search_history — Những gì bạn (hoặc đội) đã tìm gần đây.
  • run_scrape — Khởi chạy một công việc thu thập theo từ khóa mới.

Khán giả & tăng trưởng

  • get_audience_snapshot — Tỉ lệ quốc gia, ngôn ngữ, % hoạt động, top niche, với CI 95%.
  • list_alerts — KOL đang lên + video xu hướng do KOLens đánh dấu cho bạn.
  • mark_alert_read — Tắt một cảnh báo ngay trong cuộc trò chuyện.

Theo dõi quảng cáo

  • list_advertisers — Các thương hiệu đang chạy quảng cáo Facebook trong một ngách.
  • get_ad_detail — Lấy toàn bộ payload của một quảng cáo — copy, creative, ngày chạy.
  • list_watches — Các cuộc theo dõi quảng cáo tự động bạn đã lưu.

Danh sách & Watchlist

  • add_to_list — Lưu KOL vào một danh sách có tên để xuất sau.
  • add_to_watchlist — Theo dõi tăng trưởng của KOL theo thời gian.
  • list_lists — Các danh sách KOL của bạn.
  • list_watchlist — KOL bạn theo dõi + chênh lệch.
  • remove_from_watchlist — Dừng theo dõi một KOL.

Bảo mật

  • OAuth 2.1 + PKCE. Mật khẩu của bạn không bao giờ rời khỏi kolens.ai. Claude đổi authorization code lấy một access token mờ và có thể thu hồi.
  • Scope chi tiết. Mỗi công cụ ánh xạ tới một scope bạn đã đồng ý rõ ràng. Màn hình đồng ý liệt kê chúng theo tên — không có truy cập ẩn.
  • Thu hồi theo từng ứng dụng. Truy cập /account/connections để xem mọi client đã kết nối và thu hồi mọi token trong một cú nhấp (RFC 7009).
  • Không có secret dài hạn để sao chép. Token tự hết hạn và làm mới. URL của Custom Connector an toàn để chia sẻ trong tổ chức của bạn.

Khắc phục sự cố

Tôi không thấy “Add custom connector” trong Claude.ai.

Custom Connector yêu cầu gói Claude trả phí (Pro, Team hoặc Enterprise). Trên gói Free, tùy chọn này bị ẩn. Nâng cấp tại claude.ai/upgrade.

Trang đồng ý báo “Invalid client”.

Claude đăng ký một client mới mỗi lần bạn thêm connector. Nếu lần trước bạn bị ngắt giữa chừng (đóng tab, v.v.), hãy xóa connector dang dở khỏi Claude.ai → Settings → Connectors rồi thêm lại. Mỗi lần đăng ký chỉ dùng một lần.

Sau khi kết nối, Claude vẫn không thấy công cụ KOLens.

Làm mới cuộc trò chuyện Claude, hoặc bắt đầu cuộc mới — Claude chỉ làm mới danh sách công cụ tại ranh giới cuộc trò chuyện. Nếu công cụ vẫn không xuất hiện, kiểm tra /account/connections để xác minh kết nối đang hoạt động.

URL https://kolens.ai/mcp trả về 404 khi tôi truy cập trực tiếp.

Đúng như mong đợi. /mcp chỉ phản hồi cho POST với body JSON-RPC — không có gì để hiển thị trong trình duyệt. Claude POST vào nó dưới nền. Để xác nhận endpoint còn sống, hãy mở https://kolens.ai/.well-known/oauth-authorization-server trong một tab mới — bạn sẽ thấy một tài liệu JSON.

Đã kết nối rồi?

Quản lý và thu hồi các client Claude đã kết nối tại Tài khoản → Connections.

Kết nối KOLens với Claude (MCP + OAuth) — Custom Connector | KOLens