Sociality.io MCP

Sociality.io MCP

使用 Sociality.io 社交媒体 MCP 服务，将 AI 与社交媒体情报、分析和洞察相连接。

Sociality.io MCP 为兼容 MCP 的客户端提供结构化 OAuth 访问权限，可访问自有社交账号分析数据、已发布内容、公开竞争对手情报、竞争对手基准对比、帖子洞察，以及覆盖 Facebook、X、Instagram、YouTube、LinkedIn 和 TikTok 的报告工作流。

它面向团队、构建者和 AI 工作流，帮助他们在仪表板之外使用社交媒体情报：例如报告助手、内部副驾驶、竞争对手监控、跨渠道分析，以及由 Sociality.io 数据驱动的定制产品。

远程 MCP 服务

https://api.sociality.io/mcp

传输方式：streamable-http

身份验证：OAuth

OAuth 范围：mcp:use

Sociality.io MCP 的功能

Sociality.io MCP 通过 MCP 工具、资源和提示词提供社交媒体账号及竞争对手情报。

对于自有社交账号，客户端可以：

• 列出经过身份验证的用户可用的已连接社交账号。
• 获取指定日期范围内的账号级分析数据，按日、周或月聚合。
• 获取已发布的帖子和快拍，以进行账号级分析，并按帖子类型筛选。
• 跨平台和时段比较自有账号的表现。

对于竞争对手工作流，客户端可以：

• 列出当前工作区中已跟踪的公开竞争对手。
• 在收到明确请求时，根据社交主页 URL 添加竞争对手跟踪记录。
• 获取公开竞争对手统计数据，以进行基准对比。
• 获取竞争对手已发布的帖子，以分析内容和互动情况。
• 跨受支持的渠道比较自有账号与已跟踪的竞争对手。

对于工作流规划和安全使用，客户端可以：

• 查看工作区上下文和 MCP 积分状态。
• 了解受支持的渠道、功能、指标和聚合方式。
• 检查可用工具、账单状态，以及读写行为。
• 在 MCP 客户端支持提示词的情况下，使用内置提示词获取工具指引并检查准备情况。

文档

• 产品页面：https://sociality.io/mcp
• MCP 文档：https://sociality.io/docs
• 工具参考：https://sociality.io/docs/reference/tools
• 客户端设置：https://sociality.io/docs/getting-started/connect-your-client
• 安全使用：https://sociality.io/docs/security/safe-mcp-usage

支持的工具

工具	访问权限	积分使用情况	用途
social_accounts_list	读取	免费	列出经过身份验证的用户可用的社交媒体账号。
social_account_stats_list	读取	计费	获取指定日期范围内自有账号的分析数据，按日、周或月聚合。
social_account_posts_list	读取	计费	获取指定日期范围内自有账号已发布的帖子和快拍。
social_competitors_list	读取	免费	列出当前工作区中已跟踪的竞争对手。
social_competitors_create	写入	免费	根据社交主页 URL 添加已跟踪的竞争对手。
social_competitor_stats_list	读取	计费	获取指定日期范围内公开竞争对手的统计数据，按日、周或月聚合。
social_competitor_posts_list	读取	计费	获取指定日期范围内竞争对手已发布的帖子。

工具参数

工具	必填	可选
social_accounts_list	—	channel、name、page
social_account_stats_list	account_id、since、until	period（day、week、month；默认值为 day）
social_account_posts_list	account_id、since、until	type、order、limit（1-50，默认值为 50）、page
social_competitors_list	—	channel、name、page
social_competitors_create	url	timezone（默认使用工作区时区）
social_competitor_stats_list	competitor_id、since、until	period（day、week、month；默认值为 day）
social_competitor_posts_list	competitor_id、since、until	type、order、limit（1-50，默认值为 50）、page

日期格式为 YYYY-MM-DD。order 可设为 published_at_desc（默认值）或 published_at_asc。

统计工具会返回该账号或竞争对手所在渠道中已收录的所有可用指标。有关指标名称、说明和聚合行为，请读取 social_platform_capabilities。

帖子类型

自有账号帖子可按 status、photo、gif、video、link、album、carousel、story、reels、document、poll 或 repost 筛选。账号帖子不包含 Facebook 快拍。

竞争对手帖子类型取决于渠道：

渠道	竞争对手帖子类型
Facebook	status、photo、video、link、album
Instagram	photo、video、carousel、reels
LinkedIn	status、photo、video、link、document
TikTok	video
X	status、photo、video
YouTube	video

支持的渠道

• Facebook
• X
• Instagram
• YouTube
• LinkedIn
• TikTok

要获取最准确的渠道、功能、指标和聚合覆盖情况，请读取 MCP 服务中的 social_platform_capabilities 资源。

支持的资源

资源	URI	用途
social_workspace_context	sociality://workspace/context	返回当前团队和用户上下文，以及 MCP 积分的 usage、limit 和 resets_at。
social_tools_catalog	sociality://tools/catalog	返回已注册的工具目录，包括积分用量以及只读/写入状态。
social_platform_capabilities	sociality://platform/capabilities	返回支持的渠道、功能覆盖情况、指标名称、指标说明和聚合行为。

支持的提示词

提示词	用途
social_guide_tool_usage	说明推荐的工具用法、积分行为、分页、支持的渠道和指标选择模式。
social_guide_readiness_check	返回工作区就绪情况检查，包括积分状态、已连接账号数量，以及令牌过期等警告。

提示词支持情况取决于 MCP 客户端。有些客户端会直接显示提示词，其他客户端可能只显示工具和资源。

使用场景

• 根据实时 Sociality.io 数据生成定期社交媒体表现摘要。
• 跨渠道、营销活动和报告周期比较自有账号的表现。
• 根据粉丝、互动、帖子和发布模式对竞争对手进行基准分析。
• 分析竞争对手内容，以识别发布频率、创意形式和互动信号。
• 构建内部 Copilot，利用结构化数据回答有关账号、帖子和竞争对手的问题。
• 将社交媒体情报接入报告工作流、监控系统和面向客户的产品。
• 在启动大型工作流前运行就绪情况检查，确认工作区访问权限、可用数据源、支持的指标和积分状态。

客户端设置

对于支持远程 HTTP MCP 服务的客户端：

{
  "mcpServers": {
    "sociality": {
      "url": "https://api.sociality.io/mcp"
    }
  }
}

有关 ChatGPT、Claude、Gemini Enterprise、Gemini CLI 和其他支持的客户端，请参阅设置文档：

https://sociality.io/docs/getting-started/connect-your-client

对于 Claude Code：

claude mcp add --transport http sociality https://api.sociality.io/mcp

对于 Codex：

codex mcp add --url https://api.sociality.io/mcp sociality

如果客户端仅支持 stdio MCP 服务，请使用 mcp-remote 等桥接工具：

{
  "mcpServers": {
    "sociality": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.sociality.io/mcp"]
    }
  }
}

验证设置

连接客户端后，在运行较大的工作流前，先执行此项无需额度的设置检查：

1. 读取 social_workspace_context，确认 OAuth、当前工作区、用户上下文和额度状态。
2. 调用 social_accounts_list 和 social_competitors_list，确认可访问的自有账号和已跟踪的竞争对手。
3. 读取 social_platform_capabilities，确认支持的渠道、指标和聚合行为。
4. 读取 social_tools_catalog，区分免费工具、计费工具、只读工具和写入操作。

在定期报告、竞争对手基准分析、内部副驾驶或生产环境 Agent 工作流开始前，此项检查尤其有用。

需要执行操作的响应

如果某个请求必须等用户在 Sociality.io 中执行操作后才能回答，工具会返回一个包含空数据块和 action_required 对象的常规结果，而不是协议错误。以此方式受阻的调用不会消耗 MCP 额度。

{
  "action_required": {
    "code": "credits_exhausted",
    "message": "This workspace has used all of its MCP credits for the current period.",
    "action": "Credits reset at the start of the next period. To continue before then, review the plan in Sociality.",
    "link": "https://..."
  }
}

代码	含义
no_channels	尚未连接任何社交媒体账号。
no_competitors	尚未跟踪任何竞争对手。
channel_token_expired	账号连接已过期，必须重新连接。
credits_exhausted	当前周期内，工作区的 MCP 额度已用完。
data_retention_limited	since 早于套餐允许的数据保留期限。消息中会注明可请求的最早日期。
page_limit_reached	工作区已跟踪的页面数达到套餐包含的上限。
page_change_limit_reached	当前周期内，工作区的页面变更次数已用完。

客户端应向用户显示 message，并引导其访问 link。除非 action 说明如何调整调用（例如 data_retention_limited 的情况），否则使用不同参数重试也无济于事。

额度、限制与安全

• 计费工具根据返回的行数消耗 MCP 额度。
• 免费的设置和发现工具不会消耗 MCP 额度。
• 列表工具每页最多返回 50 行。使用 page，并检查 pagination.has_more 以获取更多结果。
• 帖子工具每次调用最多返回 50 条帖子。使用 limit 请求较少数量，并使用 page 翻页。
• 统计工具每次调用最多返回 50 行聚合数据。使用 period，确保较长的日期范围仍在此限制内。
• 可请求的最早日期取决于工作区套餐的数据保留期限。
• 某些平台会延迟报告指标。这种指标延迟属于预期延迟，并非截止时间：系统会返回截至所请求日期的可用数据。读取 social_platform_capabilities，了解各渠道的延迟详情。
• 如果用户当前的 Sociality.io 工作区处于非活动状态，工具会返回消息，请用户在控制面板中检查工作区状态。
• 当前大多数工具均为只读。
• social_competitors_create 是写入操作，只有在用户明确要求添加已跟踪的竞争对手时才能使用。此操作会计入套餐的页面数上限和页面变更次数上限。
• MCP 访问权限遵循已连接的 Sociality.io 用户和工作区权限。
• 对于生产环境或自动化工作流，请使用遵循最小权限原则的 Sociality.io 账号。

MCP 与 Sociality.io 控制面板

Sociality.io 仍是人们通过产品界面在一个地方发布内容、互动、监听和生成报告的平台。

Sociality.io MCP 用于通过工具调用实现 Agent 驱动的访问。它支持 AI 客户端和自定义系统，以结构化工作流处理 Sociality.io 账号和竞争对手情报。

团队可以使用仅依赖 MCP 的工作流，直接通过 Agent 访问；也可以结合使用 Dashboard + MCP，在 Sociality.io 中开展人工工作流，同时进行由 Agent 驱动的分析和自动化。

仓库用途

此仓库是远程 Sociality.io MCP 服务的公开发现和注册中心主页，其中包含 Official MCP Registry 元数据和使用指南。托管的 MCP 端点位于 https://api.sociality.io/mcp。

官方 MCP 注册表

此代码库包含用于将 Sociality.io MCP 发布到官方 MCP 注册表的 server.json 元数据。

注册表服务名称：

io.sociality/sociality-mcp

当前版本：1.0.0。发布后无法更改注册表版本，因此每次更新列表都需要在 server.json 中填写新的 version。请确保其与服务报告的版本一致。