{"_id":"@aryaminus/socials-mcp","_rev":"5-d9b7676e0e24e888a48c9792bc62e91a","name":"@aryaminus/socials-mcp","dist-tags":{"latest":"0.4.9"},"versions":{"0.4.5":{"name":"@aryaminus/socials-mcp","version":"0.4.5","keywords":["mcp","social-media","analytics","creator","tiktok","youtube","instagram","facebook","outreach","model-context-protocol"],"license":"MIT","_id":"@aryaminus/socials-mcp@0.4.5","maintainers":[{"name":"aryaminus","email":"sunim.54@gmail.com"}],"homepage":"https://github.com/aryaminus/socials-assistant#readme","bugs":{"url":"https://github.com/aryaminus/socials-assistant/issues"},"bin":{"socials-mcp":"dist-bundle/socials-mcp.js"},"dist":{"shasum":"82682fd16bd1aa1274c95b8286f617747c3cbab1","tarball":"https://registry.npmjs.org/@aryaminus/socials-mcp/-/socials-mcp-0.4.5.tgz","fileCount":4,"integrity":"sha512-28qMMIhying0qnDu4i8egLJDZsaZ+DHgU5BaXYMTsB/fyTIA7vPPtC0O+PP8TIaAj9PzaKW7UpTWcQYZf4m2gA==","signatures":[{"sig":"MEQCIAgCRS0ulK9FXD5UNHEpWkKkJsEq/qEnBjSAfglhVJfSAiBbow9nXc6XV8I4+jdtpV3C0LNoPBVKFd05wtdDJ5XzNQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@aryaminus%2fsocials-mcp@0.4.5","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":138839},"main":"dist-bundle/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","default":"./dist-bundle/index.js"}},"gitHead":"6da626c36c56076ea2532996d60ad1fb96588ef6","scripts":{"build":"tsc -b","bundle":"tsc -b && tsx ../../scripts/bundle.ts","prepack":"tsc -b && tsx ../../scripts/bundle.ts"},"_npmUser":{"name":"aryaminus","email":"sunim.54@gmail.com"},"repository":{"url":"git+https://github.com/aryaminus/socials-assistant.git","type":"git"},"_npmVersion":"11.12.1","description":"Creator analytics MCP server — TikTok/Instagram/Facebook/YouTube vault, weekly digests, and brand-outreach support. Local SQLite vault, official APIs only.","directories":{},"_nodeVersion":"25.9.0","dependencies":{"zod":"^3.25.0","@modelcontextprotocol/sdk":"^1.30.0"},"_hasShrinkwrap":false,"devDependencies":{"@socials/vault":"workspace:*","@socials/shared":"workspace:*","@socials/connectors":"workspace:*"},"_npmOperationalInternal":{"tmp":"tmp/socials-mcp_0.4.5_1787519954148_0.19411750856343013","host":"s3://npm-registry-packages-npm-production"}},"0.4.6":{"name":"@aryaminus/socials-mcp","version":"0.4.6","keywords":["mcp","social-media","analytics","creator","tiktok","youtube","instagram","facebook","outreach","model-context-protocol"],"license":"MIT","_id":"@aryaminus/socials-mcp@0.4.6","maintainers":[{"name":"aryaminus","email":"sunim.54@gmail.com"}],"homepage":"https://github.com/aryaminus/socials-assistant#readme","bugs":{"url":"https://github.com/aryaminus/socials-assistant/issues"},"bin":{"socials-mcp":"dist-bundle/socials-mcp.js"},"dist":{"shasum":"53f853232db28c718f4548def0c39a351e5d247e","tarball":"https://registry.npmjs.org/@aryaminus/socials-mcp/-/socials-mcp-0.4.6.tgz","fileCount":4,"integrity":"sha512-bH7zo2sUOJolSLnNS8Nw9LZnvzLxB2CpaZiZk3Tqtuwxc9n2OyXzrHsTXKuRJMBk/JKTBB9QB0Re/wyW1InUIg==","signatures":[{"sig":"MEQCIBHeDEvDJkB+qz1swbF1isp2k4PaCXSpj/uzUgFX0890AiBSDFdLQq1XEGIVsHAL5jraKS446u5w1FH9tYKJCGovag==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@aryaminus%2fsocials-mcp@0.4.6","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":138839},"main":"dist-bundle/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","default":"./dist-bundle/index.js"}},"gitHead":"2f8e172befddbe230b2a4378102902b0a77db4a8","scripts":{"build":"tsc -b","bundle":"tsc -b && tsx ../../scripts/bundle.ts","prepack":"tsc -b && tsx ../../scripts/bundle.ts"},"_npmUser":{"name":"aryaminus","email":"sunim.54@gmail.com"},"repository":{"url":"git+https://github.com/aryaminus/socials-assistant.git","type":"git"},"_npmVersion":"11.12.1","description":"Creator analytics MCP server — TikTok/Instagram/Facebook/YouTube vault, weekly digests, and brand-outreach support. Local SQLite vault, official APIs only.","directories":{},"_nodeVersion":"25.9.0","dependencies":{"zod":"^3.25.0","@modelcontextprotocol/sdk":"^1.30.0"},"_hasShrinkwrap":false,"devDependencies":{"@socials/vault":"workspace:*","@socials/shared":"workspace:*","@socials/connectors":"workspace:*"},"_npmOperationalInternal":{"tmp":"tmp/socials-mcp_0.4.6_1787520559828_0.5526177242180261","host":"s3://npm-registry-packages-npm-production"}},"0.4.7":{"name":"@aryaminus/socials-mcp","version":"0.4.7","keywords":["mcp","social-media","analytics","creator","tiktok","youtube","instagram","facebook","outreach","model-context-protocol"],"license":"MIT","_id":"@aryaminus/socials-mcp@0.4.7","maintainers":[{"name":"aryaminus","email":"sunim.54@gmail.com"}],"homepage":"https://github.com/aryaminus/socials-assistant#readme","bugs":{"url":"https://github.com/aryaminus/socials-assistant/issues"},"bin":{"socials-mcp":"dist-bundle/socials-mcp.js"},"dist":{"shasum":"22c8d2742dd7525089c8377afe3ba71bd63520a2","tarball":"https://registry.npmjs.org/@aryaminus/socials-mcp/-/socials-mcp-0.4.7.tgz","fileCount":6,"integrity":"sha512-xfTBhXlAsIgLoTNxuY3WPOTdbnB9EwWoBj6tuJ2mtYpt/mfRKxbM0M8PMxsMzjJLGZXqmp+QP1VBr2WBPbtGAg==","signatures":[{"sig":"MEQCIASFCkKrCp+YxQyeQCWnF/D0i4B41zyrzsFHnpwd7Dj6AiA/ix1hJYAoqaf+zPm8upF9baNBGFIDV9FK+X77AhViOw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@aryaminus%2fsocials-mcp@0.4.7","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":144338},"main":"dist-bundle/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","default":"./dist-bundle/index.js"}},"gitHead":"2f0cff51797b5bcf83871a08a14ee80324127f6b","scripts":{"build":"tsc -b","bundle":"tsc -b && tsx ../../scripts/bundle.ts","prepack":"tsc -b && tsx ../../scripts/bundle.ts && cp ../../README.md ../../LICENSE ."},"_npmUser":{"name":"aryaminus","email":"sunim.54@gmail.com"},"repository":{"url":"git+https://github.com/aryaminus/socials-assistant.git","type":"git"},"_npmVersion":"11.12.1","description":"Creator analytics MCP server — TikTok/Instagram/Facebook/YouTube vault, weekly digests, and brand-outreach support. Local SQLite vault, official APIs only.","directories":{},"_nodeVersion":"25.9.0","dependencies":{"zod":"^3.25.0","@modelcontextprotocol/sdk":"^1.30.0"},"_hasShrinkwrap":false,"devDependencies":{"@socials/vault":"workspace:*","@socials/shared":"workspace:*","@socials/connectors":"workspace:*"},"_npmOperationalInternal":{"tmp":"tmp/socials-mcp_0.4.7_1787521168573_0.4347489807700684","host":"s3://npm-registry-packages-npm-production"}},"0.4.8":{"name":"@aryaminus/socials-mcp","version":"0.4.8","keywords":["mcp","model-context-protocol","social-media","analytics","creator","tiktok","youtube","instagram","facebook","outreach","content-creator","social-analytics","vault","sqlite","weekly-digest","brand-outreach","media-kit","script-review","ai-agent","claude","chatgpt","gemini","cursor","opencode"],"author":{"url":"https://github.com/aryaminus","name":"aryaminus","email":"sunim.54@gmail.com"},"license":"MIT","_id":"@aryaminus/socials-mcp@0.4.8","maintainers":[{"name":"aryaminus","email":"sunim.54@gmail.com"}],"homepage":"https://github.com/aryaminus/socials-assistant#readme","bugs":{"url":"https://github.com/aryaminus/socials-assistant/issues"},"bin":{"socials-mcp":"dist-bundle/socials-mcp.js"},"dist":{"shasum":"91cabf4e4bf19cd5e6b73ecf9933fafa3d5b4df2","tarball":"https://registry.npmjs.org/@aryaminus/socials-mcp/-/socials-mcp-0.4.8.tgz","fileCount":6,"integrity":"sha512-Ofi5W8Ra1t+R/EzZDx+Y/vd1D/9CNU193wsORKQQGt+2UjNPX4b1ZOOM1LRReyQvFvJbEwTW50h6P80VPWwj+Q==","signatures":[{"sig":"MEUCIQDO44JFDwVN263kah7dxZF0zMXkM8MpwbUMksj7kFClpQIgEfXHrqUy4WUINEIta6HOmz3YhWOk78Gtpny1JTh0mVQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@aryaminus%2fsocials-mcp@0.4.8","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":144894},"main":"dist-bundle/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","default":"./dist-bundle/index.js"}},"gitHead":"c3a3273d2340068048d4744bf3bb89cbcce01fc1","scripts":{"build":"tsc -b","bundle":"tsc -b && tsx ../../scripts/bundle.ts","prepack":"tsc -b && tsx ../../scripts/bundle.ts && cp ../../README.md ../../LICENSE ."},"_npmUser":{"name":"aryaminus","email":"sunim.54@gmail.com"},"repository":{"url":"git+https://github.com/aryaminus/socials-assistant.git","type":"git","directory":"apps/mcp"},"_npmVersion":"11.12.1","description":"MCP server for social media creators — pull TikTok, Instagram, Facebook, YouTube analytics into a local vault, get weekly digests, draft brand-outreach emails with real numbers. Official APIs only, no scraping.","directories":{},"_nodeVersion":"25.9.0","dependencies":{"zod":"^3.25.0","@modelcontextprotocol/sdk":"^1.30.0"},"_hasShrinkwrap":false,"devDependencies":{"@socials/vault":"workspace:*","@socials/shared":"workspace:*","@socials/connectors":"workspace:*"},"_npmOperationalInternal":{"tmp":"tmp/socials-mcp_0.4.8_1787523251954_0.4587120325558067","host":"s3://npm-registry-packages-npm-production"}},"0.4.9":{"name":"@aryaminus/socials-mcp","version":"0.4.9","description":"MCP server for social media creators — pull TikTok, Instagram, Facebook, YouTube analytics into a local vault, get weekly digests, draft brand-outreach emails with real numbers. Official APIs only, no scraping.","license":"MIT","type":"module","author":{"name":"aryaminus","email":"sunim.54@gmail.com","url":"https://github.com/aryaminus"},"homepage":"https://github.com/aryaminus/socials-assistant#readme","bin":{"socials-mcp":"dist-bundle/socials-mcp.js"},"main":"dist-bundle/index.js","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","default":"./dist-bundle/index.js"}},"scripts":{"build":"tsc -b","bundle":"tsc -b && tsx ../../scripts/bundle.ts","prepack":"tsc -b && tsx ../../scripts/bundle.ts && cp ../../README.md ../../LICENSE ."},"dependencies":{"@modelcontextprotocol/sdk":"^1.30.0","zod":"^3.25.0"},"repository":{"type":"git","url":"git+https://github.com/aryaminus/socials-assistant.git","directory":"apps/mcp"},"bugs":{"url":"https://github.com/aryaminus/socials-assistant/issues"},"keywords":["mcp","model-context-protocol","social-media","analytics","creator","tiktok","youtube","instagram","facebook","outreach","content-creator","social-analytics","vault","sqlite","weekly-digest","brand-outreach","media-kit","script-review","ai-agent","claude","chatgpt","gemini","cursor","opencode"],"devDependencies":{"@socials/shared":"workspace:*","@socials/vault":"workspace:*","@socials/connectors":"workspace:*"},"gitHead":"b273595eff3513c5326302bb6dc46b0e675566f9","_id":"@aryaminus/socials-mcp@0.4.9","_nodeVersion":"25.9.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-9OTkGshS7Es62oB1mI+mo/9QZO+TE2+HVtOdyyhb9Keudu9hPB9q3dIfcmUNP6JxLdibVSRMODhM4Ygj1Tm40Q==","shasum":"1870b7fab9317e00892a1875db85aadab881845f","tarball":"https://registry.npmjs.org/@aryaminus/socials-mcp/-/socials-mcp-0.4.9.tgz","fileCount":6,"unpackedSize":145029,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@aryaminus%2fsocials-mcp@0.4.9","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIDtBd7GlM4pr4kWz1W7N8bgjVqMCdA8RHCz5BoMijkl5AiBIO17aeJa8W0zREviLPgKhnV+NYZaydJWh36OaYBvjBA=="}]},"_npmUser":{"name":"aryaminus","email":"sunim.54@gmail.com"},"directories":{},"maintainers":[{"name":"aryaminus","email":"sunim.54@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/socials-mcp_0.4.9_1787540878364_0.9564477252290637"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-23T21:19:13.966Z","modified":"2026-08-24T03:07:58.859Z","0.4.5":"2026-08-23T21:19:14.294Z","0.4.6":"2026-08-23T21:29:19.971Z","0.4.7":"2026-08-23T21:39:28.724Z","0.4.8":"2026-08-23T22:14:12.110Z","0.4.9":"2026-08-24T03:07:58.503Z"},"bugs":{"url":"https://github.com/aryaminus/socials-assistant/issues"},"author":{"name":"aryaminus","email":"sunim.54@gmail.com","url":"https://github.com/aryaminus"},"license":"MIT","homepage":"https://github.com/aryaminus/socials-assistant#readme","keywords":["mcp","model-context-protocol","social-media","analytics","creator","tiktok","youtube","instagram","facebook","outreach","content-creator","social-analytics","vault","sqlite","weekly-digest","brand-outreach","media-kit","script-review","ai-agent","claude","chatgpt","gemini","cursor","opencode"],"repository":{"type":"git","url":"git+https://github.com/aryaminus/socials-assistant.git","directory":"apps/mcp"},"description":"MCP server for social media creators — pull TikTok, Instagram, Facebook, YouTube analytics into a local vault, get weekly digests, draft brand-outreach emails with real numbers. Official APIs only, no scraping.","maintainers":[{"name":"aryaminus","email":"sunim.54@gmail.com"}],"readme":"# 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","readmeFilename":"README.md"}