viral.app

viral-app-agents

面向编码 Agent 和聊天应用的官方 viral.app 插件和安装快捷方式。安装一次即可将 Agent 连接到 viral.app MCP 服务：提供 100+ 种工具，用于 UGC 分析、账号和视频跟踪、标签及标签工作流、Creator Hub（活动、简报、职位发布、申请、创作者聊天、付款）、病毒式视频库，以及 TikTok/Instagram/YouTube/Facebook 实时查询。插件还提供 七项技能，教会 Agent 如何执行这些工作流。

MCP 服务位于 https://viral.app/api/mcp（可流式传输的 HTTP、OAuth）。你需要拥有一个具备 API 访问权限的 viral.app 账号。请在 viral.app/app/org/api/agents 管理所有内容。

安装

所有客户端都会在浏览器中通过 OAuth 登录。viral.app 支持动态客户端注册，因此你无需粘贴客户端 ID、密钥或 API 密钥。在授权过程中，你需要选择一个组织。

聊天应用： Claude.ai 和 Claude Desktop · ChatGPT · Grok · 其他聊天应用

插件（MCP 服务 + 技能）： Claude Code · Codex CLI · GitHub Copilot CLI · VS Code · Cursor · Gemini CLI · Qwen Code · Kiro · Devin · Factory Droid · Grok Build

仅 MCP 服务： Augment · JetBrains Junie · OpenCode · Amp · Goose · Zed · Warp · Mistral Vibe · 其他任何 MCP 客户端

聊天应用

Claude.ai 和 Claude Desktop

使用此 URL 添加自定义连接器，并将客户端 ID 和密钥留空：

https://viral.app/api/mcp

打开连接器设置，或前往“设置”、“连接器”、“添加自定义连接器”。

在 Claude 网页版、Desktop 和移动端中，热门视频、创作者、活动和 KPI 图表等结果会以交互式卡片呈现。

ChatGPT

安装 ChatGPT 的 viral.app 插件。

• 卡片： 结果会以交互式卡片的形式显示在聊天中；ChatGPT 桌面版还会在侧边栏提供 viral.app 应用和对话面板。
• 事件： 在工作聊天（ChatGPT 网页版，或选择 Cloud 的桌面应用）和 dots 中，要求 ChatGPT 监控 viral.app 上的动态并说明要采取的操作，例如：“每当有创作者申请我的 Habit Tracker 职位时，请总结申请内容并起草一条回复供我批准。”ChatGPT 会通过 viral.app 的 MCP Events 订阅，viral.app 会将每个匹配的事件发送到该聊天。聊天、申请和付款事件会在约一分钟内送达；新视频和观看量里程碑事件则遵循各账号的同步频率（以小时计）。要求 ChatGPT 停止监控即可结束订阅。

Grok

在 grok.com 上，打开“连接器”，选择“新建连接器”，然后选择“自定义”，并粘贴 https://viral.app/api/mcp。

对于 Grok Bot，请在 viral.app 上架 Marketplace 后从中安装。

其他聊天应用

这些应用支持使用 OAuth 的自定义远程 MCP URL。请使用 https://viral.app/api/mcp：

• Perplexity：“设置”、“连接器”、“自定义连接器”、“远程”。选择 OAuth 和可流式传输的 HTTP。
• Mistral Vibe（原名 Le Chat），工作模式：“连接器”、“添加连接器”、“自定义 MCP 连接器”。只有管理员可以添加连接器；名称请勿包含特殊字符，例如 viralapp。
• Notion 自定义 Agent（Business 和 Enterprise）：管理员需在“设置”、“连接”下启用自定义 MCP 服务。然后打开 Agent 的“工具和访问权限”、“添加连接”、“自定义 MCP 服务”。

插件

Claude Code

claude plugin marketplace add https://github.com/fmd-labs/viral-app-agents
claude plugin install viral-app@viral-app

也可以交互式操作：运行 /plugin marketplace add https://github.com/fmd-labs/viral-app-agents，然后运行 /plugin install viral-app。接着运行 /mcp，选择 viral_app，并在浏览器中完成身份验证。如果你有 GitHub SSH 访问权限，也可以使用 fmd-labs/viral-app-agents 这一简写。

Codex CLI

codex plugin marketplace add https://github.com/fmd-labs/viral-app-agents
codex plugin add viral-app@viral-app

也可以交互式操作：在 Codex TUI 中运行 /plugins。之后启动一个新会话，再通过 codex mcp login viral_app 完成身份验证。

需要 Codex CLI 0.147 或更高版本。较早版本会在 OAuth 登录时出现“Authorization server response missing required issuer”错误（这是已在 0.147.0 中修复的 Codex 错误）；请使用 npm install -g @openai/codex@latest 更新后重试。

如果你只需要 MCP 服务，不需要插件：

codex mcp add viral_app --url https://viral.app/api/mcp
codex mcp login viral_app

GitHub Copilot CLI

copilot plugin marketplace add fmd-labs/viral-app-agents
copilot plugin install viral-app@viral-app

VS Code

通过 Agent 插件安装插件（包含 MCP 服务和技能）。在用户设置中添加市场：

"chat.plugins.enabled": true,
"chat.plugins.marketplaces": ["fmd-labs/viral-app-agents"]

然后在扩展视图中搜索 @agentPlugins，并安装 viral-app。

如果只需要 MCP 服务：

或者添加到 .vscode/mcp.json：

{ "servers": { "viral_app": { "type": "http", "url": "https://viral.app/api/mcp" } } }

Cursor

或者添加到 .cursor/mcp.json：

{ "mcpServers": { "viral_app": { "type": "http", "url": "https://viral.app/api/mcp" } } }

此仓库还提供 Cursor 插件清单（.cursor-plugin/），其中打包了 MCP 服务和技能，可用于 Cursor Marketplace。

Gemini CLI

gemini extensions install https://github.com/fmd-labs/viral-app-agents

重启 Gemini CLI，然后运行 /mcp auth viral_app 登录。

Qwen Code

qwen extensions install fmd-labs/viral-app-agents:viral-app

你将获得 MCP 服务和技能；运行 /mcp 检查连接。

Kiro

在 Powers 面板中选择 Add Custom Power，然后选择 Import power from GitHub，并输入：

https://github.com/fmd-labs/viral-app-agents

Devin

devin plugins install fmd-labs/viral-app-agents#plugins/viral-app

如果你还没有登录 Devin，请先运行 devin auth login，然后运行 devin mcp login viral_app 连接 viral.app。

Factory Droid

droid plugin marketplace add https://github.com/fmd-labs/viral-app-agents
droid plugin install viral-app@viral-app-agents --scope user

Droid 会使用仓库名称作为市场名称，因此这里是 @viral-app-agents。运行 /mcp 完成浏览器登录。

Grok Build

grok plugin marketplace add fmd-labs/viral-app-agents
grok plugin install viral-app --trust

必须传入 --trust，CLI 才会安装插件。

仅 MCP 服务

以下客户端只会获取 MCP 服务，不包含打包的技能。

Augment 和 Auggie

auggie mcp add viral_app --transport http --url https://viral.app/api/mcp

在 IDE 扩展中，依次选择 Settings、MCP、Add remote MCP，连接类型选择 HTTP。

JetBrains Junie

将以下内容添加到项目中的 .junie/mcp/mcp.json（或 ~/.junie/mcp/mcp.json），也可以依次选择 Settings、Tools、Junie、MCP Settings：

{ "mcpServers": { "viral_app": { "url": "https://viral.app/api/mcp" } } }

在 Junie CLI 中运行 /mcp，选择 viral_app，然后选择 Authorize。

OpenCode

添加到 opencode.json：

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": { "viral_app": { "type": "remote", "url": "https://viral.app/api/mcp" } }
}

然后运行 opencode mcp auth viral_app。

Amp

amp mcp add viral_app https://viral.app/api/mcp

Amp 会在下次启动时打开浏览器登录页面。

Goose

打开此链接，将扩展添加到 Goose Desktop（GitHub 不会渲染 goose:// 链接，因此请将其复制到浏览器中）：

goose://extension?type=streamable_http&url=https%3A%2F%2Fviral.app%2Fapi%2Fmcp&id=viral_app&name=viral.app&description=UGC%20analytics%20and%20tracking%20from%20viral.app

在命令行中运行：goose configure，选择 Add Extension、Remote Extension (Streamable HTTP)，并将 URL 设为 https://viral.app/api/mcp。

要同时添加技能，请运行 goose plugin install https://github.com/fmd-labs/viral-app-agents.git。Goose 会将它们加载为 viral-app:viral-app-mcp、viral-app:ugc-reporting 等。

Zed

将以下内容添加到 Zed 设置中，或依次选择 Settings、AI、MCP Servers、Add Server、Add Remote Server：

{ "context_servers": { "viral_app": { "url": "https://viral.app/api/mcp" } } }

Zed 会提示你登录。

Warp

依次选择 Settings、Agents、MCP servers、Add，然后粘贴：

{ "mcpServers": { "viral_app": { "url": "https://viral.app/api/mcp" } } }

Mistral Vibe

vibe mcp add viral_app --url https://viral.app/api/mcp

其他 MCP 客户端

使用可流式 HTTP 和 OAuth，将客户端指向 https://viral.app/api/mcp。该服务会发布标准 OAuth 发现元数据，并支持动态客户端注册，因此无需预先共享凭据。其官方 MCP Registry名称为 io.github.fmd-labs/viral-app。

技能

插件包含七项技能。Agent 会按需加载这些技能，每项技能的较长内容都放在其旁边的 references/ 文件夹中。

技能	用途
viral-app-mcp	核心指南：连接和身份验证、先报价再确认的积分流程、会触达创作者的写入操作规则、ID 和单位、MCP 无法执行的操作，以及接下来应加载哪项技能
ugc-reporting	每周或每月 UGC 报告、包含周期环比变化的 KPI 和排行榜方案、Claude 和 ChatGPT 中的卡片、Slack 摘要，以及通过计划任务或 ChatGPT 页面生成定期报告
creator-briefs	按 viral.app 的 Copilot 写法撰写创作者简报：产品、来自 viral 库或你自己的视频的已验证样例视频、简报结构、编号样例、阅读对象以及是否通知；通过 MCP 或使用 API 密钥的 REST API
creator-management	创作者名单的日常管理：逐个或通过 CSV 添加创作者、发送邀请、关联社交账号、私聊和群聊、群发消息、提醒进展停滞的创作者，以及审查名单；通过 MCP 或 REST
creator-campaigns	端到端使用 Creator Hub：包含基准数据和预览步骤的引导式活动设置、薪酬变更和自定义费率、创作者分配、职位发布（撰写、基准数据、发布）、申请和付款信息查询
viral-research	爆款视频库、相似视频、钩子和场景拆解、对已跟踪视频进行 AI 分析、实时查询，以及将发现转化为钩子和简报
ugc-automations	“监测 X 并执行 Y”：在 ChatGPT 中使用 MCP Events、其他客户端的轮询回退方案、各事件的延迟，以及处理不可信的创作者文本

包含内容

路径	用途
.claude-plugin/marketplace.json	Claude 格式的市场目录（Claude Code、Copilot CLI、VS Code、Factory、Grok Build）。列出 viral-app
.agents/plugins/marketplace.json	Codex 市场目录
.cursor-plugin/marketplace.json	Cursor 市场目录（Cursor、Grok Bot）
gemini-extension.json	Gemini CLI 扩展清单（Gemini CLI、Qwen Code）
plugin.json	仓库根目录的 Agent Plugins 1.0 清单（直接安装仓库根目录时适用于 Kiro、Mistral Vibe，以及 Copilot CLI 或 Devin；Goose 仅导入技能）
mcp.json	仓库根目录的 Agent Plugins 1.0 MCP 配置（与 plugin.json 一起读取）
skills/	根级软件包的插件技能副本（Gemini CLI、Agent Plugins）。由 scripts/sync-skills.sh 从 plugins/viral-app/skills/ 生成
server.json	官方 MCP Registry 条目 io.github.fmd-labs/viral-app
.github/workflows/publish-mcp-registry.yml	在拉取请求中验证 server.json，并通过 GitHub OIDC 从 main 发布到 MCP Registry
plugins/viral-app/.claude-plugin/plugin.json	内嵌 MCP 服务的 Claude 格式插件清单（Claude Code、Copilot CLI、VS Code、Devin、Grok Build）
plugins/viral-app/.codex-plugin/plugin.json	Codex 插件清单
plugins/viral-app/.cursor-plugin/plugin.json	Cursor 插件清单
plugins/viral-app/.mcp.json	Claude 格式的 MCP 配置（Codex、Factory、Grok Build；Claude Code 会将其与内嵌条目合并）
plugins/viral-app/skills/	七项技能（规范副本）
scripts/sync-skills.sh	将 plugins/viral-app/skills/ 复制到 skills/；使用 --check 时，若两者不一致则失败
scripts/build-chatgpt-package.sh	为 OpenAI 的插件控制台（Upload new version）构建 dist/viral-app-chatgpt.zip：包含 plugins/viral-app 的 Codex 清单、.mcp.json、技能和资源，按 OpenAI 的软件包规则检查，且不包含 Claude 和 Cursor 清单
plugins/viral-app/assets/	插件徽标（logo.svg、400x400 的 logo.png）

发布时：

• 在 plugin.json、gemini-extension.json、plugins/viral-app/.claude-plugin/plugin.json、plugins/viral-app/.codex-plugin/plugin.json、plugins/viral-app/.cursor-plugin/plugin.json 以及 .claude-plugin/marketplace.json 和 .agents/plugins/marketplace.json 中对应条目内，一并更新 viral-app 的 version（运行 grep -rn '"version"' --include=*.json . 可列出这些位置）。
• 仅在 plugins/viral-app/skills/ 中编辑技能，然后运行 scripts/sync-skills.sh（--check 可验证副本是否一致）。
• 对于 ChatGPT，运行 scripts/build-chatgpt-package.sh，并在 OpenAI 插件控制台中上传 dist/viral-app-chatgpt.zip 作为新版本。脚本会将已发布插件的软件包名称（app-6a8713d41dc48191b33e75c49a764db3）写入 ZIP 的清单，因为控制台不接受其他名称。托管的 MCP 服务有更改时无需上传；清单和技能有更改时则需要上传。
• server.json 有自己的版本；MCP Registry 会拒绝已发布过的版本，因此每次修改该文件时都要更新版本。

身份验证与安全

• 默认使用 OAuth。授权时，你可以选择一个组织；授权将永久限定于该组织。可在 viral.app/app/user/settings/security 中查看或撤销已授权客户端。
• API 密钥仅用于高级配置场景，例如需要在多个组织间切换的单个 Agent。请在 viral.app 控制面板中为每个组织单独创建密钥。
• 此仓库不包含任何机密，也永远不会包含。它仅提供指向 viral.app 端点的公开配置；所有凭据都在运行时通过你自己的浏览器进行 OAuth 授权。
• 会消耗 viral.app 额度的工具（实时查询、刷新、视频分析）会先说明费用，只有在你再次调用并明确确认后才会执行。

支持与隐私

• 支持： [email protected]
• 隐私政策：viral.app/legal/privacy
• 服务条款：viral.app/legal/terms

相关内容

• viral.app 文档
• API 参考
• viral-app-skills：基于 CLI 的 API 密钥工作流技能
• n8n-nodes-viral-app：n8n 社区节点

许可证

MIT