{
  "markdown": "# Socials Assistant\n\n[![npm version](https://img.shields.io/npm/v/@aryaminus/socials-mcp?logo=npm&color=cb3837)](https://www.npmjs.com/package/@aryaminus/socials-mcp)\n[![GitHub Release](https://img.shields.io/github/v/release/aryaminus/socials-assistant?logo=github)](https://github.com/aryaminus/socials-assistant/releases/latest)\n[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n[![CI](https://github.com/aryaminus/socials-assistant/actions/workflows/ci.yml/badge.svg)](https://github.com/aryaminus/socials-assistant/actions/workflows/ci.yml)\n[![Docker](https://img.shields.io/badge/Docker-ghcr.io%2Faryaminus%2Fsocials--assistant-2496ED?logo=docker)](https://github.com/aryaminus/socials-assistant/pkgs/container/socials-assistant)\n\n**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.\n\nOfficial APIs only. No scraping. No ToS risk.\n\n## Quick start — pick one\n\n### 1. One prompt (easiest)\n\nCopy the prompt from [docs/SETUP-PROMPT.md](docs/SETUP-PROMPT.md) and paste it into Claude, ChatGPT, Gemini, Codex, Cursor, or any MCP-compatible agent. It asks you one question (cloud or local), then guides you step by step — handing you each link to click, coaching you through platform credentials from the repo's own docs, connecting your agent, and verifying every step before moving on. You stay in control; nothing runs without your go-ahead.\n\n### 2. Cloud, zero install\n\n[![Deploy to Cloudflare](https://deploy.workers.cloudflare.com/button)](https://deploy.workers.cloudflare.com/?url=https://github.com/aryaminus/socials-assistant/tree/main/infra/worker)\n\nThen open `https://<your-worker>.workers.dev/setup` for the credential checklist. Full journey: [docs/GET-STARTED-CLOUD.md](docs/GET-STARTED-CLOUD.md).\n\n### 3. npx\n\n```bash\nnpx @aryaminus/socials-mcp onboard\n```\n\nInstalls nothing globally — prints guided setup for platform credentials, then serves MCP on stdio/HTTP.\n\n### 4. Local from source\n\n```bash\ngit clone https://github.com/aryaminus/socials-assistant && cd socials-assistant\n./setup.sh && node apps/mcp/bin/socials-mcp.js onboard\n```\n\n## What you get\n\n| | |\n|--|--|\n| **20 MCP tools** | connect · snapshot · vault query · period compare · top content · audience · digest · media kit · pipeline · outreach log |\n| **6 skills** | [socials-connect](skills/socials-connect/SKILL.md) · [weekly-digest](skills/weekly-digest/SKILL.md) · [script-review](skills/script-review/SKILL.md) · [publish-package](skills/publish-package/SKILL.md) · [brand-outreach](skills/brand-outreach/SKILL.md) · [media-kit](skills/media-kit/SKILL.md) |\n| **History vault** | platforms expire analytics; your SQLite (local) or D1 (cloud) vault doesn't |\n| **TikTok CSV import** | retention, traffic sources, search terms — Studio-only data via one command |\n| **Draft-first outreach** | real numbers from your vault; nothing sends without your approval |\n\n## Connect your agent\n\n| Agent | How |\n|-------|-----|\n| Claude.ai / Desktop | Settings → Connectors → custom connector → paste MCP URL |\n| Claude Code | `claude mcp add --transport http socials <URL>` |\n| Codex | `[mcp_servers.socials] url = \"<URL>\"` + `codex mcp login socials` |\n| Cursor | Settings → MCP Servers → paste URL |\n| Gemini CLI | mcpServers block in `~/.gemini/settings.json` |\n| Everything else | [agents/README.md](agents/README.md) |\n\n## Docs\n\n| Doc | Read when |\n|-----|-----------|\n| [docs/SETUP-PROMPT.md](docs/SETUP-PROMPT.md) | you want the one-prompt path |\n| [docs/GET-STARTED-CLOUD.md](docs/GET-STARTED-CLOUD.md) | deploying to Cloudflare |\n| [docs/onboarding-google.md](docs/onboarding-google.md) / [meta](docs/onboarding-meta.md) / [tiktok](docs/onboarding-tiktok.md) | creating platform apps for OAuth |\n| [docs/CAPABILITIES.md](docs/CAPABILITIES.md) | checking what data each platform exposes |\n| [docs/hosting-cloudflare.md](docs/hosting-cloudflare.md) | manual cloud deployment details |\n| [docs/automation.md](docs/automation.md) | scheduling weekly snapshots + digests |\n| [AGENTS.md](AGENTS.md) | env vars, CLI commands, release process |\n| [CONTRIBUTING.md](CONTRIBUTING.md) | developing on this repo |\n\n## Security\n\nTokens encrypted at rest (AES-256-GCM) · official APIs only · vault local by default · outreach never auto-sends. Details: [SECURITY.md](SECURITY.md).\n\nMIT © 2026 [aryaminus](https://github.com/aryaminus)\n",
  "bytes": 4542,
  "sha": "8f7faa0005ad1a26b036fe98c0154d857b2dc3ae1d9a0feef45908342a03a781",
  "repo_slug": "aryaminus/socials-assistant",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_aryaminus_socials_assistant_d62770ed/readme"
}