Sociavault について
Sociavaultは、SociaVault APIを通じてソーシャルメディアや広告データを検索するMCPサーバーです。複数のソーシャルプラットフォームで、プロフィール、投稿、コメント、文字起こし、検索、トレンド、広告ライブラリを読み取り専用ツールで扱えます。
主な機能
- 01ソーシャルプラットフォーム向けの読み取り専用ツール107種
- 02プロフィール、投稿、コメント、文字起こし
- 03検索とトレンドデータ
- 04広告ライブラリ検索
- 05レスポンスの簡略化とページネーション
活用シーン
- 01広告ライブラリを横断した競合広告の調査
- 02ソーシャルアカウントの投稿やコメントの確認
- 03トレンドコンテンツや投稿への言及の検索
- 04分析用の動画文字起こしの取得
MCP 対応
stdio経由でSociaVault APIの機能をツールとしてMCPクライアントに公開します。`npx -y sociavault-mcp`で起動でき、`SOCIAVAULT_API_KEY`が必要です。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
npx -y sociavault-mcpSOCIAVAULT_API_KEYシークレットYour SociaVault API key (format sk_live_...). Get one at https://sociavault.com/dashboardSOCIAVAULT_BASE_URLOptional override for the API base URL. Defaults to https://api.sociavault.comローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
107掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| handle | string | はい | @ を付けない TikTok ユーザー名(例:'charlidamelio')。 |
詳細
SociaVault MCP サーバー
AI アシスタントからソーシャルメディアデータにリアルタイムでアクセスできます。この Model Context Protocol サーバーを使うと、Claude、Cursor、Cline、VS Code、およびMCPに対応するあらゆるクライアントから、自然言語で11のプラットフォームのリアルタイムデータ(プロフィール、投稿、コメント、文字起こし、検索、トレンド、広告ライブラリ)を取得できます。
SociaVault を利用 — 開発者向けの信頼性の高いソーシャルメディアデータAPIです。
特長
- 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_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_profile, linkedin_company, linkedin_post
LinkedIn Ad Library
linkedin_ad_library_search, linkedin_ad_library_ad_details
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_search, google_ad_library_company_ads, google_ad_library_ad_details, google_ad_library_search_advertisers
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_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つ追加するだけです。サーバーが各エントリーを自動的に登録します。
リンク
- ウェブサイト: sociavault.com
- API ドキュメント: docs.sociavault.com
- サポート: [email protected]
ライセンス
MIT — LICENSEを参照してください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。