SocialGPT — social analytics, video analysis & competitor intel (hosted, OAuth 2.1)

---

これは何ですか？

これは、ホスト型のリモート MCP サーバーである SocialGPT MCP server の公開窓口です。ソーシャルメディア分析を、MCP 対応のあらゆる AI エージェントで利用できるようにします。インストールも API キーの管理も不要です。クライアントを 1 つの URL に接続し、SocialGPT アカウントで一度認証するだけです。

接続 URL：

https://mcp.gpt.social/mcp

• トランスポート： Streamable HTTP
• 認証： PKCE を使用した OAuth 2.1。SocialGPT アカウントで一度サインインすれば、いつでも取り消せます
• アクセス： デフォルトでは分析専用の読み取りアクセスです。2 つのオプションスコープを追加すると、エージェントが分析用に新しいコンテンツをライブラリに取り込めるようになるほか、接続済みアカウントへの投稿も可能になります。

SocialGPT を初めて利用しますか？無料アカウントを作成し、ソーシャルアカウントを接続すると、自分のコンテンツを分析できます。公開アカウントや競合他社の分析は、何も接続せずに利用できます。

---

セットアップ

クライアントを選び、設定を貼り付け、SocialGPT アカウントで認証します。ほとんどのクライアントでは、エージェントが初めて SocialGPT のツールを使用するときに、OAuth 用のブラウザーウィンドウが開きます。

各クライアント向けのすぐに使える設定ファイルは、examples/ にあります。

Claude Desktop

Claude Desktop の設定ファイル（macOS の場合は ~/Library/Application Support/Claude/claude_desktop_config.json）に追加してから、Claude Desktop を再起動します。

{
  "mcpServers": {
    "socialgpt": {
      "url": "https://mcp.gpt.social/mcp"
    }
  }
}

Claude.ai

設定 → Integrations → Add more → URL を貼り付け、画面の指示に従います。

https://mcp.gpt.social/mcp

Claude.ai では、インテグレーションのセットアップ中に認証が行われます。

Claude Code

claude mcp add --transport http socialgpt https://mcp.gpt.social/mcp

SocialGPT のツールを使う最初のリクエスト時に、Claude Code が OAuth サインイン用のブラウザーを開き、トークンをローカルにキャッシュします。

Cursor

プロジェクトの .cursor/mcp.json、またはグローバルに利用する場合は ~/.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "socialgpt": {
      "url": "https://mcp.gpt.social/mcp"
    }
  }
}

VS Code

ワークスペースの .vscode/mcp.json に追加します（または、コマンドパレットから MCP: Add Server を実行します）。

{
  "servers": {
    "socialgpt": {
      "type": "http",
      "url": "https://mcp.gpt.social/mcp"
    }
  }
}

ChatGPT

設定 → Tools & integrations → Add MCP server の順に進み、URL を貼り付けます。

https://mcp.gpt.social/mcp

Codex

~/.codex/config.toml（単一プロジェクトの場合は .codex/config.toml）に追加します。

[mcp_servers.socialgpt]
url = "https://mcp.gpt.social/mcp"

Cline

MCP Servers アイコン → Remote Servers → サーバー URL を追加するか、cline_mcp_settings.json を編集します。

{
  "mcpServers": {
    "socialgpt": {
      "type": "streamableHttp",
      "url": "https://mcp.gpt.social/mcp"
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json に追加します。

{
  "mcpServers": {
    "socialgpt": {
      "serverUrl": "https://mcp.gpt.social/mcp"
    }
  }
}

AntiGravity

~/.gemini/config/mcp_config.json に追加します。

{
  "mcpServers": {
    "socialgpt": {
      "serverUrl": "https://mcp.gpt.social/mcp"
    }
  }
}

その他の MCP クライアント

Model Context Protocol に対応するクライアントであれば、サーバー URL https://mcp.gpt.social/mcp を使って接続できます。MCP サーバーの登録方法については、クライアントのドキュメントを確認し、streamable HTTP トランスポートを使用してください。

---

できること

あなたのコンテンツ	自分の投稿やパフォーマンスをすべて確認できます。分析済みの動画の一覧表示や検索、フック・テーマ・文字起こしを含む詳細な分析、TikTok、Instagram、YouTubeを横断した再生数、エンゲージメント、成長の推移を追跡できます。
競合情報	どんなニッチでも、何が成果につながっているのかをリバースエンジニアリングできます。公開されているクリエイターのプロフィールやコンテンツの特徴を調べ、人気の動画や最近の動画を閲覧し、自分の動画に似た動画を見つけ、類似するクリエイターと比較できます。
コンテンツプロフィール	常に最新のコンテンツの特徴を確認できます。コンテンツから抽出した柱となるテーマや繰り返し登場するテーマ、実際のコンテンツに基づく声やトーンのプロフィール、そして制作に合わせて進化する具体的なプレイブックを利用できます。
投稿	エージェントから離れずに、連携済みのTikTok、Instagram、YouTubeアカウントへ投稿できます。投稿を公開する前に、必ず確認ステップが入ります。content:publish スコープでオプトインしてください。
ガイド付きワークフロー	パフォーマンスの包括的な監査、直接比較によるベンチマーク、クリエイターの成功パターンのリバースエンジニアリングを行う、一連のツールを連携させた事前構築済みのプロンプトです。

話しかけるだけ

接続したら、チームメイトに話すようにエージェントに話しかけてください。

「今月のコンテンツのパフォーマンスは、先月と比べてどうでしたか？」

「TikTokのフィットネス分野でクリエイターを見つけて、どんな取り組みが成果を上げているか教えてください。」

「最新のInstagramリールを分析して、より効果的なフックを提案してください。」

「YouTubeで、エンゲージメント率を類似するクリエイターと比較してください。」

「この動画をTikTokに下書きとして投稿してください。」

---

ツール

サーバーが公開する機能は厳選されています。書き込みスコープを許可しない限り、読み取り専用です。各ツールに必要なOAuthスコープは Scope 列をご覧ください（認証とスコープを参照）。

あなたの動画とコンテンツ

Tool	Description	Scope
list_videos	自分の動画を一覧表示します。プラットフォームや検索クエリで絞り込み、連携済みの単一アカウントに限定し、最近の動画または成績上位の動画で並べ替えられます。	analysis:read
search_videos	検索クエリで分析済みの動画を検索します。	analysis:read
get_video	プラットフォームと投稿IDで動画を1本取得します。自分の動画または公開・分析済みの動画が対象です。	analysis:read · analysis:read:public
get_video_analysis	自分の動画または競合の動画について、シーンごとの内訳を含む詳細な分析を取得します。	analysis:read · analysis:read:public
search	自分のコンテンツを検索します（コネクター規約に準拠したエントリーポイント）。	analysis:read
fetch	IDで単一のリソースを取得します（コネクター規約に準拠したエントリーポイント）。	analysis:read
get_content_profile	コンテンツから抽出した、自分のコンテンツの特徴（トピック、柱となるテーマ、声）を取得します。	analysis:read

アカウントと指標

Tool	Description	Scope
list_accounts	連携済みのソーシャルアカウントを一覧表示します。	analysis:read
get_account	IDで連携済みアカウントを1つ取得します。	analysis:read
get_account_metrics	直近の期間（最大365日）における再生数とエンゲージメントの時系列データを、アカウントごとまたは集計して取得します。	analysis:read
get_follower_history	オーディエンスの成長を時系列で取得します。フォロワー数、フォロー中の数、メディア数の正確な時系列データ（最大365日）が対象です。	analysis:read
get_growth_summary	指定期間の成長差分と勢いを算出します。「成長しているか？」を1回の呼び出しで確認できます。	analysis:read
get_post_metrics_history	1件の投稿の推移を時系列で取得します。動画1本の投稿後に数値がどのように変化したかを確認できます。	analysis:read · analysis:read:public

競合とクリエイターの検索

Tool	Description	Scope
get_creator	プラットフォームとハンドル名で、公開されているクリエイターまたは競合クリエイターのプロフィールを取得します。	analysis:read:public
list_creator_videos	公開クリエイターの動画を、最近の動画または人気順で一覧表示します。分析を含めることもできます。	analysis:read:public
list_similar_videos	プラットフォーム全体から、指定した動画に似た動画を見つけます。	analysis:read · analysis:read:public

新しいコンテンツを分析する

ツール	説明	スコープ
analyze_post	URLを指定してTikTok／YouTube／Instagramの投稿を1件分析します。ライブラリに追加し、動画を詳細に分析します。	content:ingest
analyze_creator	公開されているクリエイターの最近の投稿を分析します（非同期で、ポーリング用のjob_idを返します）。	content:ingest
get_analysis_status	analyze_creatorジョブのステータスを確認します。	content:ingest

公開する

オプトイン方式です。アカウントに対して操作するツールはこれらのみで、content:publishスコープが必要です。明示的な確認なしに公開されることはありません。

ツール	説明	スコープ
get_publish_options	TikTokの最新の公開オプション（プライバシーレベル、インタラクション設定、現在投稿可能かどうか）。TikTokへの投稿前に必須です。	content:publish
publish_post	接続済みのTikTok、Instagram、またはYouTubeアカウントに公開します。TikTokは下書きまたは直接投稿に対応しています。Instagramではリールとカルーセルをすぐに公開し、YouTubeでは動画をすぐに公開します。	content:publish
get_publish_status	job_idを指定して公開ジョブのステータスをポーリングします。	content:publish
get_upload_link	公開URLのないローカル動画ファイルをアップロードできるページを取得します。	content:publish
list_uploads	アップロード済みの下書きを一覧表示します。draft_idをpublish_postに渡せます。	content:publish

ローカルファイルの公開は、次の3段階で行います。get_upload_link → ブラウザーでアップロード → list_uploadsで下書きを確認 → publish_post(draft_id=...)。

メタ情報

ツール	説明	スコープ
server_info	サーバーの基本情報と、サポートするスコープを確認します。	—
whoami	認証済みの呼び出し元（ユーザーIDと許可されたスコープ）を確認します。	—

規約

いくつかの動作は、すべての機能に共通します。

• アカウントグループ（ブランド／ワークスペース）。 アカウントはグループごとに整理されています。list_accountsは各アカウントのグループとgroupsリストを返します。list_accounts、get_content_profile、get_publish_options、またはpublish_postにgroup_idを渡すと、特定のブランドに絞り込めます。省略するとデフォルトグループが使われます。
• ページネーション。 list_videos、search_videos、list_creator_videosは、結果がさらにある場合にnext_cursorを返します。同じフィルターを指定してcursorとして渡してください。next_cursorがなければ、すべての結果が取得されています。
• 時系列データの粒度。 get_account_metrics、get_follower_history、get_post_metrics_historyでは、granularityにdaily（デフォルト）、weekly、またはrawを指定します。
• 非同期分析。 動画の詳細な分析はバックグラウンドで実行されます（約30～60秒）。準備が整うまで、get_video_analysisは{"status": "pending", "retry_after_seconds": N}を返します。これは想定された動作であり、エラーではありません。待ってから再度呼び出してください。

---

ガイド付きワークフロー

このサーバーにはプロンプトも用意されており、上記のツールを連携させて一連の分析を行うワークフローを提供します。クライアントでは、これらがスラッシュコマンドやプロンプトテンプレートとして表示されます。

プロンプト	内容
analyze_my_account	接続済みアカウント1つについて、指定期間のパフォーマンスを徹底的に監査します。勢い、効果が出ている点、期待を下回っている点、優先順位付きの提案を確認できます。
compare_to_similar	自分の動画1本を類似する競合動画と直接比較し、試すべき具体的な変更点を確認できます。
what_works_in_niche	クリエイターの成功パターン（フック、形式、トピック、投稿頻度）を分析し、繰り返し使えるプレイブックにまとめます。
connect_account	自分のコンテンツを分析できるよう、ソーシャルアカウントを連携するための設定を案内します。
post_from_my_device	デバイスに保存されている動画の公開手順（アップロード、オプションの選択、確認、投稿）を案内します。content:publishが必要です。

---

スキル

プロンプトがモデルに分析を行うように 求める のに対し、スキル は作業そのものを提供します。ほとんどはエージェントが MCP データ上で実行し、スタイルを整えたレポートを返す実際のスクリプトです。going-viral は、ほかのスキルを実行する戦略ループです。Claude.ai（zip をアップロード）と Claude Code（フォルダーを配置）にインストールでき、内部では同じ SocialGPT MCP ツールを実行します。

スキル	わかること	使用するツール
going-viral	「実際にバズるにはどうすればいいですか？」 — 一連の流れを最初から最後まで実行します。突出した投稿を調査し、自分ならではの要因を見つけ、成果を上げているフックを研究し、実験を1つ実施して、結果を確認し、繰り返します。各ステップをあなたのデータに基づいて進め、3つの分析スキルへとつなぎます。	オーケストレーション — list_videos、list_creator_videos、get_video_analysis、get_content_profile、get_growth_summary、…
content-performance-audit	「実際に再生数を伸ばしている要因は何ですか？」 — 実際の有意性検定を用いて、投稿（長さ、タイミング、プラットフォーム、形式）を統計的に監査します。	list_videos
competitor-gap-analysis	「競合が成果を上げているのに、自分が手をつけていないのはどの領域ですか？」 — 1〜3人の競合を対象に、コンテンツの空白領域、自分が強みを持つ領域、形式のギャップを分析します。	list_videos、list_creator_videos
hook-retention-teardown	「成果を上げたフックは、失敗したものと何が違うのですか？」 — 成功と失敗を分けるテンポと表現のパターンを分析します。	list_videos、get_video_analysis

各スキルのインストール手順、ビルドスクリプト、手法については skills/ をご覧ください。ツールの提供範囲が広がるにつれて、新しいスキルもここに追加されます。

---

認証とスコープ

SocialGPT MCP サーバーは OAuth 2.1 のリソースサーバーです。クライアントは SocialGPT アカウントに対して OAuth 2.1 + PKCE フローを実行し、サーバーはすべてのリクエストでベアラートークンを検証します。API キーをコピーして使い回す必要はなく、SocialGPT の設定からいつでもアクセスを取り消せます。

アクセスは4つのスコープによって制御されます。読み取りスコープの2つはデフォルトで付与され、書き込みスコープの2つはオプトインです。クライアントが明示的に要求し、あなたが承認する必要があります。

スコープ	デフォルト	許可される操作
analysis:read	✅	自分自身のコンテンツ、指標、接続済みアカウント、コンテンツプロフィールを読み取ります。
analysis:read:public	✅	公開アカウント／競合クリエイターと、その分析を読み取ります。
content:ingest	オプトイン	新しい投稿／クリエイターの分析を開始します。分析用にコンテンツを自分のライブラリへ取り込みます。あなたに代わって投稿や公開を行うことはありません。
content:publish	オプトイン	接続済みの TikTok ／ Instagram ／ YouTube アカウントに公開します。コンテンツをあなたのオーディエンスに届ける唯一のスコープです。publish_post には明示的な確認フラグも必要なため、あなたが承認しない限り、エージェントが投稿することはありません。

クライアントは、1時間ごとに再認証せずに済むよう、リフレッシュトークン用の offline_access を要求することもできます。

ソーシャルアカウントを接続するまでは、公開アカウント／競合の分析のみ利用できます。新しく接続したアカウントは同じトークンに自動で反映されるため、再認証は不要です。

---

ロードマップ

読み取りアクセスと公開機能は、すでにご利用いただけます。エージェントが分析や投稿以上のことを行えるよう、同じ MCP 接続を通じて、残りの書き込み機能を開発しています。

• 投稿を予約 — 最適な投稿時間にコンテンツを予約します
• 台本を生成 — 分析データとスタイルに基づいた動画台本を作成します
• カルーセルをデザイン — コンテンツの特徴をもとにカルーセル投稿を生成します（既存のカルーセルの公開はすでに可能です）
• コメントを管理 — 各プラットフォームのコメントを読み取り、返信し、管理します
• フックを A/B テスト — フックとキャプションで実験を行います

---

サポートとリンク

⭐ SocialGPT MCP が役に立ったら、このリポジトリにスターを付けてください — ほかのクリエイターにも見つけてもらいやすくなります。

• 製品： gpt.social · MCP 統合ページ
• 登録： app.gpt.social/signup
• アカウントを接続： app.gpt.social/account
• MCP について： modelcontextprotocol.io

このリポジトリには、SocialGPT MCP サーバーの公開掲載情報と接続の詳細が含まれています。サーバー自体は SocialGPT がホストしており、そのソースコードはこのリポジトリには含まれていません。

ライセンス

MIT © Scrollmark, Inc.