AI导哈

社交媒体数据访问服务器

SociaVault MCP Server 是一个允许AI助手实时访问社交媒体数据的服务器，支持从11个平台获取资料、帖子、评论、转录、搜索、趋势和广告库数据。

  • by olamide-olaniyan
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 olamide-olaniyan/sociavault-mcp

使用说明

SociaVault MCP服务器

让你的AI助手实时访问社交媒体数据。这 模型上下文协议 服务器允许Claude、Cursor、Cline、VS Code和任何兼容MCP的客户端通过自然语言从11个平台（配置文件、帖子、评论、成绩单、搜索、趋势和广告库）中提取实时数据。

由...驱动 社会保险库 -为开发者提供可靠的社交媒体数据API。

亮点

  • 107工具 TikTok、Instagram、YouTube、Twitter/X、LinkedIn、Facebook、Reddit、Threads、Pinterest、Twitch和谷歌。
  • 广告库覆盖率 --TikTok、Meta（脸书/Instagram）、谷歌和领英广告库，用于竞争对手研究。
  • 零安装 --运行通过 npx，不需要全局安装。
  • 代币高效 --默认情况下，响应会被修剪，以保持上下文窗口的精简。
  • 基于现代MCP SDK构建 （1.x）具有键入输入、结构化输出和清晰的错误消息。

快速启动

1.获取API密钥

注册地址： 社交保险网 --新帐户可以免费开始。复制密钥（格式 sk_live_…)从 仪表盘.

2.将服务器添加到客户端

服务器运行时 npx，所以没有什么可安装的。只需添加下面的配置并设置您的API密钥。

克劳德桌面

编辑您的配置文件：

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

重新启动克劳德桌面。

光标

添加 ~/.cursor/mcp.json （全球）或 .cursor/mcp.json （每个项目）：

{
  "mcpServers": {
    "sociavault": {
      "command": "npx",
      "args": ["-y", "sociavault-mcp"],
      "env": { "SOCIAVAULT_API_KEY": "sk_live_your_key_here" }
    }
  }
}

VS代码（副本）

添加 .vscode/mcp.json:

{
  "servers": {
    "sociavault": {
      "command": "npx",
      "args": ["-y", "sociavault-mcp"],
      "env": { "SOCIAVAULT_API_KEY": "sk_live_your_key_here" }
    }
  }
}

客户/其他客户

任何支持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广告库中搜索美国耐克的活跃广告。”
  • “拉一下这段YouTube视频的文字记录： ."
  • “TikTok现在在美国有什么趋势？”
  • “使用此音频id查找Instagram影片，并总结表现最佳的影片。”
  • “在Reddit上搜索上周提到我的产品。”
  • “获取这条推文的评论并总结情绪。”

工具

所有工具都是只读的。大多数人接受a trim 标志（默认 true)它返回一个更小、对人工智能友好的有效载荷；集 trim: false 完整的原始回应。列表端点接受上一个响应中返回的分页游标。

试试看。

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_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_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

推特/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广告库

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

facebook_ad_library_ad_details, facebook_ad_library_search, facebook_ad_library_company_ads, facebook_ad_library_search_companies

Facebook 商城

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_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 工具。

故障排除

“缺少SOCIAVAULT_API_KEY” --将您的密钥添加到 env 阻止MCP配置并重新启动客户端。

“身份验证失败（401）” --您的密钥错误或已过期，或者不在 sk_live_… 格式。在中生成一个新的 仪表盘.

“学分不足（402）” --充值至 sociavault.com/pricing.

“未找到（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 --服务器自动注册每个条目。

链接

许可证

麻省理工学院——见 许可证.

相关 MCP