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_checks | Pro 或 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 构建。