Skip to main content
Glama
deenesjakoruzh
aryaminus

@aryaminus/socials-mcp

by aryaminus
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

Socials Assistant

npm version GitHub Release License: MIT CI Docker

MCP server + habilidades de agente para creadores de redes sociales. Recoge tus propias analíticas de TikTok, Instagram, Facebook y YouTube en un almacén permanente, recibe resúmenes semanales, revisa guiones, crea kits de medios y redacta propuestas de marca con números reales, todo desde cualquier agente de IA.

Solo APIs oficiales. Sin scraping. Sin riesgo de incumplir los términos del servicio.

Inicio rápido — elige una opción

1. Un solo prompt (la forma más fácil)

Copia el prompt de docs/SETUP-PROMPT.md y pégalo en Claude, ChatGPT, Gemini, Codex, Cursor o cualquier agente compatible con MCP. Despliega el servidor, lo conecta a tu agente, instala las 6 habilidades, te guía por el OAuth de cada plataforma y ejecuta tu primer resumen. Tú solo haces clic en las pantallas de consentimiento; el agente hace el resto.

2. Nube, sin instalación

Deploy to Cloudflare

Después abre https://<your-worker>.workers.dev/setup para ver la lista de comprobación de credenciales. El recorrido completo: docs/GET-STARTED-CLOUD.md.

3. npx

npx @aryaminus/socials-mcp onboard

No instala nada de forma global: muestra un asistente guiado para las credenciales de las plataformas y luego sirve el servidor MCP por stdio/HTTP.

4. Local desde el código fuente

git clone https://github.com/aryaminus/socials-assistant && cd socials-assistant
./setup.sh && node apps/mcp/bin/socials-mcp.js onboard

Related MCP server: socialgpt-mcp

Lo que obtienes

20 herramientas MCP

connect · snapshot · vault query · period compare · top content · audience · digest · media kit · pipeline · outreach log

6 skill **

socials-connect · weekly-digest · script-review · publish-package · brand-outreach · media-kit

Almacén de historial

las plataformas hacen caducar las analíticas; tu almacén SQLite (local) o D1 (nube) no lo hace

Importación de CSV de TikTok

retención, fuentes de tráfico, términos de búsqueda — datos solo de Studio con un solo comando

Propuestas de contacto en modo borrador

números reales de tu almacén; nada se envía sin tu aprobación

Conecta tu agente

Agente

Cómo

Claude.ai / Desktop

Ajustes → Conectores → conector personalizado → pega la URL de MCP

Claude Code

claude mcp add --transport http socials <URL>

Codex

[mcp_servers.socials] url = "<URL>" + codex mcp login socials

Cursor

Ajustes → Servidores MCP → pega la URL

Gemini CLI

bloque mcpServers en ~/.gemini/settings.json

Todo lo demás

agents/README.md

Documentación

Documento

Cuándo consultarlo

docs/SETUP-PROMPT.md

si quieres la vía del prompt único

docs/GET-STARTED-CLOUD.md

desplegar en Cloudflare

docs/onboarding-google.md / meta / tiktok

crear aplicaciones de plataforma para OAuth

docs/CAPABILITIES.md

comprobar qué datos expone cada plataforma

docs/hosting-cloudflare.md

detalles del despliegue manual en la nube

docs/automation.md

programar instantáneas y resúmenes semanales

AGENTS.md

variables de entorno, comandos CLI, proceso de lanzamiento

CONTRIBUTING.md

desarrollar en este repositorio

Seguridad

Los tokens se cifran en reposo (AES-256-GCM) · solo APIs oficiales · almacén local por defecto · las propuestas de marca nunca se envían automáticamente. Detalles: SECURITY.md.

MIT © 2026 aryaminus

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Influship MCP by Influship

    Influship MCPofficial

    Influship
    A
    license
    A
    quality
    B
    maintenance
    Enables AI-native creator discovery for influencer marketing, including creator search, lookalikes, profile lookup, and Instagram post transcript analysis.
    14
    26 npm
    1
    MIT

  • socialgpt-mcp

    scrollmark
    A
    license
    Not graded
    quality
    B
    maintenance
    Brings social media analytics and content intelligence into any MCP-compatible AI agent, enabling analysis of your own videos, competitor research, and creator discovery via a hosted OAuth-authenticated server.
    10
    MIT

  • social-mcp

    nilaydatta1234
    A
    license
    A
    quality
    C
    maintenance
    Gives LLM agents read-only access to YouTube and Instagram analytics, returning engagement rates, performance versus a channel's median, outlier detection, and Shorts/Reels versus long-form splits for channels, videos, comments, posts, and hashtags. It also provides a prompt that audits a channel and proposes data-backed video ideas, with quota-aware caching and actionable error messages.
    8
    MIT

  • ViralScout MCP

    TYKAIRO-AI
    F
    license
    B
    quality
    B
    maintenance
    Enables creators to analyze supplied short-form video transcripts and metadata into structured hook, retention, remix, script, content-gap, and creator-pack outputs without API keys or paid external services.
    8
    -