Sociavault

Servidor Model Context Protocol (MCP) para SociaVault — consulte TikTok, Instagram, YouTube, Twitter/X, LinkedIn, Facebook, Reddit, Threads, Pinterest, Twitch, TikTok Shop e bibliotecas de anúncios de qualquer assistente de IA.

GitHub

Experimente este MCPPatrocinado

Documentação

Servidor MCP SociaVault

Dê ao seu assistente de IA acesso ao vivo a dados de mídias sociais. Este servidor Model Context Protocol permite que Claude, Cursor, Cline, VS Code e qualquer cliente compatível com MCP obtenham dados em tempo real de 11 plataformas — perfis, postagens, comentários, transcrições, busca, tendências e bibliotecas de anúncios — por meio de linguagem natural.

Desenvolvido pela SociaVault — uma API confiável de dados de mídias sociais para desenvolvedores.

Destaques

107 ferramentas em TikTok, Instagram, YouTube, Twitter/X, LinkedIn, Facebook, Reddit, Threads, Pinterest, Twitch e Google.
Cobertura de biblioteca de anúncios — bibliotecas de anúncios do TikTok, Meta (Facebook/Instagram), Google e LinkedIn para pesquisa de concorrentes.
Instalação zero — executa via npx, sem necessidade de instalação global.
Eficiente em tokens — as respostas são reduzidas por padrão para manter sua janela de contexto enxuta.
Construído no SDK MCP moderno (1.x) com entradas tipadas, saída estruturada e mensagens de erro claras.

Início rápido

1. Obtenha uma chave de API

Cadastre-se em sociavault.com — novas contas recebem créditos gratuitos para começar. Copie sua chave (formato sk_live_…) do painel.

2. Adicione o servidor ao seu cliente

O servidor executa com npx, então não há nada para instalar. Basta adicionar a configuração abaixo e definir sua chave de API.

Claude Desktop

Edite seu arquivo de configuração:

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"
      }
    }
  }
}

Reinicie o Claude Desktop.

Cursor

Adicione a ~/.cursor/mcp.json (global) ou .cursor/mcp.json (por projeto):

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

VS Code (Copilot)

Adicione a .vscode/mcp.json:

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

Cline / outros clientes

Qualquer cliente que suporte servidores MCP stdio funciona — aponte para o comando npx -y sociavault-mcp com SOCIAVAULT_API_KEY no ambiente.

Configuração

Variável de ambiente	Obrigatória	Descrição
`SOCIAVAULT_API_KEY`	Sim	Sua chave de API do SociaVault (`sk_live_…`).
`SOCIAVAULT_BASE_URL`	Não	Substitui a URL base da API. O padrão é `https://api.sociavault.com`.

Exemplos de uso

Depois de configurado, peça ao seu assistente coisas como:

"Obtenha o perfil do TikTok e os últimos 20 vídeos de @charlidamelio."
"Pesquise na Biblioteca de Anúncios da Meta por anúncios ativos da Nike nos EUA."
"Obtenha a transcrição deste vídeo do YouTube: ."
"O que está em alta no TikTok nos EUA agora?"
"Encontre reels do Instagram usando este ID de áudio e resuma os melhores desempenhos."
"Pesquise no Reddit por menções ao meu produto na última semana."
"Obtenha os comentários deste tweet e resuma o sentimento."

Ferramentas

Todas as ferramentas são somente leitura. A maioria aceita um sinalizador trim (padrão true) que retorna uma carga útil menor e amigável para IA; defina trim: false para a resposta bruta completa. Os endpoints de lista aceitam um cursor de paginação retornado na resposta anterior.

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

Biblioteca de Anúncios do 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_profile, linkedin_company, linkedin_post

Biblioteca de Anúncios do 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

Biblioteca de Anúncios do Facebook

facebook_ad_library_ad_details, facebook_ad_library_search, facebook_ad_library_company_ads, facebook_ad_library_search_companies

Marketplace do Facebook

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

Conta

check_credits — verifique seu saldo de créditos restante.

Preços

O servidor MCP é gratuito e de código aberto. Você paga apenas pelo uso da API SociaVault que ele faz, cobrado como créditos (cada chamada de API custa créditos dependendo do endpoint).

Grátis — créditos incluídos no cadastro, sem necessidade de cartão.
Pacotes de créditos — Starter ($29), Growth ($79), Pro ($199) e Enterprise ($399), cada um concedendo um pacote maior de créditos.

Os créditos não expiram em um ciclo mensal — você compra um pacote e o consome. Veja os pacotes atuais e os valores de crédito em sociavault.com/pricing e verifique seu saldo a qualquer momento com a ferramenta check_credits.

Solução de problemas

"SOCIAVAULT_API_KEY ausente" — Adicione sua chave ao bloco env da configuração MCP e reinicie o cliente.

"Falha na autenticação (401)" — Sua chave está incorreta ou expirada, ou não está no formato sk_live_…. Gere uma nova no painel.

"Sem créditos (402)" — Recarregue em sociavault.com/pricing.

"Não encontrado (404)" — O identificador/URL está errado, ou a conta/conteúdo é privado ou excluído.

O servidor não aparece — Certifique-se de que o Node.js 18+ esteja instalado e no seu PATH, confirme se a configuração JSON é válida e reinicie completamente o cliente. A maioria dos clientes tem um painel de log MCP que mostra erros de inicialização.

Desenvolvimento

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

Adicionar um novo endpoint é uma única entrada em src/endpoints.ts — o servidor registra cada entrada automaticamente.

Licença

MIT — veja LICENSE.