Social Neuron

@socialneuron/mcp-server

AI を活用したソーシャルメディア管理のための、91 個の公開 MCP ツールです。Claude Code やあらゆる MCP クライアントから、コンテンツの作成、投稿のスケジュール設定、分析の追跡、パフォーマンスの最適化を行えます。

クイックスタート

1. 認証する

npx -y @socialneuron/mcp-server login --device

ブラウザーが開き、アクセスを許可できます。Social Neuron Pro プラン以上が必要です。料金をご覧ください。

2. Claude Code に追加する

claude mcp add socialneuron -- npx -y @socialneuron/mcp-server

{
  "mcpServers": {
    "socialneuron": {
      "command": "npx",
      "args": ["-y", "@socialneuron/mcp-server"]
    }
  }
}

{
  "servers": {
    "socialneuron": {
      "command": "npx",
      "args": ["-y", "@socialneuron/mcp-server"]
    }
  }
}

{
  "mcpServers": {
    "socialneuron": {
      "command": "npx",
      "args": ["-y", "@socialneuron/mcp-server"]
    }
  }
}

3. 利用を開始する

Claude に「今週はどんなコンテンツを投稿すればよいですか？」や「最新の動画を YouTube と TikTok にスケジュールしてください」と尋ねてみましょう。

できること

Claude に次のようなことを尋ねられます。

• 「Z 世代向けに、サステナブルファッションについてのコンテンツ案を 5 つ作成して」
• 「新商品の発売に向けて、30 秒の動画広告を作成して」
• 「この投稿を明日の午前 9 時に X と Bluesky にスケジュールして」
• 「今月、最も成果を上げたコンテンツを見せて」
• 「今、私の分野で話題になっているトピックは？」
• 「分析データを確認して、改善案を提案して」
• 「週 3 回投稿する自動運転を設定して」

ツールのカテゴリ

npm パッケージは、トランスポートごとに91 個の公開ツールを公開します。別のバージョンで提供されるホスト型サービスは、ホスト型サービス専用の get_account_status を含む92 個の公開ツールを公開します。ホスト型 HTTP には Content Calendar と Analytics Pulse の MCP Apps が含まれますが、npm stdio には代わりに 2 つのローカル画面キャプチャツールが含まれます。ホスト型サービスの最新のツール数は、サーバーカードで公開されています。npm パッケージは、宣言されたエンジン範囲で Node 20.20 以降および Node 22.22 以降をサポートします。ホスト型サービスは、別個の 3.0.0 コントラクトで稼働し、そのバージョンは、レビュー済みのツールインベントリとともに server.json.hosted に記録されています。

これらのツールは、MCP プロトコルを通じて AI エージェント（Claude、Cursor など）が利用できます。

コンテンツのライフサイクル

管理と最適化

ユーティリティ

インタラクティブ MCP Apps（ホスト型 HTTP）

アプリが表示されるのは、MCP Apps 拡張機能に対応した MCP ホストのみです。基盤となるすべてのデータと書き込み操作は、通常のスコープ付きツールとして利用できるため、インタラクティブ UI に対応していないホストでも、テキストやツールの呼び出しを通じて同じワークフローを利用できます。

認証

推奨順に、3 つの認証方法があります。

デバイスコード（推奨）

npx -y @socialneuron/mcp-server login --device

ブラウザーが開き、承認すると、CLI が API キーを自動的に受け取ります。

ブラウザーフロー

npx -y @socialneuron/mcp-server login

ブラウザーベースの OAuth フローです。

API キーの貼り付け

npx -y @socialneuron/mcp-server login --paste

socialneuron.com/settings/developer でキーを生成し、貼り付けます。

キーは OS のキーチェーン（macOS Keychain、Linux secret-tool）、または OS が対応している場合は所有者のみが読み取り可能な権限で作成される代替ファイルに保存されます。

Windows ユーザー向け：代替ファイル（~/.config/social-neuron/credentials.json）では、NTFS 上で強力な権限管理は適用されません。Windows で本番環境に使用する場合は、代わりに SOCIALNEURON_API_KEY 環境変数を設定してください。

料金

MCP/API にアクセスするには、Pro プラン以上が必要です。

socialneuron.com/pricing で登録してください。

スコープ

各 API キーには、プランに応じたスコープが継承されます。ツールの実行には特定のスコープが必要です。

CLI リファレンス

これらのコマンドはターミナルから直接実行でき、AI エージェントは不要です。スクリプト、CI/CD、簡単な確認に便利です。

グローバルインストール後（npm i -g @socialneuron/mcp-server）は、socialneuron-mcp を直接使用してください。 それ以外の場合は、npx @socialneuron/mcp-server を先頭に付けてください。

# Auth
socialneuron-mcp login [--device|--paste]
socialneuron-mcp logout

# Deterministic CLI (no LLM)
socialneuron-mcp sn publish --media-url <url> --caption <text> --platforms <list> --confirm
socialneuron-mcp sn status --job-id <id>
socialneuron-mcp sn posts --days 7 --platform youtube
socialneuron-mcp sn refresh-analytics
socialneuron-mcp sn preflight --check-urls
socialneuron-mcp sn oauth-health --json
socialneuron-mcp sn oauth-refresh --platform instagram
socialneuron-mcp sn quality-check --content "your text here"
socialneuron-mcp sn autopilot
socialneuron-mcp sn usage
socialneuron-mcp sn loop
socialneuron-mcp sn credits

# Agent-native CLI v2
socialneuron-mcp sn tools [--module ideation] [--scope mcp:write]  # List/filter available tools
socialneuron-mcp sn info                                            # Version, auth, credits, tool count
socialneuron-mcp sn plan list|view|approve                          # Content plan management
socialneuron-mcp sn preset list|show|save|delete                    # Platform presets (6 built-in)

# Interactive REPL
socialneuron-mcp repl

# Add --json to any command for machine-readable output

自動化フロー（E2E ループ）

MCP ツールを使用した、自律的なコンテンツ作成ループの全体像です。

1. get_loop_summary — プロジェクトの状態（コンテンツ数、スケジュール済みの投稿、インサイト）を評価します
2. plan_content_week — インサイトとトレンドに基づいてコンテンツプランを生成します
3. generate_video / generate_image — プランからメディアアセットを作成します
4. check_status — アセットの準備ができるまで非同期ジョブの状態を確認します
5. schedule_post — 接続済みのプラットフォームにコンテンツを配信します
6. (アナリティクスの収集を待ちます) — プラットフォームデータは自動的に取得されます
7. refresh_platform_analytics — 手動でアナリティクスの更新を実行します
8. get_performance_insights — 効果があったことと、そうでなかったことを確認します
9. 新しいインサイトを使ってステップ 1 に戻ります

パフォーマンスデータが計画ステップにフィードバックされるため、反復するたびにコンテンツの精度が高まります。

セキュリティ

• すべての API キーは保存前にハッシュ化されます。平文のキーを保存することはありません
• 認証情報は OS のキーチェーン（macOS Keychain、Linux secret-tool）または環境変数に保存されます
• すべての URL パラメーターに、DNS リバインディング対策を含む SSRF 保護を適用しています
• ユーザーごとのレート制限と、高負荷な操作に対するツールごとの制限を設けています
• エージェントループの検出により、自動化の暴走を防ぎます
• DO_NOT_TRACK=1 を設定すると、匿名の使用状況テレメトリーを無効にできます

脆弱性の報告ポリシーと認証情報の安全性について詳しくは、SECURITY.md をご覧ください。

テレメトリー

このパッケージは、信頼性の向上を目的として、運用上の使用状況メトリクス（ツール名、実行時間、成功／失敗）を収集します。ツールの入力や出力、生成されたコンテンツ、API キー、メールアドレス、上流エラーの本文は送信しません。デプロイ環境で POSTHOG_PSEUDONYMIZATION_KEY が設定されている場合、ユーザー識別子は HMAC によって仮名化されます。設定されていない場合は、一時的なプロセスごとのキーを使い、セッションをまたいだ継続的な関連付けを防ぎます。

無効にするには：環境変数に DO_NOT_TRACK=1 または SOCIALNEURON_NO_TELEMETRY=1 を設定してください。

個人のコンテンツ、API キー、リクエストペイロードが収集されることはありません。

例

プロンプト主導のワークフローテンプレートについては、examples repo をご覧ください。

• 週ごとのコンテンツ一括計画
• クロスプラットフォームでのコンテンツ再利用
• パフォーマンスのレビューと最適化のループ
• ブランドに沿ったコンテンツ生成
• コメントエンゲージメントの自動化

リンク

• Social Neuron
• 開発者向け
• ドキュメント
• 例
• エージェントプロトコル
• 開発者設定
• 料金

ライセンス

MIT - LICENSE をご覧ください