Sociavault

SociaVault MCP 服务

让 AI 助手实时访问社交媒体数据。这个 Model Context Protocol 服务允许 Claude、Cursor、Cline、VS Code 及任何兼容 MCP 的客户端通过自然语言从 11 个平台获取实时数据，包括个人资料、帖子、评论、文字稿、搜索结果、趋势和广告库。

由 SociaVault 提供支持——面向开发者的可靠社交媒体数据 API。

亮点

• 107 个工具，覆盖 TikTok、Instagram、YouTube、Twitter/X、LinkedIn、Facebook、Reddit、Threads、Pinterest、Twitch 和 Google。
• 广告库覆盖范围——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 条视频。”
• “在 Meta 广告库中搜索 Nike 在美国投放的有效广告。”
• “获取这条 YouTube 视频的文字稿：。”
• “此刻美国 TikTok 上有什么热门趋势？”
• “查找使用此音频 ID 的 Instagram Reels，并总结表现最佳的内容。”
• “在 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 广告库

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 广告库

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 广告库

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 中添加一条条目 — 服务会自动注册每条条目。

链接

• 网站：sociavault.com
• API 文档：docs.sociavault.com
• 支持：[email protected]

许可证

MIT — 详见 LICENSE。