Virlo Social Media Research Agent MCP

Virlo Agent 插件

为你的 AI Agent 配备社交媒体大脑。通过 Claude、Cursor、Grok、Codex 或任何 MCP 客户端，发现 TikTok、YouTube Shorts 和 Instagram Reels 上的热门趋势，了解视频走红的原因，查询任意创作者，并在热门声音和话题标签达到热度峰值前及时发现它们。

支持： Claude Code、Claude Desktop、claude.ai、Cursor、Grok Build、VS Code、Windsurf、OpenAI Codex，以及任何兼容 MCP 的 Agent。

基于 Virlo API 构建。Virlo 是一个短视频社交情报平台，覆盖 TikTok、YouTube Shorts、Instagram Reels 和 Meta Ads 的各类细分领域。

你的 Agent 可以做什么

• 及早发现趋势： 新兴趋势、每日趋势摘要，以及过去 48 小时内最热门的病毒式视频
• 解析走红原因： 分析特定视频为何走红（开场钩子、形式、声音、时机）
• 研究任意细分领域： 运行研究 Agent，查找某个主题下的热门视频、表现突出的创作者和内容模式
• 每周监控细分领域： 定期运行研究 Agent，发掘热度上升的声音、话题标签和创作者
• 查询创作者： 个人资料、表现突出的热门视频、受众人口统计信息和地域分布、发布频率
• 发现热门声音和话题标签： 爆红音频、声音使用历史、话题标签增长情况
• 借鉴有效的开场钩子： 热门开场钩子和可搜索的钩子库
• 持续追踪： 每日追踪创作者和视频，并生成信号报告

安装

技能（Claude Code、Cursor、Codex、Windsurf 和其他 Agent）

npx skills add Virlo-AI/Virlo-Agent-Plugin

此仓库包含两个技能：

使用 --skill 只安装一个技能：

npx skills add Virlo-AI/Virlo-Agent-Plugin --skill short-form-trend-research

这些技能需要连接 Virlo MCP 服务。请参阅 MCP 服务。

Claude Code 插件

/plugin marketplace add Virlo-AI/Virlo-Agent-Plugin
/plugin install virlo@virlo

该插件会为你连接 MCP 服务。收到提示时，登录 Virlo。无需 API 密钥。

Grok Build 插件

/plugin marketplace add xai-org/plugin-marketplace
/plugin install virlo@xai-official

该插件会为你连接 MCP 服务。收到提示时，登录 Virlo。无需 API 密钥。

claude --plugin-dir ./Virlo-Agent-Plugin

Agent Plugins 标准

此仓库是一个可移植的 Agent Plugin（规范版本 1.0.0）。根目录中的 plugin.json + mcp.json + skills/ 让任何兼容的客户端都能通过这个软件包加载 Virlo 技能，并连接到托管的 MCP 服务。针对特定客户端的清单文件并列存放：

设置

**Claude Code、Claude Desktop、claude.ai、Grok Build：**无需设置。客户端提示时登录 Virlo。系统会为你创建专用 API 密钥。

Cursor、VS Code、Windsurf、Codex 和其他客户端：

1. 在 dev.virlo.ai/dashboard/api-keys 创建 API 密钥。密钥以 virlo_tkn_ 开头。

2. 在环境中设置它：

   export VIRLO_API_KEY=virlo_tkn_xxxxx
   

   将它添加到 ~/.zshrc 或 ~/.bashrc，以便在不同会话间保留。mcp.json 会将其读取为 ${env:VIRLO_API_KEY}（Cursor 语法；请确认你的客户端所用的等效语法）。

3. 重启客户端。

开始使用

向你的 Agent 提出类似这样的问题：

• “本周 TikTok 健身领域有哪些热门趋势？”
• “这条视频为什么会爆红？”（粘贴 TikTok、Shorts 或 Reels 链接）
• “查找 YouTube 上的 @creator，并展示他们表现突出的作品。”
• “现在有哪些声音正在迅速走红？”
• “为 SaaS 创业者生成 10 条适用于短视频的开场文案。”
• “为 TikTok 和 Instagram 上的护肤内容设置每周监测。”
• “为家常菜账号规划下周的 Reels 内容。”

斜杠命令

MCP 服务

Virlo 运行托管式远程 MCP 服务。任何 MCP 客户端都可以直接连接，无需安装。

• 端点：https://dev.virlo.ai/api/mcp/mcp（可流式传输的 HTTP）
• **身份验证：**OAuth 2.0 动态客户端注册（Claude 客户端），或使用 Authorization: Bearer virlo_tkn_...

Claude Code（无需插件）：

claude mcp add --transport http virlo https://dev.virlo.ai/api/mcp/mcp

**Claude Desktop / claude.ai：**使用上方的端点 URL 添加自定义连接器，然后登录。OAuth 客户端 ID 和密钥留空。

Cursor / VS Code / 其他 HTTP 客户端：

{
  "mcpServers": {
    "virlo": {
      "url": "https://dev.virlo.ai/api/mcp/mcp",
      "headers": { "Authorization": "Bearer virlo_tkn_your_key_here" }
    }
  }
}

不支持远程 MCP 的客户端（通过 mcp-remote）：

{
  "mcpServers": {
    "virlo": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://dev.virlo.ai/api/mcp/mcp", "--header", "Authorization: Bearer virlo_tkn_your_key_here"]
    }
  }
}

工具

共有 65 个工具。当前工具列表和定价见 dev.virlo.ai/docs/mcp。

费用

大多数研究工具按调用计费。研究 Agent 每次运行收费 $0.50（使用 Data Intelligence 时另加 $1.00）。定期监测每次运行都会计费。重新读取已有结果免费。virlo 技能会检查余额，并在消费前征求你的同意。完整定价：dev.virlo.ai/docs/mcp。

故障排除

没有显示 Virlo 工具

MCP 服务尚未连接。Claude 客户端：重新登录。其他客户端：确认启动客户端时所用的环境中已设置 VIRLO_API_KEY，然后重启客户端。

401 或 403 错误

密钥错误或已撤销。请前往 dev.virlo.ai/dashboard/api-keys 创建新密钥。

研究任务未返回视频

这几乎总是意图或关键词的问题，而非服务中断。请写出更明确的一句话意图，然后再次运行 suggest_keywords。

结果中有些字段为空

任务尚未完成。请等待 finalized: true。研究 Agent 通常会在约 8 分钟内完成收集（10 次中有 9 次会在 20 分钟内完成）。

网络和凭据

此插件唯一连接的端点是 Virlo 的 MCP 服务 https://dev.virlo.ai/api/mcp/mcp，通过 OAuth 或你提供的 VIRLO_API_KEY 进行身份验证（仅在该请求的 Authorization 标头中发送）。不会进行其他网络调用，不收集遥测数据，不运行本地命令，也不写入文件。这些技能只读取公开的社交媒体数据，绝不会发布内容或更改你的社交账号。

链接

• Virlo
• MCP 设置和工具参考
• API 密钥

许可证

MIT