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

---

这是什么？

这是 SocialGPT MCP 服务 的公开入口——一个托管的远程 MCP 服务，可将社交媒体分析功能带入任何兼容 MCP 的 AI Agent。无需安装，也无需管理 API 密钥：只需将客户端指向一个 URL，并使用 SocialGPT 账号完成一次身份验证。

连接 URL：

https://mcp.gpt.social/mcp

• 传输方式： Streamable HTTP
• 身份验证： OAuth 2.1 with PKCE——使用 SocialGPT 账号登录一次，之后可随时撤销授权
• 访问权限： 默认仅可读取分析数据。另有两个可选作用域，可扩展访问能力——一个允许 Agent 将新内容导入你的资料库以供分析，另一个允许它们向你已连接的账号发布内容。

刚开始使用 SocialGPT？创建免费账号，然后连接社交账号，即可分析你自己的内容。无需连接任何账号，即可分析公开内容或竞争对手的内容。

---

设置

选择你的客户端，粘贴配置，然后使用 SocialGPT 账号进行身份验证。大多数客户端会在 Agent 首次使用 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

设置 → 集成 → 添加更多 → 粘贴 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: 添加服务器）：

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

ChatGPT

设置 → 工具和集成 → 添加 MCP 服务器，然后粘贴 URL：

https://mcp.gpt.social/mcp

Codex

将以下内容添加到 ~/.codex/config.toml（或添加到 .codex/config.toml 以仅用于单个项目）：

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

Cline

点击 MCP 服务器 图标 → 远程服务器 → 添加服务器 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 上的观看量、互动率和增长情况。
竞品情报	逆向分析任意细分领域中奏效的内容——查询任意公开创作者的个人资料和内容特征，浏览其热门和近期视频，查找与你的视频相似的视频，并与相似创作者进行对标。
内容档案	随时更新你的内容特征——根据你的内容提炼核心支柱和反复出现的主题，从实际内容中归纳声音和语气特征，并提供一套随你的创作不断演进的行动指南。
发布内容	无需离开你的 Agent，即可向已连接的 TikTok、Instagram 和 YouTube 账号发布内容——发布前必须经过确认。通过 content:publish scope 选择启用。
引导式工作流	预置提示词，可串联多个工具，完成全面的表现审查、正面对标，或逆向分析创作者的制胜方法。

直接提问

连接后，你可以像和队友交流一样向 Agent 提问：

“与上个月相比，我这个月的内容表现如何？”

“找出 TikTok 上健身领域的创作者，看看他们哪些内容做得好。”

“分析我最新的 Instagram 短视频，并给出更好的钩子建议。”

“将我的互动率与 YouTube 上的相似创作者进行比较。”

“将这段视频作为草稿发布到我的 TikTok。”

---

工具

此服务提供精选的功能集——除非你授予写入 scope，否则均为只读。Scope 列显示每个工具所需的 OAuth scope（请参阅身份验证与 scope）。

你的视频和内容

工具	描述	Scope
list_videos	列出你的视频——按平台／查询词筛选，限定到某个已连接账号，并按近期或热门程度排序。	analysis:read
search_videos	按查询词搜索已分析的视频。	analysis:read
get_video	按平台 + 帖子 ID 获取一个视频——可以是自己拥有的，也可以是公开／已分析的视频。	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

账号与指标

工具	描述	Scope
list_accounts	列出你已连接的社交账号。	analysis:read
get_account	按 ID 获取一个已连接账号。	analysis:read
get_account_metrics	获取一段历史时间范围（最长 365 天）内的观看量／互动率时间序列，可按账号查看或汇总查看。	analysis:read
get_follower_history	获取随时间变化的受众增长情况——粉丝／关注对象／媒体数量的真实时间序列（最长 365 天）。	analysis:read
get_growth_summary	计算一段时间范围内的增长变化和势头——一次调用即可回答“我在增长吗？”。	analysis:read
get_post_metrics_history	获取单条帖子的变化轨迹——查看单个视频发布后各项数据如何变化。	analysis:read · analysis:read:public

竞品与创作者发现

工具	描述	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 帖子 — 将其添加到你的内容库，并进行深度视频分析。	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 会立即发布 Reels 和轮播帖；YouTube 会立即发布视频。	content:publish
get_publish_status	通过 job_id 轮询发布任务。	content:publish
get_upload_link	获取一个页面，用于上传没有公开 URL 的本地视频文件。	content:publish
list_uploads	列出你上传的草稿，以便将 draft_id 传给 publish_post。	content:publish

发布本地文件需要完成三个步骤：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	在指定时间范围内，对一个已连接账号进行全面的表现审计 — 分析增长势头、有效做法、表现不佳之处，并给出按优先级排序的建议。
compare_to_similar	将你的一条视频与类似竞争对手的视频进行正面对比，并获取可供测试的具体改进方案。
what_works_in_niche	逆向分析某位创作者的成功公式 — 开场钩子、形式、主题和发布频率 — 并整理成可重复执行的方案。
connect_account	引导你关联社交账号，以便分析自己的内容。
post_from_my_device	引导你发布设备上的视频 — 上传、选择选项、确认并发布。需要 content:publish。

---

技能

如果说提示词会要求模型进行分析，那么 技能 则直接提供分析工作本身。大多数技能都会运行一个真实脚本，在你的 MCP 数据上执行分析，并返回格式精美的报告；going-viral 则是统筹其他技能的策略循环。它们可安装在 Claude.ai（上传 zip 文件）和 Claude Code（将文件夹放入其中），并在底层调用相同的 SocialGPT MCP 工具。

技能	解答的问题	使用的工具
going-viral	“我究竟该如何走红？” — 端到端循环：研究异常表现的内容、找出你自己的驱动因素、研究成功的开场钩子、发布一项实验、复盘并重复。每个步骤都以你的数据为依据，并调用三种分析技能。	统筹调用 — 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 设置中撤销访问权限。

访问权限由四种权限范围控制。两个只读权限范围默认授予；两个写入权限范围则需要主动选择启用——客户端必须明确请求，你也必须批准。

权限范围	默认状态	授予的权限
analysis:read	✅	读取你自己的内容、指标、已连接账户和内容资料。
analysis:read:public	✅	读取公开/竞争对手创作者及其分析结果。
content:ingest	opt-in	触发对新帖子/创作者的分析——将内容拉入你的资料库进行分析。它不会代表你发布或发布任何内容。
content:publish	opt-in	发布到你已连接的 TikTok / Instagram / YouTube 账户。此权限范围是唯一会让你的受众看到内容的权限——publish_post 还要求显式确认标记，因此 Agent 无法在你未同意的情况下发帖。

客户端还可以请求 offline_access 以获取刷新令牌，这样你就不必每小时重新进行身份验证。

在你连接社交账户之前，只能使用公开/竞争对手分析功能。新连接的账户会自动出现在同一令牌下，无需重新进行身份验证。

---

路线图

目前已支持读取和发布功能。我们正在构建其余的写入功能，让你的 Agent 不仅能分析和发帖，还能通过同一个 MCP 连接完成更多操作：

• 安排帖子 — 将内容加入队列，在最佳时间发布
• 生成脚本 — 根据你的分析数据和风格撰写完整的视频脚本
• 设计轮播帖 — 根据你的内容 DNA 生成轮播帖子（目前已支持发布现有轮播帖）
• 管理评论 — 在各个平台读取、回复和管理评论
• A/B 测试开场钩子 — 对开场钩子和说明文字开展实验

---

支持与链接

⭐ 如果 SocialGPT MCP 对你有用，请为此仓库点个星 — 这能帮助其他创作者发现它。

• 产品： gpt.social · MCP 集成页面
• 注册： app.gpt.social/signup
• 连接账号： app.gpt.social/account
• 了解 MCP： modelcontextprotocol.io

此仓库包含 SocialGPT MCP 服务的公开列表和连接详情。该服务由 SocialGPT 托管，其源代码不属于此仓库。

许可证

MIT © Scrollmark, Inc.