面向 AI 代理的 MCP
MCP 为 AI 客户端提供 VibeVO 工具,可查询账号、活动和帖子,管理内容工厂并制作报告。
连接客户端
需要 Node.js 20+ 和 VibeVO API 密钥。查询需要 read 权限;修改需要 write 及相应功能的访问权限。 创建 API 密钥.
客户端配置
Codex · CLI / IDE
将此配置添加到 ~/.codex/config.toml。在启动 Codex 的环境中设置 VIBEVO_API_KEY。适用于 CLI 和 IDE 扩展。重启客户端后用 /mcp 检查连接。
[mcp_servers.vibevo]
command = "npx"
args = ["-y", "@vibevo/mcp@latest"]
env_vars = ["VIBEVO_API_KEY"]Claude Desktop / Cursor
Claude Desktop:Settings → Developer → Edit Config。Cursor:个人配置 ~/.cursor/mcp.json。合并到已有配置,仅在本地替换 REPLACE_WITH_YOUR_API_KEY,然后重启客户端。
{
"mcpServers": {
"vibevo": {
"command": "npx",
"args": [
"-y",
"@vibevo/mcp@latest"
],
"env": {
"VIBEVO_API_KEY": "REPLACE_WITH_YOUR_API_KEY"
}
}
}
}Windows 找不到 npx 时,使用 command: cmd 和 args: ["/c", "npx", "-y", "@vibevo/mcp@latest"]。
验证连接
请代理调用 vibevo_whoami,确认密钥所有者与权限。401 表示需检查密钥;403 表示需检查权限和功能访问。
功能与工具
工具可用性取决于已发布版本、角色和密钥权限。准确参数以连接的服务器提供的结构为准。
身份与钱包
工具列表 3
vibevo_whoami读取vibevo_get_wallet读取vibevo_list_wallet_transactions读取
社交账号与验证
工具列表 10
vibevo_list_social_accounts读取vibevo_get_social_account_verification读取vibevo_get_social_account_stats读取vibevo_add_social_account写入vibevo_connect_social_account写入vibevo_start_social_account_verification写入vibevo_check_social_account_verification写入vibevo_start_social_account_stats_session写入vibevo_upload_social_account_stats写入vibevo_refresh_social_account_stats写入
活动与帖子
工具列表 14
vibevo_list_offers读取vibevo_list_my_posts读取vibevo_list_campaigns读取vibevo_get_campaign读取vibevo_get_campaign_analytics读取vibevo_list_campaign_posts读取vibevo_list_campaign_creators读取vibevo_list_campaign_tracking_links读取vibevo_list_campaign_post_proofs读取vibevo_get_campaign_post_proof读取vibevo_download_campaign_proofs_zip读取vibevo_list_my_post_proofs读取vibevo_get_my_post_proof读取vibevo_submit_post写入
工厂、账号与标签
工具列表 11
vibevo_list_factories读取vibevo_get_factory_summary读取vibevo_list_factory_accounts读取vibevo_list_factory_posts读取vibevo_get_factory_account读取vibevo_create_factory写入vibevo_patch_factory写入vibevo_add_factory_items写入vibevo_patch_factory_account写入vibevo_list_factory_tags读取vibevo_list_factory_tag_groups读取
为账号添加标签
标签分配给工厂中的监控账号,可用于筛选账号、帖子和统计汇总。你的标签列表跨工厂共用。
- 用 vibevo_list_factories 查找工厂,再用 vibevo_list_factory_accounts 查找账号。使用返回的 factoryAccountId,而非社交平台 ID。
- 读取现有 tags,将新旧标签去重合并,再把完整列表传给 vibevo_patch_factory_account。
- 重新读取账号验证结果。vibevo_list_factory_tags 列出可用标签;vibevo_list_factory_tag_groups 返回工厂的标签汇总。
用于添加标签并保留现有标签的请求。发送前请替换工厂名称、账号和标签。
参数示例 · 请替换 ID 和标签
{
"id": 1,
"factoryAccountId": 42,
"tags": [
"Brand",
"Autumn"
]
}监控与代币
工具列表 9
vibevo_refresh_factory_account写入vibevo_get_monitoring_wallet读取vibevo_get_factory_credits读取vibevo_get_factory_credit_usage读取vibevo_list_factory_credit_history读取vibevo_update_factory_scan_settings写入vibevo_set_factory_monitoring写入vibevo_refresh_factory_post写入vibevo_buy_monitoring_tokens写入
公开报告
工具列表 5
vibevo_list_factory_reports读取vibevo_create_factory_report写入vibevo_revoke_factory_report写入vibevo_restore_factory_report写入vibevo_delete_factory_report写入
ER 与收藏数
ER = 100 × (likes + comments) / views,保留两位小数。使用观看、点赞、评论的最新完整观测。汇总按计数之和计算,不对各帖百分比求平均。观看数为零或没有完整观测时,ER 为 null。收藏和转发不计入公式。
活动列表、详情、分析、帖子和创作者返回 engagement,scope 为 accepted_video。仅包含已接受的视频帖子;帖子行只涵盖该帖子,创作者行涵盖其账号。分母使用 engagement.views:原有 totalViews 可能包含其他状态或表示付费观看数。
内容工厂的标准 ER 位于 metrics.er(汇总为 totals.er),收藏数位于 metrics.saves。历史点和 snapshotBaseline 具有相同字段。原有顶层 er 保留旧语义,新客户端使用嵌套字段。旧响应缺少新字段不代表已测量。
saves 是独立的最新已知计数。自动来源为 TikTok collectCount 和 X bookmarkCount,仅在提供方返回有效值时使用。其他平台没有实际测量时不可用。0 表示测得零,null 表示没有数据,不能将 null 替换为零。旧活动历史无法证明原始观看数;新 ER 随正常扫描逐步可用,无需批量付费重扫。
erCoverage 和 savesCoverage 中的 measuredPosts / totalPosts 涵盖分页前的整个筛选集合。部分覆盖表示部分汇总。updatedAt 和 savesUpdatedAt 是已包含测量中最早的时间;null 表示新鲜度未知。把旧计数带入新快照不会更新时间。图表的 ER 与收藏数为绝对快照,不使用增量模式。
报告 hiddenFields 支持 saves:服务端会移除计数、覆盖率和测量时间。隐藏 views、likes、comments 或 er 也会移除相关 ER;posts 隐藏覆盖率,lastScanned 隐藏测量时间。规则适用于汇总、行、历史和基准值。
{
"engagement": {
"scope": "accepted_video",
"views": 100,
"likes": 0,
"comments": 0,
"er": 0,
"saves": null,
"erCoverage": { "measuredPosts": 1, "totalPosts": 2 },
"savesCoverage": { "measuredPosts": 0, "totalPosts": 2 },
"updatedAt": "2026-10-09T08:00:00.000Z",
"savesUpdatedAt": null
}
}更新 MCP
@latest 使用 npm 已发布版本,而非 GitHub 分支。若固定了旧版本,改为 @latest,然后停止并重启 MCP 服务或完整重启 AI 客户端。网站更新不会更新正在运行的 MCP 进程。
npm view @vibevo/mcp version重启后刷新客户端工具列表。标签功能需要 vibevo_list_factory_tags 及 vibevo_patch_factory_account 的 tags 参数(自 0.3.0 起支持)。npm 更新无法获得尚未发布的工具。
代理提示词
连接 MCP 后复制并发送给代理。包含文档、npm 链接及数据操作规则。
这篇文章有帮助吗?
更新日期: 2026-09-23