MCP 服务器

@aryaminus/socials-mcp

Enables social media creators to pull TikTok, Instagram, Facebook, and YouTube analytics into a persistent vault, receive weekly digests, review scripts, build media kits, and draft brand outreach using official APIs only.

README

Socials Assistant

MCP server + agent skills for social media creators. Pull your own TikTok, Instagram, Facebook, and YouTube analytics into a permanent vault, get weekly digests, review scripts, build media kits, and draft brand outreach with real numbers — from any AI agent.

Official APIs only. No scraping. No ToS risk.

Quick start — pick one

1. One prompt (easiest)

Copy the prompt from docs/SETUP-PROMPT.md and paste it into Claude, ChatGPT, Gemini, Codex, Cursor, or any MCP-compatible agent. It deploys the server, connects it to your agent, installs the 6 skills, walks you through platform OAuth, and runs your first digest. You click consent screens; the agent does the rest.

2. Cloud, zero install

Then open https://<your-worker>.workers.dev/setup for the credential checklist. Full journey: docs/GET-STARTED-CLOUD.md.

3. npx

npx @aryaminus/socials-mcp onboard

Installs nothing globally — prints guided setup for platform credentials, then serves MCP on stdio/HTTP.

4. Local from source

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

What you get


20 MCP tools	connect · snapshot · vault query · period compare · top content · audience · digest · media kit · pipeline · outreach log
6 skills	socials-connect · weekly-digest · script-review · publish-package · brand-outreach · media-kit
History vault	platforms expire analytics; your SQLite (local) or D1 (cloud) vault doesn't
TikTok CSV import	retention, traffic sources, search terms — Studio-only data via one command
Draft-first outreach	real numbers from your vault; nothing sends without your approval

Connect your agent

Agent	How
Claude.ai / Desktop	Settings → Connectors → custom connector → paste MCP URL
Claude Code	`claude mcp add --transport http socials <URL>`
Codex	`[mcp_servers.socials] url = "<URL>"` + `codex mcp login socials`
Cursor	Settings → MCP Servers → paste URL
Gemini CLI	mcpServers block in `~/.gemini/settings.json`
Everything else	agents/README.md

Docs

Doc	Read when
docs/SETUP-PROMPT.md	you want the one-prompt path
docs/GET-STARTED-CLOUD.md	deploying to Cloudflare
docs/onboarding-google.md / meta / tiktok	creating platform apps for OAuth
docs/CAPABILITIES.md	checking what data each platform exposes
docs/hosting-cloudflare.md	manual cloud deployment details
docs/automation.md	scheduling weekly snapshots + digests
AGENTS.md	env vars, CLI commands, release process
CONTRIBUTING.md	developing on this repo