Sociavault

Servidor del Protocolo de Contexto del Modelo (MCP) para SociaVault: consulta TikTok, Instagram, YouTube, Twitter/X, LinkedIn, Facebook, Reddit, Threads, Pinterest, Twitch, TikTok Shop y bibliotecas de anuncios desde cualquier asistente de IA.

GitHub

Prueba este MCPPatrocinado

Documentación

Servidor MCP de SociaVault

Dale a tu asistente de IA acceso en vivo a datos de redes sociales. Este servidor de Model Context Protocol permite a Claude, Cursor, Cline, VS Code y cualquier cliente compatible con MCP obtener datos en tiempo real de 11 plataformas — perfiles, publicaciones, comentarios, transcripciones, búsquedas, tendencias y bibliotecas de anuncios — mediante lenguaje natural.

Desarrollado por SociaVault — una API confiable de datos de redes sociales para desarrolladores.

Características destacadas

107 herramientas en TikTok, Instagram, YouTube, Twitter/X, LinkedIn, Facebook, Reddit, Threads, Pinterest, Twitch y Google.
Cobertura de bibliotecas de anuncios — bibliotecas de anuncios de TikTok, Meta (Facebook/Instagram), Google y LinkedIn para investigación de competidores.
Sin instalación — se ejecuta mediante npx, no requiere instalación global.
Eficiente en tokens — las respuestas se recortan por defecto para mantener tu ventana de contexto ligera.
Construido sobre el SDK moderno de MCP (1.x) con entradas tipadas, salida estructurada y mensajes de error claros.

Inicio rápido

1. Obtén una clave de API

Regístrate en sociavault.com — las cuentas nuevas reciben créditos gratuitos para comenzar. Copia tu clave (formato sk_live_…) desde el panel de control.

2. Agrega el servidor a tu cliente

El servidor se ejecuta con npx, así que no hay nada que instalar. Solo agrega la configuración a continuación y establece tu clave de API.

Claude Desktop

Edita tu archivo de configuración:

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

Reinicia Claude Desktop.

Cursor

Agrega a ~/.cursor/mcp.json (global) o .cursor/mcp.json (por proyecto):

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

VS Code (Copilot)

Agrega a .vscode/mcp.json:

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

Cline / otros clientes

Cualquier cliente que admita servidores MCP stdio funciona — apúntalo al comando npx -y sociavault-mcp con SOCIAVAULT_API_KEY en el entorno.

Configuración

Variable de entorno	Requerida	Descripción
`SOCIAVAULT_API_KEY`	Sí	Tu clave de API de SociaVault (`sk_live_…`).
`SOCIAVAULT_BASE_URL`	No	Sobrescribe la URL base de la API. El valor predeterminado es `https://api.sociavault.com`.

Ejemplos de uso

Una vez configurado, pídele a tu asistente cosas como:

"Obtén el perfil de TikTok y los últimos 20 videos de @charlidamelio."
"Busca en la biblioteca de anuncios de Meta anuncios activos de Nike en EE. UU."
"Extrae la transcripción de este video de YouTube: ."
"¿Qué está en tendencia en TikTok en EE. UU. ahora mismo?"
"Encuentra reels de Instagram usando este ID de audio y resume los de mejor rendimiento."
"Busca en Reddit menciones de mi producto en la última semana."
"Obtén los comentarios de este tweet y resume el sentimiento."

Herramientas

Todas las herramientas son de solo lectura. La mayoría acepta un indicador trim (predeterminado true) que devuelve una carga útil más pequeña y amigable para IA; establece trim: false para la respuesta cruda completa. Los endpoints de listas aceptan un cursor de paginación devuelto en la respuesta 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 anuncios de 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 anuncios de 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 anuncios de 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_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

Cuenta

check_credits — consulta tu saldo de créditos restante.

Precios

El servidor MCP es gratuito y de código abierto. Solo pagas por el uso de la API de SociaVault que genera, facturado como créditos (cada llamada a la API cuesta créditos según el endpoint).

Gratis — créditos incluidos al registrarte, sin necesidad de tarjeta.
Paquetes de créditos — Starter ($29), Growth ($79), Pro ($199) y Enterprise ($399), cada uno otorga un paquete mayor de créditos.

Los créditos no expiran en un ciclo mensual — compras un paquete y lo consumes. Consulta los paquetes actuales y los montos de créditos en sociavault.com/pricing, y verifica tu saldo en cualquier momento con la herramienta check_credits.

Solución de problemas

"Falta SOCIAVAULT_API_KEY" — Agrega tu clave al bloque env de la configuración de MCP y reinicia el cliente.

"Error de autenticación (401)" — Tu clave es incorrecta o expiró, o no está en el formato sk_live_…. Genera una nueva en el panel de control.

"Sin créditos (402)" — Recarga en sociavault.com/pricing.

"No encontrado (404)" — El usuario/URL es incorrecto, o la cuenta/contenido es privado o fue eliminado.

El servidor no aparece — Asegúrate de que Node.js 18+ esté instalado y en tu PATH, confirma que la configuración JSON sea válida y reinicia completamente el cliente. La mayoría de los clientes tienen un panel de registro de MCP que muestra errores de inicio.

Desarrollo

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

Agregar un nuevo endpoint es una sola entrada en src/endpoints.ts — el servidor registra cada entrada automáticamente.

Enlaces

Sitio web: sociavault.com
Documentación de la API: docs.sociavault.com
Soporte: support@sociavault.com

Licencia

MIT — consulta LICENSE.