viralhunt-mcp

ViralHunt MCP サーバー

ViralHunt.io 用の MCP サーバーです。トレンドを発見し、チームでキュレーションして、あらゆる場所に公開できるオールインワンプラットフォームです。BuzzSumo の代替として、クロスネットワークのスケジューラーを内蔵し、AI エージェントがエンドツーエンドで操作できる API を備えています。

無料トークンを取得するには、https://viralhunt.io/claude → 無料アカウントを作成します（永久無料、クレジットカード不要、1 日あたり 24 件のコンテンツクエリ）。次に、「Account → API Access → Create access」に進みます。各トークンには権限グループ（reader、writer、reviewer、publisher、full）が設定されています。グループ外のツールを使うと、不足している権限を示す 403 insufficient_scope が返されます。また、viralhunt_account では、トークン自身のグループを確認できます。書き込みを行うエージェントには writer トークンを、レビューを行うエージェントには reviewer トークンを付与してください。API ドキュメント全文：**https://viralhunt.io/api**。

エージェントがこの MCP サーバーを通じてできること

このサーバーが公開するツールは、発見 → タイミング設定 → 公開 → 検証 → 修正という一連の流れを実行します。すべての数値にはサンプル数と対象期間が付いているため、エージェントは信頼度を示すことができます。

ツール	内容
viralhunt_account	このキーの情報 — プラン、残りの1日あたりの上限、クレジット、エンドポイントごとのルール（最初に呼び出してください）
viralhunt_trending	話題を見つける — TikTok、Instagram、X、Facebook、Pinterest、Bluesky、Douyin、Reddit、Mastodon、Tumblr、Hacker News、ニュース RSS で何が話題になっているかをバイラルスコア順に表示します。各投稿には growth_24h（最も離れた2回の計測の間にどれだけ伸びたか）が含まれます。author を指定すると、1つのページまたはアカウントに絞り込めます
viralhunt_search	1つのキーワードで、すべてのネットワークを検索 — ネットワークごとの件数とともに統合してランキング表示します
viralhunt_best_time	投稿するタイミング — 各ネットワークで話題になった投稿から算出した、最適な曜日と時間帯（365日分のサンプル、的中率、サンプル数、タイムゾーン、任意のニッチなキーワード）
viralhunt_top_hashtags	ハッシュタグを調べる — ネットワークごと、または全体の上位タグを、エンゲージメント、投稿数、または投稿あたりの数で表示します。1つのタグについてネットワークごとの内訳も確認できます
viralhunt_trending_sounds	音源を調べる — TikTok、Instagram Reels、Douyin で話題の音声を、まずネットワークをまたいで使われている音源から表示し、それを使った投稿も確認できます
viralhunt_best_communities	投稿先を探す — サブレディット（メンバー1,000人あたりのピーク、タイミング、上位投稿、類似コミュニティ）と、トピックに合った Bluesky のカスタムフィードを表示します
viralhunt_targets	投稿できるブランド／プロジェクトと接続済みアカウントの一覧を表示します。needs_reconnect、ネットワークごとの media_limits、別の言語でリンクされたプロジェクトも含まれます
viralhunt_schedule	今すぐ公開、予約、または下書きとして保存（テキスト＋メディア、ネットワークごとの文面、最初のコメント、または人が承認したときにアプリがレンダリングするテンプレート上の design）。応答には url、drafts_url、project_name が含まれます。人の確認が必要な投稿は「下書き」に保存され、5行のメッセージ（ID とプロジェクト、url、切り口、確認状況、必要な判断）にまとめて引き渡されます。それ以外の情報は author_notes に含まれます
viralhunt_drafts	レビューと承認を待っている下書きと、そのレビューを表示します
viralhunt_review_draft	下書きをレビューする — 判定、スコア、ネットワークごとの警告、メモを返します（エージェントがチームのチェック担当として使用）
viralhunt_policy	レビュアーが承認する前に適用するコンテンツルール — ブロック対象と修正対象の一覧（コード付き）、6つのスコアとしきい値、ネットワークごとの注意事項（毎回のレビュー前に必ず読んでください）
viralhunt_review_queue	レビューが必要なもの：現在の内容に判定が付いていない「レビュー」中の投稿
viralhunt_calendar	投稿に適した日：その理由とともに、国際デーや科学／技術／宇宙／健康に関する記念日を期間とカテゴリ別に表示します
viralhunt_news_categories	ニュースカテゴリと件数を表示します。viralhunt_trending（rss）に category として指定できます
viralhunt_review_stats	週、2週間、または月ごとの共同作業者別のフラグ：レビュー数、承認／修正／ブロック、ルールコード、平均 risk10
viralhunt_approve_draft	下書きを送信する（オーナー／管理者トークンとユーザーの承認が必要）。翻訳も任意で送信できます
viralhunt_translate_post	同じ投稿を別の言語にする — アプリが、リンクされたプロジェクト向けに文面とテンプレート内のテキストを調整します
viralhunt_edit_log	編集内容から学ぶ — エージェントが下書きを作成した後に、人が変更した内容を確認します
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	1つのテンプレートの完全な仕様（html＋css＋変数マニフェスト、static と dynamic の区別、suits の内容、オーナーの instructions）を取得してレンダリングします
viralhunt_upsert_template	テンプレートを作成または編集する — キュレーション済みのテンプレートを編集すると、自分用のコピーが作成されます（オーナー／管理者）
viralhunt_assign_template	プロジェクトにテンプレートを割り当て、そのエージェントが使えるようにします（オーナー／管理者）
viralhunt_board_context	チームの編集ボードの情報を1回の呼び出しで取得します：メンバー（ID付き）、列、カテゴリ
viralhunt_create_card	投稿をチームメイトに引き継ぐ — カンバンカードを作成します（URL のメタデータを自動入力、担当者、優先度、期限、カテゴリ）
viralhunt_move_card	カードを別の列に移動します（is_done 列に移動すると完了します）
viralhunt_my_cards	自分に割り当てられたカードを表示します（トークンがチームのエージェントメンバーに属している場合）
viralhunt_card_comments	カードのコメントを読み取るか追加します（担当者に通知し、チームチャットにも反映します）
ガードレールを組み込み済みです。間違ったブランドには投稿せず、予約は常に未来の日時に設定し、ユーザーが今すぐ公開するよう依頼した場合を除いて、デフォルトでは下書きを作成します。他のページのテキストやブランド画像は決して使用せず、各ネットワークのメディア上限を確認し、フェイクニュース／著作権で保護されたメディア／スパムを再投稿しないよう指示されています。

変更履歴

• 1.1.31 (2026-10-26) — viralhunt_brand_webhook は format（json、discord、slack、auto）と test: true（保存済みの Webhook にサンプルアラートを 1 件送信し、受信側の応答内容も返します）を受け付けます。Webhooks ガイド：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.1.26 (2026-10-20) — viralhunt_targets のすべてのプロジェクトにブランドの voice が含まれるようになりました（オーナーの運用ガイドです。まず読み、一般的なルールより優先して従ってください。空の場合は、作成を提案してください）。完全な投稿とは、切り詰められていない、同じ作成リクエスト内の overrides に含まれるすべてのネットワーク（X、Bluesky、Threads）向けの文面を指します。
• 1.1.25 (2026-10-19) — 組織のテンプレートのいずれかを使ってすべての画像を作成します（合うテンプレートがなければ作成します。PNG と design を渡してください。PNG だけでは、編集できないフラットファイルになってしまいます）。viralhunt_schedule の連携手順：担当者向けの投稿は、完全な状態で下書きに保存します。依頼がない限り Review には送信しません。応答で返される url を添えて、5 行のメッセージ 1 通で引き渡します。作成、下書き一覧、取得の応答に 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 で assigned_to に ID、名前、メールアドレスを指定できるようになりました。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（ブランド独自のエージェントへの署名付き配信）。
• 1.1.20 (2026-10-15) — viralhunt_translate_post で、返される内容（shortened、overrides、em ダッシュを使用しないこと）と、1 つのブランドを 2 言語で運用するパターンを説明するようになりました。
• 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 など）が含まれるようになりました。preview を指定した viralhunt_get_template で、投稿を作成する前にテンプレートを確認できます。テキストが長すぎる場合は、500 ではなく text_too_long が返されます。
• 1.1.18 (2026-10-14) — テンプレートで作成した画像には、常に design が送信されます（viralhunt_update_draft で、design を使って 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 の「テンプレートを作成」）。テンプレートにコードが含まれることはなくなり、応答には 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）を追加しました。レビュアーは指定された kind のルールのみを適用します。
• 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) — 信頼されたレビュアーの承認時に安全性チェックを追加しました（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) — レビュアー向けに 4 つの追加チェック（画像とテキストの照合、スペルチェック、AI による記述かどうか、DOI ルールを用いた事実確認）を追加しました。すべてのレビューで risk10（1 から 10）を返し、viralhunt_review_stats で共同作業者ごとのフラグを確認できます。
• 1.1.0 (2026-10-05) — レビュアー向け機能：viralhunt_policy、viralhunt_review_queue、下書きの needs_review。サーバーが判定を再計算し、OK 判定でも送信されなかった場合は、sent.skipped に送信を止めたルール名が表示されます。
• 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； トレンド検索の author と自由形式の time_range；ターゲットの media_limits、needs_reconnect、言語リンク； テンプレートには、固定要素、動的要素、適した用途を記載；各ネットワークの理由を含む、正確な投稿ステータス。
• 0.2.x (2026-09-08) — 最適な投稿時刻、人気のハッシュタグ、トレンドのサウンド、人気のコミュニティ、エディトリアルボード； トレンド検索で Reddit、Mastodon、Tumblr、Hacker News に対応；growth_24h を文書化。
• 0.1.x (2026-08) — トレンド、ターゲット、公開／予約投稿、取得、更新、キャンセル、コンテンツテンプレート。

ViralHunt プラットフォームが提供する機能（この MCP の範囲を超えるもの）

ViralHunt はフル機能の製品です。上記のツールは、エージェントから操作できる機能の一部です。それ以外の機能はアプリ内で利用できます （一部は REST API 経由でも利用できます）。

• トレンドレーダー — ニッチと期間を指定して、複数のネットワークで話題のコンテンツをリアルタイムで表示します。
• 複数ネットワークへの公開とスケジュール設定 — ブランドごとに、最大 11 のネットワーク（Instagram、 Facebook、TikTok、X、LinkedIn、YouTube、Pinterest、Threads、Bluesky、Telegram、Google Business）への投稿を予約・公開できます。
• 編集ボード（チーム） — 公開前にコンテンツを整理するカンバンです。チームで公開内容を管理できるよう、列、カテゴリ、担当者の割り当て、 コメント、チームチャットを備えています。（カード／列／コメントは REST API で利用できます。）
• 自動 DM（コメント → DM の自動化） — Instagram で誰かが指定したキーワードをコメントすると、ViralHunt が自動で返信し、DM を送信します。ManyChat のような機能ですが、定額料金、連絡先数無制限、毎月リセットされる上限が特徴です。アプリで設定します（Webhook 経由で動作します）。Facebook は今後対応予定です。
• レポート — ブランド／ネットワークごとの実績を確認できます。投稿、リーチ、送信した DM、返信、人気コンテンツなどを表示します。

注：自動 DM とレポートは製品の機能であり、現時点でこの MCP が公開しているツールではありません。編集ボード（コンテキスト、カード、移動、コメント）は利用できるため、エージェントはコンテンツを直接公開する代わりに、チームへ引き渡せます。

インストール（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）。

公式 MCP レジストリには io.github.rodvan/viralhunt-mcp として登録されています。ライセンス：MIT。