omni-social-mcp

Universal Social Media Intelligence MCP Server (TikTok, Instagram, X, YouTube)
4大SNSの急上昇バズ動画・横断キーワード検索・視聴者コメント分析を1回のプロンプトで取得できる Model Context Protocol (MCP) サーバー。

English | 日本語 (Japanese)

🇺🇸 English

⚡ Overview

omni-social-mcp equips AI agents (Gemini, Claude Desktop, Cursor, Cline, Windsurf) with real-time multi-platform social media intelligence.

• 🎯 1-Prompt Multi-Platform Search: Scan TikTok, Instagram, X, and YouTube simultaneously without opening multiple browser tabs.
• 📉 Token Compression: Payload compressed to ~1/100th of raw HTML/JSON, preserving your LLM's context window.
• ⚡ High-Speed Edge Cache: Sub-100ms response time powered by Cloudflare Workers.
• 🆓 Zero Setup Free Tier: 10 free requests per month out of the box (cached top trends, no API key required).

🚀 Quickstart & Setup

No manual installation required. Simply add omni-social-mcp to your favorite AI agent's configuration using npx:

1. Gemini / Antigravity (mcp_config.json)

Add to your project root .agents/mcp_config.json or user config (~/.gemini/antigravity-ide/mcp_config.json):

{
  "mcpServers": {
    "omni-social": {
      "command": "npx",
      "args": ["-y", "omni-social-mcp"],
      "env": {
        "OMNISOCIAL_API_KEY": "osm_live_your_api_key_here"
      }
    }
  }
}

(Leave OMNISOCIAL_API_KEY blank or omit it for the Free Tier)

2. Claude Desktop (claude_desktop_config.json)

Add to %APPDATA%\Claude\claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "omni-social": {
      "command": "npx",
      "args": ["-y", "omni-social-mcp"],
      "env": {
        "OMNISOCIAL_API_KEY": "osm_live_your_api_key_here"
      }
    }
  }
}

3. Cursor (.cursor/mcp.json or Settings > MCP)

Add to .cursor/mcp.json in your workspace:

{
  "mcpServers": {
    "omni-social": {
      "command": "npx -y omni-social-mcp",
      "env": {
        "OMNISOCIAL_API_KEY": "osm_live_your_api_key_here"
      }
    }
  }
}

4. Cline / Roo Code / Windsurf

Add to cline_mcp_settings.json:

{
  "mcpServers": {
    "omni-social": {
      "command": "npx",
      "args": ["-y", "omni-social-mcp"],
      "env": {
        "OMNISOCIAL_API_KEY": "osm_live_your_api_key_here"
      }
    }
  }
}

🛠️ 3 Powerful MCP Tools

| Tool Name | Description | Key Arguments | | :--- | :--- | :--- | | omni_get_trending | Discover viral topics & top trending videos across 4 major platforms | category (all, tech, business...), geo (JP, US), limit | | omni_search_buzz | Cross-platform keyword search for high-engagement posts | keyword (required), platforms, limit_per_platform | | omni_get_comments | Extract top viewer comments, pain points, and sentiment from a viral video | url (required), limit |

🔑 Portal & API Keys

To get an instant Pro API Key or manage your quota:
👉 OmniSocial Self-Serve Portal

🇯🇵 日本語 (Japanese)

概要

omni-social-mcp は、Claude Desktop、Cursor、Gemini（Google Antigravity）、Cline、Windsurf などの主要な AI エージェントに、4大SNS（TikTok, Instagram, X, YouTube）のリアルタイムトレンド分析能力を提供する MCP サーバーです。

• 4大SNS同時スキャン: 1回のプロンプトで複数SNSの高エンゲージメント投稿を並列収集
• AIトークン1/100圧縮: 不要なメタデータを削ぎ落とし、LLMのコンテキストウィンドウを節約
• 無料枠（Free Tier: 月10回）: APIキー未設定でも、急上昇トレンドのキャッシュデータを即座にお試し可能

🚀 設定方法 (インストール不要)

1. Gemini / Antigravity (mcp_config.json)

プロジェクトルートの .agents/mcp_config.json またはユーザー設定ファイル（~/.gemini/antigravity-ide/mcp_config.json）の mcpServers に以下を追加します：

{
  "mcpServers": {
    "omni-social": {
      "command": "npx",
      "args": ["-y", "omni-social-mcp"],
      "env": {
        "OMNISOCIAL_API_KEY": "osm_live_your_api_key_here"
      }
    }
  }
}

2. Claude Desktop (claude_desktop_config.json)

設定ファイル（Windows: %APPDATA%\Claude\claude_desktop_config.json / macOS: ~/Library/Application Support/Claude/claude_desktop_config.json）の mcpServers に追加：

{
  "mcpServers": {
    "omni-social": {
      "command": "npx",
      "args": ["-y", "omni-social-mcp"],
      "env": {
        "OMNISOCIAL_API_KEY": "osm_live_your_api_key_here"
      }
    }
  }
}

3. Cursor (.cursor/mcp.json または Settings > MCP)

プロジェクトルートの .cursor/mcp.json、または設定画面にて追加：

{
  "mcpServers": {
    "omni-social": {
      "command": "npx -y omni-social-mcp",
      "env": {
        "OMNISOCIAL_API_KEY": "osm_live_your_api_key_here"
      }
    }
  }
}

4. Cline / Roo Code / Windsurf

cline_mcp_settings.json の mcpServers に追加：

{
  "mcpServers": {
    "omni-social": {
      "command": "npx",
      "args": ["-y", "omni-social-mcp"],
      "env": {
        "OMNISOCIAL_API_KEY": "osm_live_your_api_key_here"
      }
    }
  }
}

🛠️ 提供される 3 つの MCP ツール

| ツール名 | 説明 | 主要引数 | | :--- | :--- | :--- | | omni_get_trending | 4大SNSで今まさに急上昇しているバズ動画・話題を一括取得 | category (all, tech, business...), geo (JP, US) | | omni_search_buzz | 指定キーワードで4大SNSを横断検索し、高エンゲージメント投稿を抽出 | keyword (必須), platforms, limit_per_platform | | omni_get_comments | 特定のバズ動画・投稿のコメント上位と視聴者の反響・感情を深掘り分析 | url (必須), limit |

💬 プロンプトの実行例

• トレンド調査:

  「今朝日本でバズっている最新トレンドを教えて」
  ➔ omni_get_trending を自動実行

• SNSマーケティング企画:

  「TikTokとYouTubeで『AI時短術』に関する100万回再生超えの投稿特徴とバズ要因を調べて」
  ➔ omni_search_buzz を自動実行

• ユーザーペイン・反響分析:

  「このTikTok動画のコメント欄を分析して、視聴者がどんな点に不満や疑問を持っているか要約して」
  ➔ omni_get_comments を自動実行

🔑 有料プラン & APIキー発行

有料プラン（Starter: ¥1,980/月、Pro: ¥4,980/月）の即時APIキー発行、およびクオータ管理は以下のセルフサーブポータルをご利用ください：
👉 OmniSocial セルフサーブポータル

📄 License

MIT License © 2026 OmniSocial