Virlo Social Media Research Agent MCP

Virlo Agent Plugin

AI エージェントにソーシャルメディアの知能を与えましょう。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 互換のあらゆるエージェント。

Virlo APIを基盤としています。Virloは、あらゆるニッチ分野にわたり、TikTok、YouTube Shorts、Instagram Reels、Meta Adsを対象とするショート動画向けソーシャルインテリジェンスプラットフォームです。

エージェントでできること

• トレンドをいち早く発見： 新たなトレンド、日次トレンドダイジェスト、過去48時間の人気バイラル動画を確認できます
• バイラルの理由を解説： 特定の動画が注目を集めた理由を分析します（フック、形式、サウンド、タイミング）
• あらゆるニッチ分野を調査： トピックに関する人気動画、突出した成果を上げるクリエイター、コンテンツのパターンを見つける調査エージェントを実行します
• ニッチ分野を毎週モニタリング： 定期的に実行する調査エージェントが、人気上昇中のサウンド、ハッシュタグ、クリエイターを見つけます
• クリエイターを検索： プロフィール、突出した成果を上げた動画、オーディエンスの属性と地域、投稿頻度を確認できます
• 流行のサウンドやハッシュタグを検索： 急上昇中の音源、サウンドの使用履歴、ハッシュタグの成長状況を確認できます
• 効果的なフックを活用： 流行のフックや、検索可能なフックライブラリを利用できます
• 長期的に追跡： クリエイターや動画を毎日追跡し、シグナルレポートを確認できます

インストール

スキル（Claude Code、Cursor、Codex、Windsurf、その他のエージェント）

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

このリポジトリには2つのスキルが含まれています。

--skillを使って、いずれか1つだけをインストールできます。

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/により、互換性のあるクライアントであれば、この1つのパッケージから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. クライアントを再起動します。

使い始める

エージェントに次のように尋ねてみてください。

• 「今週、フィットネス分野で 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 をご覧ください。

費用

ほとんどのリサーチツールは、呼び出しごとに課金されます。リサーチエージェントは 1 回の実行につき 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 になるまで待ってください。リサーチエージェントは通常、約 8 分で収集を完了します（10 回中 9 回は 20 分以内に完了します）。

ネットワークと認証情報

このプラグインが通信するエンドポイントは、Virlo の MCP サーバーである https://dev.virlo.ai/api/mcp/mcp のみです。認証には OAuth または指定した VIRLO_API_KEY を使用します（このリクエストの Authorization ヘッダーでのみ送信されます）。その他のネットワーク呼び出し、テレメトリ、ローカルコマンドの実行、ファイルへの書き込みはありません。スキルは公開ソーシャルデータのみを読み取ります。ソーシャルアカウントへの投稿や変更は行いません。

リンク

• Virlo
• MCP のセットアップとツールのリファレンス
• API キー

ライセンス

MIT