将你的工具接入 Influence 发布流程

通过 Influence 的 API 和 MCP 工具保存草稿、审核帖子,并为已批准的内容安排发布。还可通过同一套工具获取已连接社交账号,查看已记录的发布结果。

凭据、批准与发布状态

用限定权限范围的凭据控制访问

选择客户端所需的权限。Influence 会在每次操作时检查工作区归属和访问权限。各工具会说明是否需要确认,并由服务端强制执行。

批准具体的发布操作

执行前审核社交账号、内容、素材和时间。实质性变动需要重新审核并再次批准;获批的任务才会进入 Influence 的定时发布系统。

查看发布状态

使用返回的 ID 查看各条帖子。“已安排发布”表示正在等待发布;“已发布”确认帖子已经发出。“需审核”表示结果尚不确定;在查明实际结果前,不要再次发送。

通过 MCP 读取已连接的账号

此 Node.js 示例连接 Influence,并列出工作区中的社交账号。它只读取账号详情,不会创建草稿或发布帖子。

1. 创建具有读取权限的密钥

在“设置”中打开 应用与自动化 → 开发者工具。选择 读取已连接的渠道(integrations:read),取消选择其他所有权限,然后创建 API 密钥。将密钥保存到本地秘密信息存储或环境中,命名为 INFLUENCE_API_TOKEN。密钥只显示1 次;不要将它写进源文件或聊天。

打开 API 密钥设置

2. 运行示例

安装 Node.js 和 npm 后,在项目中安装 MCP SDK。将下方代码保存为 accounts.mjs,然后在已设置 INFLUENCE_API_TOKEN 的环境中运行 node accounts.mjs。SDK 会处理 MCP 的连接和初始化。

npm install @modelcontextprotocol/client@2.3.1

accounts.mjs

import { Client, StreamableHTTPClientTransport } from "@modelcontextprotocol/client";

const token = process.env.INFLUENCE_API_TOKEN;
if (!token) throw new Error("Set INFLUENCE_API_TOKEN first.");

const client = new Client({ name: "influence-quickstart", version: "1.0.0" });
const transport = new StreamableHTTPClientTransport(
  new URL("https://influence.so/api/mcp"),
  { requestInit: { headers: { Authorization: `Bearer ${token}` } } }
);

try {
  await client.connect(transport);
  const result = await client.callTool({
    name: "accountList",
    arguments: { limit: 20 }
  });
  console.log(JSON.stringify(result.structuredContent, null, 2));
  if (result.isError) process.exitCode = 1;
} finally {
  await client.close();
}

3. 读取响应

此响应示例中的账号名称和 ID 均为虚构。你的响应会标明工作区及其中已连接的社交账号。

{
  "ok": true,
  "output": {
    "cursor": null,
    "done": true,
    "items": [
      {
        "connectionId": "account_example_01",
        "eligible": true,
        "name": "Example studio",
        "platform": "bluesky",
        "supportsImage": true,
        "supportsText": true,
        "supportsVideo": true
      }
    ],
    "workspaceId": "workspace_example_01",
    "workspaceName": "Example workspace"
  },
  "toolName": "accountList"
}

结果说明

已返回账号

用 connectionId 识别各账号。eligible、supportsText、supportsImage 和 supportsVideo 表示当前的发帖能力;准备帖子前,请重新检查这些字段。

未返回账号

ok: true、items: [] 且 done: true 表示读取成功。请在 workspaceName 所示的工作区中连接社交账号,然后重新运行示例。

结果分为多页

done 为 false 时,使用返回的 cursor 和相同的 limit,再次调用 accountList。继续读取,直到 done 为 true;第一页返回的账号可能少于20个。

访问被拒绝

收到401响应时,请检查密钥是否仍有效,以及是否具有 integrations:read 权限。使用 API 密钥时,缺少权限范围也可能返回401。OAuth 连接可能返回403 insufficient_scope;请重新连接并批准读取账号的权限。

ChatGPT 和 Claude 可以通过浏览器授权连接,无需使用密钥。按相应助手的设置指南完成配置后,请它列出已连接账号。上面的示例使用完整 MCP 端点 https://influence.so/api/mcp;Claude 核心连接器有自己的设置方式。

查看可用工具及所需权限

GET /api/v1/tools 会列出你的密钥可用的工具。此请求筛选出 accountList 的权限和确认要求。创建草稿还需要额外的写入权限。

HTTP API

GET /api/v1/tools

你的应用读取工具目录,并调用可用工具。

MCP

tools/list

受支持的助手发现可用工具,并遵循相同的审核流程。

Influence
  1. 1. 准备草稿

    调用 campaignDraftSave,并使用工作区中的账号和媒体。保留版本及请求标识,以便在响应中断时恢复。写入草稿需要服务器确认。

  2. 2. 准备审核信息

    针对已保存的版本及操作调用 campaignReview。请求批准前,先展示账号、内容、媒体、设置、时间和到期时间。

  3. 3. 执行已批准的操作

    campaignReviewExecute 要求对该份确切的审核信息作出批准。文字帖子需要在完整审核信息展示后收到新的回复;带媒体的内容须先查看媒体,再批准。服务器会将操作交给持久化调度器,而不直接调用平台。

  4. 4. 重试前先读取结果

    读取各账号的状态,以及可用时返回的已发布链接。发送结果不确定时,会保持“需审核”状态,直到结果查明。创建另一条帖子前,先恢复现有请求,否则可能重复发送。

为你的工具选择连接方式

Influence: 为你的工具选择连接方式
连接方式用途访问方式
HTTP API你的应用读取工具目录,并调用可用工具。从环境变量读取带权限范围限制的 bearer 凭据。
MCP受支持的助手发现可用工具,并遵循相同的审核流程。按 Influence“设置”中对应助手的步骤完成配置。可用性取决于宿主和已授予的权限。

工具目录请求

curl --fail-with-body 'https://influence.so/api/v1/tools' \
  --header "Authorization: Bearer $INFLUENCE_API_TOKEN" \
  | jq '{tools: [.tools[] | select(.name == "accountList") | {name, scopes, confirmation, mutability}]}'

工具目录字段示例

{
  "tools": [
    {
      "confirmation": "none",
      "mutability": "read",
      "name": "accountList",
      "scopes": [
        "integrations:read"
      ]
    }
  ]
}

这些示例字段来自工具定义。实际可执行的操作由实时工具目录、凭据权限范围和已连接账号决定。

蓝色线缆连接着照片卡片托盘、方块、印章、日历和封好的信封。

可构建的发布工作流

从自有内容流程准备帖子

在自己的工具中,根据文章、更新日志或社区通知准备草稿。请求 Influence 安排发布前,先展示具体的社交账号、内容和时间供审核。

响应丢失后恢复原请求

保留原请求和幂等键,再查询其结果。结果不确定的发送会保持“需审核”状态,直至能确认发生了什么。新建替代请求可能导致同一帖子发布两次。

用 Influence IQ 起草初稿

向 Influence IQ 提供文章、项目笔记或社区动态,以及已保存的品牌指南,获取可编辑草稿。获授权且可用的 AI 工具会消耗 IQ 点数,各自的确认要求仍然适用。

向 Influence IQ 提供笔记和已保存的品牌指南,即可获得可编辑的帖子及建议日期。起草和图片生成会消耗 IQ 点数。开始生成图片前先审核报价,发布前再审核完成的内容。

了解 Influence IQ

从 AI 助手开始

通过受支持的 Influence 连接,你可以在 ChatGPT 或 Claude 中规划营销活动、修改草稿。让助手上传它能访问的图片和视频,或复用 Influence 中已就绪的媒体素材;若助手无法访问文件,先在 Influence 中上传。审核具体的社交账号、文字、素材、设置和时间。看过完整审核信息后,再通过受支持的对话内卡片批准,或新回复一条“批准”。使用 TikTok Direct 时,先在对话中给出发布选项并表示同意,再批准更新后的审核信息。审核卡片可选。设置方法和连接状态可在“设置”中查看。

为已连接的社交账号发布内容

选择工作区可用的社交账号。为每个发布目标编辑文字和受支持的素材,发布前再审核帖子。

准备好接下来要发的帖子

添加社交账号、准备帖子并选择日期。定时发布前,先审核内容。

开始使用

常见问题

API 和 MCP 工作流能做什么?
视已启用工具及你的权限而定,API 或 MCP 客户端可以处理已连接社交账号、已保存草稿、受支持的素材、帖子审核、发布排期和发布状态。
API 或 MCP 调用会绕过批准吗?
不会。服务端会强制执行各工具的确认要求。发布前,必须批准当前审核内容。执行时会先检查工作区、权限、社交账号和内容,再安排发布。
助手工作流接受哪些素材?
请助手上传它能访问的图片和视频,或复用 Influence 中已就绪的素材。如果助手无法访问文件,请先在 Influence 中上传。审核具体的社交账号、文案、素材、设置和时间。看过完整审核内容后,在受支持的聊天内卡片中批准,或重新回复“批准”。使用 TikTok Direct 时,先在聊天中说明发布选项并表示同意,再批准更新后的审核内容。审核卡片为可选形式。
响应丢失或发送结果不确定时,该怎么办?
找回原请求的结果,并检查记录的状态。不要重复发送结果不明的请求。“需审核”会一直保持未解决状态,直到核对确认实际结果。
支持 MCP 是否就保证所有助手宿主都能使用?
不保证。登录后,打开“设置 → 应用与自动化 → 连接你的助手”,查看设置说明和当前连接状态。
集成能编辑已排期或已发布的帖子吗?
如果发布尚未开始,且没有结果未明的发送,已安排发布的帖子可以退回草稿,供编辑并再次审核。助手无法编辑或删除已经在平台上发布的内容。