Communitygithub.com

benjaminb10/viewlify-mcp

為 Claude 與 AI 代理提供 TikTok 資料的 MCP 伺服器(找出創作者表現超常的影片、趨勢、主題標籤、音效),附帶 Claude Code 外掛(含 3 個技能)與 viewlify CLI。

viewlify-mcp 是什麼?

Viewlify MCP 是一個專為 Claude、Claude Code、Cursor 及其他 MCP 客戶端設計的 TikTok 資料伺服器。其核心功能是透過「倍率」(multiple)來識別突破性影片——將單支影片的觀看數與該創作者的平均觀看數進行比較,例如:一支 5 萬觀看的影片,對於通常有 50 萬觀看的帳號是失敗,但對通常只有 2 千觀看的帳號則是爆紅。伺服器提供多項工具,包括取得各領域當下的趨勢(影片、主題標籤、音效)、找出與創作者平常表現差距最大的「離群值」影片、搜尋整個資料庫(可依關鍵字、創作者或主題標籤),以及分析個別創作者的數據。此外,還包含三個實用技能:TikTok 離群值研究、TikTok 影片點子產生器,以及 TikTok 趨勢週報。API 可在免費預覽(每 IP 每天 20 次呼叫)或付費方案(每次呼叫 $0.005 美元)下使用。

相容平台✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/benjaminb10/viewlify-mcp/tree/main

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Viewlify MCP:為 Claude 與 AI 代理提供的 TikTok 資料

讓 Claude 找出哪些 TikTok 影片在某個領域中真正脫穎而出,並分析原因。Viewlify 追蹤公開的 TikTok 影片,並將每支影片與其創作者的平均觀看數進行比較:一支 5 萬觀看的影片,對於通常有 50 萬觀看的帳號是失敗,但對通常只有 2 千觀看的帳號則是爆紅。這個比例——倍率——正是本伺服器回傳的內容,同時也回傳在各領域中觀看數增長最快的影片、主題標籤和音效。

此儲存庫包含從 Claude Code、Claude、Cursor 或任何 MCP 客戶端使用 Viewlify 所需的一切:

  • 遠端 MCP 伺服器設定(https://viewlify.app/api/mcp),
  • 一個Claude Code 外掛,內建三個技能,
  • 在 npm 上發佈的 viewlify 命令列工具的原始碼。

伺服器由 Viewlify 代管;本機無需執行任何程式。

快速開始

Claude Code,作為外掛(MCP 伺服器與三個技能):

/plugin marketplace add benjaminb10/viewlify-mcp
/plugin install viewlify@viewlify

安裝時,Claude Code 會要求提供 Viewlify API 金鑰。此為選用項目(詳見下方):留空即可使用免費預覽。

Claude Code,僅 MCP 伺服器:

claude mcp add --transport http viewlify https://viewlify.app/api/mcp --header "Authorization: Bearer vf_live_YOUR_KEY"

Claude(claude.ai 或桌面版): 設定 > 連接器 > 新增自訂連接器,URL https://viewlify.app/api/mcp。

Cursor 與其他客戶端: 在 https://viewlify.app/api/mcp 上的 Streamable HTTP 伺服器,需使用標頭 Authorization: Bearer vf_live_YOUR_KEY。

終端機: npx viewlify login,然後 npx viewlify search "skincare" --sort outlier --limit 5。 npx viewlify mcp 會輸出帶有金鑰的 claude mcp add 指令。

API 金鑰與價格

金鑰為選用。無金鑰時,公開工具會回傳 5 筆結果的預覽(每 IP 每天 20 次呼叫)。

有金鑰時,您可獲得完整結果、離群值倍率、每千次觀看分享數、Viewlify 記錄的觀看歷史,以及對資料庫中所有影片的搜尋功能。任何 Viewlify 帳號都可以在設定 > API 與 MCP 建立金鑰,免費方案亦包含在內,並附贈 $1 美元的免費額度。之後每次呼叫費用為 $0.005 美元,從預付額度中扣除(最低加值額度為 5 至 100 美元),或包含在 Pro 與 Agency 方案中。價格請見:viewlify.app/tiktok-data-api。

工具

工具金鑰需求回傳內容
get_trending選用各領域中當下正在爆紅的影片、主題標籤和音效
get_outliers選用與創作者平均觀看數差距最大的影片,可按領域或搜尋
get_trending_hashtags選用在爆紅內容中頻繁出現的主題標籤,按領域區分
get_creator選用單一創作者:粉絲數、平均觀看數、互動率、最佳爆紅影片、最佳發文日、熱門主題標籤與音效,以及附帶倍率的影片
search_trending_videos必要搜尋整個資料庫,支援關鍵字、@creator 或 #hashtag;可按趨勢、離群值、觀看數、近期、互動率或分享數排序
get_balance, top_up必要API 額度,以及加值連結
list_my_accounts, get_account_growth, get_account_videos, get_my_niche_watch, get_my_video_checksPro 或 Agency您自己追蹤的帳號、其成長數據與影片、您的領域觀察與 AI 影片檢查

領域:beauty, gaming, food, fitness, fashion, comedy, dance, pets, football, sports, music, travel, tech, cars, money, learning, home, art, motivation, anime。僅供讀取:伺服器絕不發文或修改任何內容。

技能

技能用途
tiktok-outlier-research找出某領域中真正爆紅的內容及其背後模式
tiktok-video-ideas獲得 5 個影片點子(附帶鉤子),每個都以真實爆紅影片為藍本
tiktok-trend-watch一頁式的每週趨勢摘要,涵蓋新興格式、主題標籤和音效

技能也適用於 claude.ai:下載技能資料夾,然後在設定 > 功能 > 技能中新增。

提示範例

  • "這個月 TikTok 健身領域有哪些內容正在爆紅?這些影片有什麼共通點?"
  • "為一個在家拍攝的烹飪帳號提供 5 個影片點子,以目前有效的內容為基礎。"
  • "美妝與時尚的每週趨勢摘要。"
  • "搜尋 TikTok 上關於蛋白棒且按離群值排序的影片,限最近 30 天。"

資料

僅限公開的 TikTok 資料:影片、標題、主題標籤、音效與公開計數器,每日更新。Viewlify 與 TikTok 無關聯。

儲存庫架構

.claude-plugin/   外掛與市集清單(適用於 Claude Code)
.mcp.json         外掛連接的 MCP 伺服器(安裝時可選填 API 金鑰)
server.json       官方 MCP 註冊項目
skills/           三個技能

授權條款

MIT。歡迎提交 Issue 與 Pull Request。由 Viewlify 打造。

相關技能