Skip to main content
Glama
deenesjakoruzh
aryaminus

@aryaminus/socials-mcp

by aryaminus
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

Socials Assistant

npm version ![GitHub Release](https://img.shields.io/github/v/release/aryamins/socials-assistan? logo=gihub) ![Licence: MIT](https://img.shields.io/badge/lices nse-MIT-blue.svg) CI Do cker

MCPサーバー＋エージェントスキル。ソーシャルメディアクリエイター向け。

自分のTikTok、Instagram、Facebook、YouTubeのアナリティクスを永続的な履歴保管庫（vault）に取り込み、週次のダイジェストを作成し、動画台本をレビューし、メディアキットを作成し、実際の数字を入れたブランド営業の下書き・アウトリーチ原稿をドラフトできます。利用環境を選べば、どのAIエージェントからでも実行できます。

公式APIのみを使用。スクレイピングなし。利用規約（ToS）違反のリスクはありません。

クイックスタート — どれかひとつを選んでください

1. プロンプトひとつで開始（最も簡単）

docs/SETUP-PROMPT.md のプロンプトをコピーして、Claude、ChatGPT、Gemini、Codex、Cursor、またはMCP互換のエージェントに貼り付けてください。このプロンプトが、サーバーのデプロイ、エージェントとの接続、6つのスキルのインストール、各プラットフォームのOAuth設定手順、初回のダイジェスト実行までを進めてくれます。あなたは同意画面をクリックするだけで、残りの操作はエージェントが行います。

2. クラウド（インストール不要）

Deploy to Cloudflare

あとは https://<your-worker>.workers.dev/setup を開いて、認証情報のチェックリストを確認してください。全体の流れは docs/GET-STARTED-CLOUD.md を参照してください。

3. npx

npx @aryaminus/socials-mcp onboard

グローバルには何もインストールされません。プラットフォーム認証情報のガイド付きセットアップ画面を表示し、その後stdio/HTTPでMCPサーバーを立ち上げます。

4. ソースからローカルで構築

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

得られるもの

MCPツール20種類

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

スキル6種

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

履歴保管庫

プラットフォーム側のアナリティクスは期限切れが、あなたのSQLite（ローカル）またはD1（クラウド）の保管庫は消えません

TikTok CSVインポート

リテンション、トラフィックソース、検索語 — TikTok Studio限定のデータを1つのコマンドで取り込めます

下書き優先のアウトリーチ

保管庫の実データを利用。承認なしには何も送信されません

エージェントを接続

エージェント

接続方法

Claude.ai / Desktop

設定 → コネクタ → カスタムコネクタ → MCP URLを貼り付け

Claude Code

claude mcp add --transport http socials <URL>

Codex

[mcp_servers.socials] url = "<URL>" + codex mcp login socials（プラス）

Cursor

設定 → MCP Servers → URLを貼り付け

Gemini CLI

mcpServers ブロックを ~/.gemini/settings.json に記述

その他

agents/README.md

ドキュメント

ドキュメント

必要になったタイミング

docs/SETUP-PROMPT.md

プロンプトひとつでセットアップしたいそき

docs/GET-STARTED-CLOUD.md

Cloudflareにデプロイするとき

docs/onboarding-google.md / meta / tiktok

OAuth用のプラットフォームアプリを作成するとき

docs/CAPABILITIES.md

各プラットフォームが公開できるデータを確認したいとき

docs/hosting-cloudflare.md

手動でクラウド・デプロイするdetailsを知りたいとき

docs/automation.md

週次スナップショットとダイジェストの実行予約をするとき

AGENTS.md

環境変数・CLIコマンド・リリースプロセスプロセスを確認するとき

CONRIBUTING.md

このリポジトリの開発に取り出すとき

セキュリティ

トークンは保存時に暗号化（AES-256-GCM）・公式APIのみ・保管庫はデフォルトでローカル・アウトリーチメールは自動送信されません。詳細: 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
    -