mcpField
S
Sociavault

Sociavault

ローカル
sociavault.comソーシャルメディア112 週間前に更新

Sociavault について

Sociavaultは、SociaVault APIを通じてソーシャルメディアや広告データを検索するMCPサーバーです。複数のソーシャルプラットフォームで、プロフィール、投稿、コメント、文字起こし、検索、トレンド、広告ライブラリを読み取り専用ツールで扱えます。

主な機能

  1. 01ソーシャルプラットフォーム向けの読み取り専用ツール107種
  2. 02プロフィール、投稿、コメント、文字起こし
  3. 03検索とトレンドデータ
  4. 04広告ライブラリ検索
  5. 05レスポンスの簡略化とページネーション

活用シーン

  1. 01広告ライブラリを横断した競合広告の調査
  2. 02ソーシャルアカウントの投稿やコメントの確認
  3. 03トレンドコンテンツや投稿への言及の検索
  4. 04分析用の動画文字起こしの取得

MCP 対応

stdio経由でSociaVault APIの機能をツールとしてMCPクライアントに公開します。`npx -y sociavault-mcp`で起動でき、`SOCIAVAULT_API_KEY`が必要です。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"sociavault": {
"command": "npx",
"args": [
"-y",
"sociavault-mcp"
],
"env": {
"SOCIAVAULT_API_KEY": "<SOCIAVAULT_API_KEY>",
"SOCIAVAULT_BASE_URL": "<SOCIAVAULT_BASE_URL>"
}
}
}
}
起動コマンドnpx -y sociavault-mcp
設定が必要な環境変数
SOCIAVAULT_API_KEYシークレットYour SociaVault API key (format sk_live_...). Get one at https://sociavault.com/dashboard
SOCIAVAULT_BASE_URLOptional override for the API base URL. Defaults to https://api.sociavault.com

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmsociavault-mcp2.0.0

ツール

107

掲載時のツール一覧 · 2 週間前に更新

パラメーター型必須説明
handlestringはい@ を付けない TikTok ユーザー名(例:'charlidamelio')。

詳細

SociaVault MCP サーバー

AI アシスタントからソーシャルメディアデータにリアルタイムでアクセスできます。この Model Context Protocol サーバーを使うと、Claude、Cursor、Cline、VS Code、およびMCPに対応するあらゆるクライアントから、自然言語で11のプラットフォームのリアルタイムデータ(プロフィール、投稿、コメント、文字起こし、検索、トレンド、広告ライブラリ)を取得できます。

SociaVault を利用 — 開発者向けの信頼性の高いソーシャルメディアデータAPIです。

npm version

SociaVault Server MCP server

特長

  • TikTok、Instagram、YouTube、Twitter/X、LinkedIn、Facebook、Reddit、Threads、Pinterest、Twitch、Googleにわたる107のツール。
  • 広告ライブラリに対応 — 競合調査に使えるTikTok、Meta(Facebook/Instagram)、Google、LinkedInの広告ライブラリ。
  • インストール不要 — npx で実行でき、グローバルインストールは不要です。
  • トークン効率に優れています — デフォルトでレスポンスを短縮し、コンテキストウィンドウを節約します。
  • 型付き入力、構造化出力、明確なエラーメッセージを備えた最新のMCP SDK(1.x)を基盤にしています。

クイックスタート

1. APIキーを取得する

sociavault.com で登録してください。新しいアカウントには、すぐに使える無料クレジットが付与されます。ダッシュボードからキー(形式:sk_live_…)をコピーしてください。

2. クライアントにサーバーを追加する

サーバーは npx で実行するため、インストールは不要です。以下の設定を追加し、APIキーを設定してください。

Claude Desktop

設定ファイルを編集します。

  • macOS:~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows:%APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "sociavault": {
      "command": "npx",
      "args": ["-y", "sociavault-mcp"],
      "env": {
        "SOCIAVAULT_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Claude Desktopを再起動します。

Cursor

~/.cursor/mcp.json(グローバル)または .cursor/mcp.json(プロジェクトごと)に追加します。

{
  "mcpServers": {
    "sociavault": {
      "command": "npx",
      "args": ["-y", "sociavault-mcp"],
      "env": { "SOCIAVAULT_API_KEY": "sk_live_your_key_here" }
    }
  }
}
VS Code(Copilot)

.vscode/mcp.json に追加します。

{
  "servers": {
    "sociavault": {
      "command": "npx",
      "args": ["-y", "sociavault-mcp"],
      "env": { "SOCIAVAULT_API_KEY": "sk_live_your_key_here" }
    }
  }
}
Cline/その他のクライアント

stdio MCP サーバーに対応するクライアントであれば使用できます。コマンド npx -y sociavault-mcp を指定し、環境変数に SOCIAVAULT_API_KEY を設定してください。

設定

環境変数必須説明
SOCIAVAULT_API_KEYはいSociaVault APIキー(sk_live_…)。
SOCIAVAULT_BASE_URLいいえAPIのベースURLを上書きします。デフォルトは https://api.sociavault.com です。

使用例

設定後、アシスタントに次のように尋ねてください。

  • 「@charlidamelio のTikTokプロフィールと直近の動画20件を取得して。」
  • 「米国で配信中のNikeの広告をMeta Ad Libraryで検索して。」
  • 「このYouTube動画の文字起こしを取得して:。」
  • 「今、米国のTikTokでトレンドになっているものは?」
  • 「この音声IDを使用しているInstagramリールを見つけ、人気上位の投稿を要約して。」
  • 「過去1週間に自分の製品が言及された投稿をRedditで検索して。」
  • 「このツイートへのコメントを取得して、感情を要約して。」

ツール

すべてのツールは読み取り専用です。ほとんどのツールは trim フラグ(デフォルトは true)を受け付け、AIで扱いやすい小さなペイロードを返します。完全な未加工レスポンスを取得するには trim: false を設定してください。リストを返すエンドポイントでは、前のレスポンスで返されたページネーションカーソルを指定できます。

TikTok

tiktok_profile, tiktok_demographics, tiktok_videos, tiktok_video_info, tiktok_transcript, tiktok_live, tiktok_comments, tiktok_comment_replies, tiktok_following, tiktok_followers, tiktok_search_users, tiktok_search_hashtag, tiktok_search_keyword, tiktok_search_music, tiktok_search_top, tiktok_music_popular, tiktok_music_details, tiktok_music_videos, tiktok_trending, tiktok_creators_popular, tiktok_videos_popular, tiktok_hashtags_popular

TikTok Shop

tiktok_shop_products, tiktok_shop_product_details, tiktok_shop_search, tiktok_shop_product_reviews

TikTok Ad Library

tiktok_ad_library_search, tiktok_ad_library_ad

Instagram

instagram_profile, instagram_posts, instagram_post_info, instagram_transcript, instagram_comments, instagram_reels, instagram_highlights, instagram_highlight_detail, instagram_reels_by_song

YouTube

youtube_channel, youtube_channel_videos, youtube_channel_shorts, youtube_video, youtube_video_transcript, youtube_search, youtube_search_hashtag, youtube_video_comments, youtube_video_comment_replies, youtube_shorts_trending, youtube_channel_playlists, youtube_channel_lives, youtube_channel_community_posts

Twitter / X

twitter_profile, twitter_user_tweets, twitter_user_tweets_all, twitter_tweet, twitter_tweet_transcript, twitter_comments, twitter_quotes, twitter_retweets, twitter_search, twitter_followers, twitter_followings, twitter_community, twitter_community_tweets

LinkedIn

linkedin_profile, linkedin_company, linkedin_post

LinkedIn Ad Library

linkedin_ad_library_search, linkedin_ad_library_ad_details

Facebook

facebook_profile, facebook_profile_posts, facebook_comment_replies, facebook_profile_reels, facebook_group_posts, facebook_post, facebook_post_transcript, facebook_post_comments

Facebook Ad Library

facebook_ad_library_ad_details, facebook_ad_library_search, facebook_ad_library_company_ads, facebook_ad_library_search_companies

Facebook Marketplace

facebook_marketplace_location_search, facebook_marketplace_search, facebook_marketplace_item

Google

google_search, google_ad_library_company_ads, google_ad_library_ad_details, google_ad_library_search_advertisers

Reddit

reddit_subreddit_details, reddit_subreddit, reddit_subreddit_search, reddit_post_comments, reddit_post_transcript, reddit_search

Threads

threads_profile, threads_user_posts, threads_post, threads_search, threads_search_users

Pinterest

pinterest_search, pinterest_pin, pinterest_user_boards, pinterest_board

Twitch

twitch_profile, twitch_user_videos, twitch_user_schedule, twitch_clip

アカウント

check_credits — 残りのクレジット残高を確認します。

料金

MCP サーバーは無料でオープンソースです。料金が発生するのは、使用した SociaVault API の分のみで、クレジットとして請求されます(API 呼び出しごとに、エンドポイントに応じたクレジットが必要です)。

  • 無料 — 登録時にクレジットが付与され、カードの登録は不要です。
  • クレジットパック — Starter($29)、Growth($79)、Pro($199)、Enterprise($399)があり、プランごとに付与されるクレジット数が増えます。

クレジットは月ごとに失効しません。パックを購入し、そこから使用できます。現在のパックとクレジット数は sociavault.com/pricingで確認できます。また、check_credits ツールでいつでも残高を確認できます。

トラブルシューティング

「Missing SOCIAVAULT_API_KEY」 — MCP の設定のenvブロックにキーを追加し、クライアントを再起動してください。

「Authentication failed (401)」 — キーが間違っているか、有効期限が切れているか、sk_live_…形式ではありません。ダッシュボードで新しいキーを生成してください。

「Out of credits (402)」 — sociavault.com/pricingでクレジットを追加してください。

「Not found (404)」 — ハンドルまたは URL が間違っているか、アカウントまたはコンテンツが非公開になっているか、削除されています。

サーバーが表示されない — Node.js 18 以降がインストールされ、PATH に設定されていることを確認してください。JSON 設定が有効であることを確かめ、クライアントを完全に再起動してください。ほとんどのクライアントには、起動時のエラーを表示する MCP ログパネルがあります。

開発

git clone https://github.com/olamide-olaniyan/sociavault-mcp.git
cd sociavault-mcp
npm install
npm run build

# Run locally
SOCIAVAULT_API_KEY=sk_live_your_key node dist/index.js

新しいエンドポイントの追加は、src/endpoints.tsにエントリーを1つ追加するだけです。サーバーが各エントリーを自動的に登録します。

リンク

ライセンス

MIT — LICENSEを参照してください。

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。