將 KOLens 接入 Claude
把一個網址貼到 Claude.ai 的自訂連接器對話框,點一次同意,Claude 就能用自然語言為你搜尋達人、抓取受眾畫像、偵測廣告、管理關注名單與提醒。底層使用 MCP + 含 PKCE 的 OAuth 2.1,你的憑證始終保留在 kolens.ai。
https://kolens.ai/mcp複製貼到 Claude 的就是這個網址。
30 秒完成接入
- 1
開啟 Claude.ai,前往 設定 → Connectors。
Claude Pro、Team 與 Enterprise 方案皆可使用。在連接器清單底部找到 新增自訂連接器。
- 2
貼上
https://kolens.ai/mcp,點擊 連線。Claude 會自動探索我們的 OAuth 端點(RFC 9728/8414)並以公開用戶端身分動態註冊(RFC 7591)。你不需要建立 API Key,也不必處理任何 Secret。
- 3
在授權頁面登入你的 KOLens 帳號。
你會被導向
https://kolens.ai/oauth/authorize。還沒有帳號?先註冊一個。 - 4
確認所要求的權限範圍,點擊 同意。
授權頁會逐項列出 Claude 申請的權限 —— 通常是
read:kols、write:lists、run:scrape。你可以隨時在 帳號 → 連線 中撤銷其中任何一項。 - 5
完成 —— 試著問一個問題。
開啟任一段 Claude 對話,試試這些指令:
- 「幫我搜美國地區粉絲數超過 5 萬的手機殼類 KOL。」
- 「給我看 @creatorbeta 的受眾畫像。」
- 「把 @creatoralpha 加進我的 A-list 關注名單。」
- 「把我所有 rising_kol 類型的提醒標記為已讀。」
15 項工具,即裝即用
達人探索
list_kols— 依關鍵字、粉絲數、互動率與地區篩選 KOL。get_kol_profile— 完整的達人檔案 + 最近影片 + 聯絡方式。search_history— 你(或你的團隊)最近搜尋過什麼。run_scrape— 發起一次新的關鍵字爬取任務。
受眾與成長
get_audience_snapshot— 國家組成、語言、活躍度、Top 垂類,附 95% 信心區間。list_alerts— KOLens 為你識別出的崛起達人與爆款影片。mark_alert_read— 直接在對話中把提醒標記為已讀。
廣告偵測
list_advertisers— 目前在某垂類投放 Facebook 廣告的品牌。get_ad_detail— 抓取單則廣告的完整資料 —— 文案、創意、投放區間。list_watches— 你儲存的自動執行廣告偵測。
名單與關注
add_to_list— 把一位 KOL 存到指定名單,稍後批次匯出。add_to_watchlist— 持續追蹤一位 KOL 的成長曲線。list_lists— 你的所有 KOL 名單。list_watchlist— 你關注的 KOL 及資料變化。remove_from_watchlist— 停止追蹤某位 KOL。
安全機制
- OAuth 2.1 + PKCE。你的密碼永遠不會離開 kolens.ai。Claude 拿到的是一枚不透明、可撤銷的存取權杖。
- 細粒度權限。每個工具都對應一項你明確同意過的權限。授權頁會逐項展示 —— 不存在隱式存取。
- 逐應用程式撤銷。前往 /account/connections 即可看到所有已連線的用戶端,一鍵撤銷任意權杖(RFC 7009)。
- 無需保管長期密鑰。權杖會自動過期與續發。自訂連接器網址即便在組織內共享也很安全。
常見問題排查
在 Claude.ai 看不到「新增自訂連接器」。
自訂連接器需要付費 Claude 方案(Pro、Team 或 Enterprise)。免費版會隱藏該選項。可前往 claude.ai/upgrade 升級。
授權頁顯示「Invalid client」。
Claude 每次新增連接器都會註冊一個全新的用戶端。如果你之前的註冊中途被打斷(例如關閉了分頁),請先在 Claude.ai → 設定 → Connectors 中刪除那筆未完成的連接器,然後重新加入。每次註冊僅單次有效。
連線完成後,Claude 仍找不到 KOLens 的工具。
重新整理目前對話,或開啟一段新對話 —— Claude 只會在對話開始時更新工具清單。如仍未出現,可前往 /account/connections 檢查連線是否處於啟用狀態。
網址 https://kolens.ai/mcp 在瀏覽器直接開啟會 404。
這是預期表現。 /mcp 僅回應帶有 JSON-RPC 內容的 POST 請求 —— 瀏覽器上沒有任何內容可供呈現。Claude 會在背景對它發 POST。要確認服務運作中,可在新分頁開啟 https://kolens.ai/.well-known/oauth-authorization-server ,你應可看到一份 JSON 文件。
可在 帳號 → 連線 管理或撤銷已連線的 Claude 用戶端。