OmniSocials

OmniSocials Agent 技能

通过 OmniSocials，跨 13 个平台（14 个频道）管理社交媒体的 AI Agent 技能。让你的 AI Agent 能够直接从 IDE 或终端创建、安排和发布帖子。

适用于 Claude Code、Cursor、Windsurf、GitHub Copilot、Codex、Gemini CLI 等众多工具。

支持的平台

Instagram、Facebook、LinkedIn（个人主页 + 公司主页）、YouTube、TikTok、X（Twitter）、Pinterest、Bluesky、Threads、Mastodon、Google Business、Telegram（频道和群组）、Discord（频道）

设置

1. 安装技能

npx skills add OmniSocials/omnisocials-agent-skills

这会将技能（包括位于 <skill-path>/scripts/omnisocials.js 的 CLI）安装到你的 Agent 技能目录中。或者，克隆仓库并从 skills/omnisocials/scripts/omnisocials.js 运行 CLI（旧路径 scripts/omnisocials.js 仍可作为兼容入口使用）。

2. 复制你的 API Key

在 OmniSocials 应用的 Settings > API 中获取你的 API Key。

3. 运行设置命令

请 Agent“帮我设置 OmniSocials 技能”，或从安装位置自行运行设置命令：

./skills/omnisocials/scripts/omnisocials.js setup

4. 开始使用

你可以向 AI Agent 提出这类请求：

• “显示我已连接的社交账号”
• “用这张图片为 Instagram 和 LinkedIn 创建帖子”
• “将一条 TikTok 短视频安排在明天上午 9 点发布”
• “显示我已安排的帖子”
• “我的帖子本周表现如何？”
• “上传这张图片并创建一个 Pinterest 图钉”

命令

56 条命令，涵盖完整的 v1 API：

类别	命令
设置	setup、config:show
帖子	posts:list、posts:get、posts:recent-platform、posts:create、posts:create-and-publish、posts:update、posts:publish、posts:retry、posts:approve、posts:reject、posts:approval、posts:delete
审批工作流	approval-workflows:list
媒体	media:list、media:upload、media:upload-base64、media:check、media:delete
文件夹	folders:list、folders:create
标签组	hashtag-sets:list、hashtag-sets:create、hashtag-sets:update、hashtag-sets:delete
自动化（评论转私信）	automations:list、automations:get、automations:create、automations:update、automations:delete、automations:events
账号	accounts:list、accounts:get
位置和音频	locations:search、audio:search
Pinterest 商品	pinterest:products、pinterest:validate
分析	analytics:post、analytics:posts、analytics:overview、analytics:accounts、analytics:best-times
收件箱	inbox:list、inbox:next、inbox:messages、inbox:read、inbox:reply、inbox:hide、inbox:like、inbox:delete
Webhooks	webhooks:list、webhooks:create、webhooks:get、webhooks:update、webhooks:delete、webhooks:rotate-secret

功能

• 13 个平台（14 个渠道），使用一个工具即可操作
• 帖子、快拍和 Reels，并提供平台专属选项
• 平台专属控件：Pinterest 画板和商品标签、YouTube 元数据、TikTok 隐私设置、Instagram 封面、X 回复设置
• 各平台媒体：同一篇帖子可为不同平台使用不同的图片或视频
• 各渠道图片适配（尚未发布）：对于某个渠道无法完整显示且不裁剪的动态图片，可按渠道选择裁剪或保留（--media-fit instagram=keep,pinterest=crop）；media:check 会先显示每个渠道的呈现效果
• 替代文本：为每项媒体添加无障碍描述，并发送到 Mastodon、Bluesky、X、Pinterest、Instagram（图片）和 LinkedIn（图片）
• 分析：帖子级、批量、工作区概览、账户级指标，以及最佳发布时间
• 社交收件箱：阅读并回复私信、评论和提及
• 评论转私信：针对 Instagram 或 Facebook Page 评论中的关键词发送私信，每人仅限一次，并在评论下公开回复；可用于新帖子（--dm-keywords、--dm-message）或现有帖子（automations:create），并可查看每个人的活动记录（automations:events）。在 X 上（--platform x），自动化会回复账户收到的私信中的关键词
• 审批：将帖子提交至审批工作流，批准或拒绝帖子，并查看审核记录（决策者、原因、评论）
• Webhook：在帖子已排期、已发布、发布失败，或在审批工作流中已批准或已拒绝时收到通知
• 零依赖：使用 Node.js 18+ 内置的 fetch

替代方案：MCP 服务

对于调用工具而非使用 Shell 命令的 Agent，可添加托管的 OmniSocials MCP 服务。它通过 OAuth 登录（无需 API 密钥），并提供所有工具。在 Claude Code 中：

claude mcp add --transport http --scope user omnisocials https://mcp.omnisocials.com
claude mcp login omnisocials

其他 Agent 的设置方法：omnisocials.com/mcp。@omnisocials/mcp-server npm 包可使用 API 密钥运行本地副本，但工具少于托管服务。

Claude Code 和 Grok Build 插件

此仓库也可作为 Claude Code 和 Grok Build 的可安装插件市场。该插件包含此技能和托管的 OmniSocials MCP 服务。

• Claude Code： /plugin marketplace add OmniSocials/omnisocials-agent-skills，然后运行 /plugin install omnisocials@omnisocials-skills。
• Grok Build： 运行 grok plugin install OmniSocials/omnisocials-agent-skills --trust，或运行 grok plugin marketplace add OmniSocials/omnisocials-agent-skills，然后从 /plugins 安装。该插件未收录在 xAI 的官方市场中。

首次使用时，请登录 OmniSocials，并批准 Agent 可以访问的工作区。

MCP 连接使用 OAuth，无需 API 密钥。

网络端点和凭据

为便于透明审查和安全审查，此插件只会调用 OmniSocials 服务：

• https://api.omnisocials.com/v1（技能 CLI；使用你在设置时提供的 OmniSocials API 密钥进行身份验证，并将密钥存储在本地配置中）
• https://mcp.omnisocials.com（托管的 MCP 服务；通过 OAuth 2.1 登录，插件不存储密钥）

此插件不会发送遥测数据，除其自身的 API 密钥外，不会读取其他凭据。

链接

• OmniSocials
• API 文档
• 集成指南
• MCP 服务
• llms.txt（面向 AI Agent 的文档索引）

许可证

MIT