Communitygithub.com

benjaminb10/viewlify-mcp

为Claude和AI智能体提供TikTok数据:MCP服务器(发现超出创作者常规浏览量的视频、趋势、话题标签、声音),包含3个技能的Claude Code插件,以及viewlify命令行工具。

viewlify-mcp 是什么?

Viewlify MCP是一个远程MCP服务器,旨在为Claude Code、Claude AI、Cursor或其他MCP客户端提供TikTok公开数据的访问。其核心功能是计算每个视频的“倍数”指标,即视频实际观看次数与其创作者历史平均观看次数的比率,从而区分出真正的“爆款”视频与仅仅是高播放量的普通视频。该工具支持按细分领域(如美妆、游戏、科技)搜索趋势视频、发现爆款视频、分析创作者数据以及追踪话题标签和声音的趋势。对于开发者而言,它既可以通过Claude Code插件快速安装使用,也可以直接配置为MCP服务器,还提供了`viewlify`命令行工具。免费使用受限预览功能(每次调用返回5个结果),付费计划则提供完整结果、详细历史数据和无限制搜索。

兼容平台✓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视频,将它们与创作者的历史平均观看次数进行比较:一个50K观看量的视频,对于一个通常能获得500K观看量的创作者来说是失败之作,但对于一个通常只有2K观看量的创作者来说则是爆款。这个比率,即倍数,正是本服务器返回的核心指标,同时还会返回按细分领域增长最快的话题标签和声音。

本仓库包含在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密钥。此密钥为可选(见下文):留空即可使用免费预览版。

仅使用MCP服务器(Claude Code):

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和其他客户端:一个 Streamable HTTP 服务器,地址为 https://viewlify.app/api/mcp,需要包含请求头 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必需按关键字、@创作者或#话题标签搜索整个数据库;可按照趋势、爆款、观看次数、最新、互动率或分享数排序
get_balance, top_up必需API余额信息,以及用于充值的付款链接
list_my_accounts, get_account_growth, get_account_videos, get_my_niche_watch, get_my_video_checksPro 或 Agency你追踪的账户、它们的增长情况和视频、你的细分领域观察以及AI视频分析

细分领域:美妆、游戏、美食、健身、时尚、喜剧、舞蹈、宠物、足球、体育、音乐、旅行、科技、汽车、理财、学习、家居、艺术、励志、动漫。仅提供只读访问权限:服务器从不发布或更改任何内容。

技能

技能使用场景
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。欢迎提交Issues和Pull requests。由 Viewlify 构建。

相关技能