JinDaGe - sociavault-mcp MCP Details

article

README

🚀 SociaVault MCP Server

在Claude Desktop、Cline或任何支持MCP的AI客户端中直接查询社交媒体数据。

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

🚀 快速开始

SociaVault MCP Server 允许你在AI客户端中直接查询社交媒体数据。以下是使用前的准备和配置步骤。

✨ 主要特性

✅ Instagram - 个人资料、帖子
✅ TikTok - 个人资料、视频
✅ Twitter/X - 个人资料、推文
✅ Threads - 个人资料、帖子
✅ YouTube - 频道
✅ Facebook - 个人资料、页面
✅ Reddit - 子版块、帖子

所有这些都可以通过简单的自然语言命令在你的AI助手直接访问。

📦 安装指南

前提条件

获取你的SociaVault API密钥
在 sociavault.com/signup 注册（提供免费套餐）。
安装软件包
```
npm install -g sociavault-mcp
```

Claude Desktop设置

打开你的Claude Desktop配置文件：
- macOS：~/Library/Application Support/Claude/claude_desktop_config.json
- Windows：%APPDATA%\Claude\claude_desktop_config.json

添加SociaVault MCP服务器：

{
  "mcpServers": {
    "sociavault": {
      "command": "sociavault-mcp",
      "env": {
        "SOCIAVAULT_API_KEY": "your-api-key-here"
      }
    }
  }
}

重启Claude Desktop。

其他MCP客户端

对于Cline、Zed或其他MCP客户端，请参考其文档以添加MCP服务器。

💻 使用示例

配置完成后，你可以向Claude提出自然语言问题，例如：

Instagram

"获取@nike的Instagram个人资料"
"展示@cristiano的最后20条帖子"
"耐克在Instagram上的粉丝数量是多少？"

TikTok

"获取@charlidamelio的TikTok个人资料数据"
"展示@mrbeast的最新视频"
"Charli D'Amelio的TikTok互动量如何？"

Twitter/X

"获取@elonmusk的Twitter个人资料"
"展示@OpenAI的近期推文"
"@OpenAI的粉丝数量是多少？"

Threads

"获取@zuck的Threads个人资料"
"展示@Meta在Threads上的帖子"

YouTube

"获取@MrBeast的YouTube频道数据"
"MrBeast的订阅者数量是多少？"

Facebook

"获取https://facebook.com/nike的Facebook个人资料"
"展示耐克Facebook页面的数据"

"获取r/programming子版块的帖子"
"展示r/technology子版块的热门帖子"

📚 详细文档

可用工具

MCP服务器向AI客户端提供以下工具：

| 工具 | 描述 | |------|-------------| | get_instagram_profile | 获取Instagram个人资料数据（粉丝、简介、帖子数量、认证信息） | | get_instagram_posts | 获取近期Instagram帖子，包含点赞、评论、媒体信息 | | get_tiktok_profile | 获取TikTok个人资料数据（粉丝、点赞、简介、视频数量） | | get_tiktok_videos | 获取近期TikTok视频，包含观看量、点赞、分享信息 | | get_twitter_profile | 获取Twitter/X个人资料数据（粉丝、简介、推文数量） | | get_twitter_tweets | 获取近期推文，包含互动指标 | | get_threads_profile | 获取Threads个人资料数据（粉丝、简介、帖子数量） | | get_threads_posts | 获取近期Threads帖子，包含点赞、回复信息 | | get_youtube_channel | 获取YouTube频道数据（订阅者、视频、描述） | | get_facebook_profile | 获取Facebook个人资料/页面数据（粉丝、点赞、关于信息） | | get_reddit_subreddit | 获取Reddit子版块帖子，包含点赞、评论信息 |

API限制

取决于你的SociaVault计划：

免费套餐：每月1000次请求
专业版：无限制请求
企业版：自定义限制 + 优先支持

在 sociavault.com/dashboard 查看你的使用情况。

定价

此MCP服务器免费且开源。

你只需为SociaVault API使用付费：

免费：$0/月（1000次请求）
专业版：$29/月（无限制）
企业版：自定义定价

查看完整定价请访问 sociavault.com/pricing。

故障排除

"SOCIAVAULT_API_KEY环境变量是必需的"

确保你已将API密钥添加到MCP配置文件中。在 sociavault.com/signup 获取你的密钥。

"身份验证错误：无效的API密钥"

你的API密钥无效或已过期。在 sociavault.com/dashboard 生成新的密钥。

"未找到个人资料"

用户名不存在或账户为私人账户。尝试使用不同的用户名。

服务器未在Claude Desktop中显示

检查配置文件语法是否为有效的JSON。
完全重启Claude Desktop。
检查 ~/Library/Logs/Claude/mcp*.log（macOS）中的日志。

开发

如果你想贡献代码或在本地运行：

# 克隆仓库
git clone https://github.com/olamide-olaniyan/sociavault-mcp.git
cd sociavault-mcp

# 安装依赖
npm install

# 构建
npm run build

# 在本地运行（需要在环境中设置SOCIAVAULT_API_KEY）
export SOCIAVAULT_API_KEY=your-key-here
node dist/index.js

使用场景

对于营销人员：

研究竞争对手的社交媒体策略
查找影响者个人资料和互动率
跟踪跨平台内容表现

对于开发者：

构建社交媒体分析工具
将社交数据集成到你的应用中
原型化社交倾听工具

对于研究人员：

分析社交媒体趋势
研究创作者内容模式
跟踪品牌在各平台的存在情况

对于销售团队：

在社交媒体上研究潜在客户
验证公司的社交存在
查找决策者和影响者

为什么选择SociaVault？

99.9%的正常运行时间 - 比自己抓取数据更可靠
无速率限制 - 专业版计划无限制请求
全平台支持 - 一个API涵盖Instagram、TikTok、Twitter、LinkedIn等
始终可用 - 我们处理平台变更，你无需操心
优秀的文档 - 清晰的示例，快速的支持

了解更多请访问 sociavault.com。

支持

文档：sociavault.com/docs
邮箱：support@sociavault.com

📄 许可证

本项目采用MIT许可证，请参阅 LICENSE 文件。

由 SociaVault 团队用心打造

获取你的API密钥 → sociavault.com/signup

sociavault-mcp