viralhunt-mcp

ViralHunt MCP 服务

一个用于 ViralHunt.io 的 MCP 服务——这是一体化平台，可发现热门趋势、与团队共同策划内容，并发布到各处。 它是 BuzzSumo 的替代方案，内置跨平台网络排期工具，并提供可由 AI Agent 全程驱动的 API。

获取免费令牌：https://viralhunt.io/claude → 创建免费账户（永久免费，无需信用卡，每天可查询 24 条内容），然后依次进入 Account → API Access → Create access。每个令牌都有一个权限组（reader、writer、reviewer、publisher、full）：权限组以外的工具会返回 403 insufficient_scope，并指出缺少的权限；viralhunt_account 会向令牌显示其自身的权限组。为负责写作的 Agent 提供 writer 令牌，为负责审核的 Agent 提供 reviewer 令牌。完整 API 文档：**https://viralhunt.io/api**。

Agent 可通过此 MCP 服务执行的操作

以下是此服务提供的工具（可驱动完整的发现 → 定时 → 发布 → 验证 → 修正工作流）。每个数字都附带样本量和时间范围，因此 Agent 可以说明该数字的可信度：

工具	功能
viralhunt_account	这是谁的密钥 — 套餐、每日剩余配额、积分、各端点规则（先调用）
viralhunt_trending	查找话题 — TikTok、Instagram、X、Facebook、Pinterest、Bluesky、Douyin、Reddit、Mastodon、Tumblr、Hacker News 和新闻 RSS 上正在走红的内容，按病毒式传播分数排序；每条帖子都包含 growth_24h（在我们间隔最远的两次读取之间的变化量）；author 可限定为某个页面或账号
viralhunt_search	一个关键词，搜索所有平台 — 合并并排序，同时提供各平台的总数
viralhunt_best_time	何时发布 — 根据在各平台走红的帖子，提供每个平台的最佳星期和时段（365 天样本、命中率、样本量、你的时区，可选细分领域关键词）
viralhunt_top_hashtags	哪些标签 — 按互动量、帖子数或每帖数据，列出各平台或所有平台的热门标签；查看某个标签在各平台的分布
viralhunt_trending_sounds	哪些声音 — TikTok、Instagram Reels 和 Douyin 上的热门音频；优先列出跨平台声音，并附上使用该声音的帖子
viralhunt_best_communities	在哪里发布 — 提供最佳 subreddit（每 1,000 名成员的峰值、发布时间、热门帖子、相似社区）和适用于某个话题的 Bluesky 自定义动态
viralhunt_targets	列出你的品牌/项目以及你可以发布内容的关联账号，并提供 needs_reconnect、各平台的 media_limits 和关联的其他语言项目
viralhunt_schedule	立即发布、安排发布时间或保存为草稿（文本 + 媒体、各平台文案、首条评论，或使用模板的 design，由应用在人员批准后渲染）。返回结果包含 url、drafts_url、project_name：供人员处理的帖子会完整进入草稿箱，并通过一条五行消息交接（ID 和项目、url、角度、验证情况、需要作出的决定）；其余内容放在 author_notes 中
viralhunt_drafts	等待审核和批准的草稿，以及它们的审核结果
viralhunt_review_draft	审核草稿 — 给出判定、评分、各平台警告和备注（作为团队审核员的 Agent）
viralhunt_policy	审核者在批准前应用的内容规则：拦截和修改清单及代码、六项评分和阈值、各平台备注（首次审核及每次审核前都要先阅读）
viralhunt_review_queue	待审核内容：处于审核中且当前内容尚无判定结果的帖子
viralhunt_calendar	值得发布的日期：国际纪念日以及科学/科技/太空/健康领域的周年纪念日，附原因，并可按时间范围和类别筛选
viralhunt_news_categories	新闻类别及其数量；将其中一项作为 category 传给 viralhunt_trending（rss）
viralhunt_review_stats	按周、双周或月查看每位协作者的标记：审核数、通过 / 修改 / 拦截数、规则代码、平均风险值（满分 10）
viralhunt_approve_draft	发送草稿（使用所有者/管理员令牌，并获得用户同意），可选同时发送其译文
viralhunt_translate_post	同一篇帖子换成另一种语言 — 应用会为关联项目调整文案和模板文本
viralhunt_edit_log	从修改中学习 — 查看 Agent 留下草稿后，人员做了哪些修改
viralhunt_get_post	查看帖子的状态和各平台结果、永久链接，以及各平台拒绝发布的具体原因
viralhunt_sync_post	从各平台刷新状态
viralhunt_update_post	编辑草稿（任何内容，包括渲染后的 png）或尚未发布的定时帖子（正文 / 媒体 / 平台 / 时间）
viralhunt_cancel_post	取消定时帖子中尚未发布的平台目标，或删除草稿
viralhunt_stats	哪些内容表现良好 — 按平台、品牌统计已发布帖子的互动情况，并列出热门帖子
viralhunt_quotes / viralhunt_mark_quote_used	每日名言系列的名言库（默认使用公有领域内容，含作者背景和肖像）
viralhunt_recipes / viralhunt_recipe_ran	人员在应用中保存的常规任务：来源、模板、频率；记录一次运行
viralhunt_list_templates	浏览内容模板库（可填入品牌内容的版式；优先显示收藏项）
viralhunt_get_template	获取某个模板的完整规格（html + css + 变量清单、哪些内容是 static 和 dynamic、适用场景 suits、所有者的 instructions），用于渲染
viralhunt_upsert_template	创建或编辑模板 — 编辑精选模板时，会将其克隆到你的副本中（所有者/管理员）
viralhunt_assign_template	将模板分配给项目，供其 Agent 使用（所有者/管理员）
viralhunt_board_context	一次调用即可获取团队的编辑委员会信息：成员（含 ID）、栏目、类别
viralhunt_create_card	将帖子交给队友 — 创建看板卡片（自动填充 URL 元数据、负责人、优先级、截止日期、类别）
viralhunt_move_card	将卡片移动到其他栏目（is_done 栏目会将其标记为完成）
viralhunt_my_cards	分配给你的卡片（令牌属于团队中的 Agent 成员时）
viralhunt_card_comments	阅读或添加卡片评论（会通知负责人，并同步到团队聊天）
内置防护措施：不会发布到错误的品牌账号，只会安排未来的发布，默认保存为草稿，
除非用户要求立即发布；绝不使用其他页面的文本或品牌图片，会检查各网络的媒体限制，
并且会被告知不得转发假新闻、受版权保护的媒体内容或垃圾信息。

更新日志

• 1.1.31 (2026-10-26) — viralhunt_brand_webhook 接受 format（json、discord、slack、auto）和 test: true（向已保存的 webhook 发送一条示例提醒，并返回接收方的响应）。webhook 指南：https://viralhunt.io/webhooks。
• 1.1.30 (2026-10-26) — 对于 SCHEDULED 帖子，viralhunt_update_post 按账号处理：仅当某个账号自己的文案或图片发生变化时才会更新；X/Threads 上发生变化的 thread（新参数）会让对应网络重新发布帖子；新增账号会创建帖子，被移除的账号会删除帖子；响应会列出 patched、recreated、added、removed、refused；距离帖子发布时间不足 6 分钟时无法修改（409 not_editable）。
• 1.1.29 (2026-10-24) — viralhunt_schedule 和 viralhunt_approve_draft 支持 allow_duplicate：重复内容防护会拒绝为某个账号发布相同文案（该账号最近 72 小时内的另一条帖子已使用该文案）；响应会返回 duplicate_of，如果所有账号都存在重复，则返回 409 duplicate_post。如果发送请求中的所有网络都被移除，响应会返回 status: processing 和 checking: true：切勿再次创建。
• 1.1.28 (2026-10-23) — viralhunt_brand_hot 支持 all 和 limit（也包括评论最多的讨论串，按热度升序排列：与应用仪表板列表一致）；响应包含 machine（常驻 Chrome 的心跳状态），因此判断列表为空时，也要结合是否有人在搜索。
• 1.1.27 (2026-10-22) — viralhunt_create_post / viralhunt_update_post 支持 carousel：仅当用户要求创建轮播图时才允许使用多张图片（否则返回 422 multiple_pictures）；png 会替换帖子的图片，而不是添加到现有图片旁；使用模板创建的帖子始终只有一张图片，即渲染结果。
• 1.1.26 (2026-10-20) — viralhunt_targets 返回每个项目对应品牌的 voice（所有者的操作手册：先阅读，并优先遵循它而非通用规则；若为空，则主动提出帮忙起草）；完整的内容意味着在同一次创建请求的 overrides 中提供每个网络（X、Bluesky、Threads）的文案，绝不能遗漏。
• 1.1.25 (2026-10-19) — 每张图片都应使用组织的某个模板（没有合适的模板时先创建一个；传入 PNG 和 design，仅有 PNG 是无法编辑的扁平文件）；viralhunt_schedule 的协作约定：为某人创建的帖子应完整地放入 Drafts，除非对方要求，否则绝不放入 Review；通过一条包含五行内容的消息交接，并附上响应返回的 url；创建操作、草稿行和 get 响应中都包含 url、drafts_url、project_id、project_name。
• 1.1.24 (2026-10-19) — viralhunt_list_posts（按目标查看队列和历史记录）、viralhunt_delete_post（下架某个已发布的目标）、viralhunt_cancel_post 支持 account_id；创建请求超时后重试必须使用 force。
• 1.1.23 (2026-10-18) — 卡片：viralhunt_create_card 支持通过 ID、姓名或电子邮件设置 assigned_to；新增 viralhunt_assign_card、viralhunt_get_card、viralhunt_list_cards、viralhunt_archive_card。草稿行包含 publishes[]（每个账号实际发送的文案）。
• 1.1.22 (2026-10-15) — viralhunt_brand_keywords 支持 run: true（“立即搜索”）；viralhunt_brand_status 包含 machine（常驻机器是否在线）。
• 1.1.21 (2026-10-15) — 品牌监测：viralhunt_brand_status、viralhunt_brand_keywords、viralhunt_brand_hot（当前升温中的讨论，包含链接）、viralhunt_brand_alerts、viralhunt_brand_webhook（向品牌自己的 Agent 发送签名交付）。
• 1.1.20 (2026-10-15) — viralhunt_translate_post 说明返回内容（shortened、overrides，不使用长破折号）以及一个品牌使用两种语言的模式。
• 1.1.19 (2026-10-14) — viralhunt_schedule 支持 stage 和 assigned_to；viralhunt_update_post 支持 assigned_to，并在响应中返回编辑后的阶段；viralhunt_drafts 支持按 assigned_to 筛选；viralhunt_get_post 返回完整的草稿结构（overrides、design、render…）；viralhunt_get_template 支持通过 preview 在创建任何帖子前预览模板；文案过长时会返回 text_too_long，而不是 500。
• 1.1.18 (2026-10-14) — 对于使用模板生成的图片，始终会发送 design（viralhunt_update_draft 也会用它修复仅包含 PNG 的帖子）：这样应用就能编辑图片。
• 1.1.17 (2026-10-14) — viralhunt_trending 支持在所有统计评论数的网络上使用 sort: most_commented（tiktok 新增；facebook 和 pinterest 将其映射为 most_comments，x、bluesky 和 mastodon 将其映射为 most_replied）。
• 1.1.16 (2026-10-13) — viralhunt_upsert_template 支持 action: archive；无论操作是通过请求正文还是 URL 传入，更新都能正常工作；viralhunt_list_templates 支持 scope、per_page、page，并优先列出组织自己的模板。
• 1.1.15 (2026-10-13) — 每份草稿都是 Editorial Board 卡片（创建时返回 card_id），并会随帖子一起移动；更新时使用 design_fields 可修复设计图片中的文本（受信任的审阅者也适用）；没有管理员权限的模板作者也可以创建模板（Team 中的“Creates templates”）；模板绝不包含代码（响应中会显示 removed）。
• 1.1.11 (2026-10-08) — 如果在 Team 中启用了相应选项，成员可以使用自己的令牌批准自己评分的帖子；review_stats 包含 avg_score、self_published、published_over_fix。
• 1.1.10 (2026-10-07) — 审阅者的编辑范围（受信任时仅限 overrides 和 kind）；每个账号都有 text_limit。
• 1.1.9 (2026-10-07) — 创建和更新时支持 kind（fact | meme | quote | opinion | promo）：审阅者只会应用该类型对应的规则。
• 1.1.8 (2026-10-07) — overrides[account] 支持为每个账号设置 first_comment 和 thread；Bluesky/Mastodon 线程采用回复链形式。
• 1.1.7 (2026-10-07) — 创建和更新时支持 author_notes：为审阅者提供来源链接，绝不会发布。
• 1.1.6 (2026-10-07) — 对受信任审阅者的 OK 结果设置安全拦截（risk_threshold）；草稿支持 project_lang；受信任审阅者可查看 review_stats。
• 1.1.5 (2026-10-07) — viralhunt_calendar：日历基础数据（国际纪念日和周年纪念日，附原因说明），以及 mark_used。
• 1.1.4 (2026-10-07) — 新增 viralhunt_news_categories 和 viralhunt_trending 的 category（rss）；API 会将未知参数作为 422 错误返回。
• 1.1.3 (2026-10-07) — 策略说明了各类内容（fact、meme、quote、opinion、promo）：meme 或 quote 不会被要求提供来源或 DOI。
• 1.1.2 (2026-10-06) — viralhunt_review_draft 支持 content_hash（审阅者查看期间帖子发生变化时返回 409 content_changed）；自我审阅按用户而非令牌判定。
• 1.1.1 (2026-10-06) — 审阅者额外执行四项检查（图片与文案是否匹配、拼写、是否由 AI 撰写、事实及 DOI 规则）；每次审阅都会返回 1 到 10 的 risk10；新增 viralhunt_review_stats（按协作者列出标记）。
• 1.1.0 (2026-10-05) — 审阅者工作流程：viralhunt_policy、viralhunt_review_queue、草稿中的 needs_review；服务端会重新计算判定结果，并在 sent.skipped 中注明阻止 OK 结果发送的规则。
• 0.3.0 (2026-09-28) — 草稿和审阅（viralhunt_drafts、viralhunt_review_draft、 viralhunt_approve_draft、viralhunt_edit_log），将内容翻译为关联项目的语言 （viralhunt_translate_post），帖子支持 design、更新支持 png，以及 viralhunt_search、 viralhunt_account、viralhunt_stats、viralhunt_quotes、viralhunt_recipes、viralhunt_sync_post； trending 支持 author 和自由格式的 time_range；targets 支持 media_limits、needs_reconnect 和语言链接；模板会说明哪些内容是静态的、动态的，以及适用场景；帖子状态如实反映每个网络返回的原因。
• 0.2.x (2026-09-08) — 最佳发布时间、热门标签、热门音频、最佳社群、Editorial Board；trending 新增 Reddit、Mastodon、Tumblr 和 Hacker News；记录了 growth_24h。
• 0.1.x (2026-08) — trending、targets、发布/定时发布、获取、更新、取消、内容模板。

ViralHunt 平台的功能（超出此 MCP 的范围）

ViralHunt 是一款完整的产品；上述工具只是可由 Agent 驱动的部分。其余功能位于应用中 （部分功能也可通过 REST API 使用）：

• 趋势雷达 — 按细分领域和时间范围查看实时跨平台热门内容动态。
• 跨平台发布与排期 — 按品牌向最多 11 个平台（Instagram、 Facebook、TikTok、X、LinkedIn、YouTube、Pinterest、Threads、Bluesky、Telegram、Google Business） 安排发布或发布内容。
• 编辑看板（团队） — 发布前用于策划内容的看板：包含列、类别、任务分配、 评论和团队聊天，方便团队管理待发布内容。（卡片／列／评论可通过 REST API 使用。）
• 自动私信（评论 → 私信自动化） — 当有人在 Instagram 上评论你的关键词时，ViralHunt 会自动回复并向其发送私信 — 类似 ManyChat，但采用固定价格、联系人数量不限，并设有每月重置的 上限。在应用中配置（通过 Webhook 运行）；Facebook 即将推出。
• 报告 — 查看各品牌／平台的实际数据：帖子、触达人数、已发送私信、回复和热门内容。

注意：自动私信和报告是产品功能，并非此 MCP 目前提供的工具。编辑看板已开放使用（上下文、卡片、移动、 评论），因此 Agent 可以将内容交给团队处理，而不是直接发布。

安装（Claude Desktop / Cline）

{
  "mcpServers": {
    "viralhunt": {
      "command": "npx",
      "args": ["-y", "viralhunt-mcp"],
      "env": { "VIRALHUNT_API_KEY": "vhk_your_token_here" }
    }
  }
}

配置：VIRALHUNT_API_KEY（你的 vhk_… 令牌，必填）和 VIRALHUNT_BASE_URL（可选，默认使用 生产环境 API）。本地运行：VIRALHUNT_API_KEY=vhk_... npx viralhunt-mcp（Node ≥ 18）。

已列入 Official MCP Registry，名称为 io.github.rodvan/viralhunt-mcp。许可证：MIT。