> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# n8n

> 将 Ayrshare 社交媒体 API 集成到你的 n8n 工作流中，用于发布、排期和分析用户的社交媒体账户。

export const XByoNotice = () => <Info>
  <strong>Targeting X/Twitter?</strong> Starting March 31, 2026, all X operations require your own API credentials. After linking X via OAuth, include these 2 headers in your request:
  <br /><br />
  <code>X-Twitter-OAuth1-Api-Key</code> — Your API Key (Consumer Key)<br />
  <code>X-Twitter-OAuth1-Api-Secret</code> — Your API Key Secret (Consumer Secret)
  <br /><br />
  <strong>One-time setup per Ayrshare account.</strong> You create one X Developer App and reuse the same API Key and Secret across every sub-profile / end-user you link. You do <em>not</em> create a new app per customer.
  <br /><br />
  Not linked yet? See the <a href="/dashboard/connect-social-accounts/x-twitter-byo-keys">full setup guide</a> to connect your X account.
  <br /><br />
  Your keys are never logged or stored by Ayrshare.
</Info>;

## 概览

[n8n](https://n8n.io) 是一个工作流自动化平台，让你可以连接应用并编排流程（包括 AI Agent），支持 Cloud 和自托管部署。

Ayrshare 社交媒体 API 可以集成到你的 n8n 工作流中，用于管理用户的社交媒体账户。通过一次 API 调用即可发布到 Facebook、Instagram、LinkedIn、YouTube、TikTok、Pinterest、Reddit、Threads、Bluesky、Telegram、Google Business Profile、Snapchat 和 X，因此你无需编写和维护针对每个平台的 API 代码。

有两种连接方式：

<ul class="custom-bullets">
  <li>**MCP Server（由 Agent 驱动）。** 将 [Ayrshare MCP Server](/additional/mcp-action-server) 挂接到 n8n 内置的 MCP Client Tool 节点上，你的 AI Agent 就能自主完成整个闭环：撰写帖子、按每个平台的规则进行校验、发布或排期，最后再读取分析数据。无需自行部署任何服务，也无需安装任何社区节点。</li>
  <li>**REST API（固定工作流）。** 对于确定性、非 Agent 的工作流，可以直接从 HTTP Request 节点调用 [Ayrshare REST API](/apis/overview)。</li>
</ul>

管理用户的社交账户需要 [Business Plan](/multiple-users/business-plan-overview)，不过你也可以在 Premium 方案下用相同的方式管理自己的社交账户——只需在请求头中提供 [API Key](/apis/overview#authorization)。

## 连接方式

在 MCP 路径下，**AI Agent** 节点是大脑。**MCP Client Tool** 子节点挂接在它上面，连接到 Ayrshare MCP Server、发现可用的工具，并将它们暴露给 Agent。当 Agent 采取行动时，该节点会将调用分派给 Ayrshare，由 Ayrshare 负责发布到各社交网络。

```
Trigger  ->  AI Agent (+ Chat Model)  ->  MCP Client Tool  ->  Ayrshare MCP Server  ->  social networks
```

<Note>
  请使用 **HTTP Streamable** 传输方式，而不是 SSE。[n8n 指南](/additional/mcp-n8n) 详细介绍了传输、身份验证与搭建过程。
</Note>

## 指南

完整的 n8n 指南端到端地介绍了以 MCP 为核心的路径：前置准备、搭建 MCP Client Tool 节点、"先校验" 的 system prompt、可实操的示例（从聊天消息生成并发布内容、自动发布新内容、每周分析摘要）、通过子配置代表客户操作、保留人工介入环节、REST 兜底方案以及故障排查。

<Card title="n8n + Ayrshare MCP 指南" icon="book-open" href="/additional/mcp-n8n" horizontal>
  将 n8n 的 AI Agent 连接到 Ayrshare MCP Server，实现跨社交网络发布、排期和分析，无需为每个平台编写 API 代码。
</Card>

<Card title="下载 n8n 入门工作流" icon="download" href="/files/ayrshare-n8n-mcp-workflow.json" horizontal>
  一份可直接导入的工作流：Chat Trigger、AI Agent、一个 Anthropic 聊天模型，以及一个已预连并配好 "先校验" system prompt 的 Ayrshare MCP 节点。
</Card>

## 发布到 X（原 Twitter）

<XByoNotice />

在 n8n 中，将 MCP Client Tool 节点的 **Authentication** 切换为 **Multiple Headers**，并在 `Authorization` 旁边添加两个 `X-Twitter-OAuth1-*` 请求头。参见 [Connect & Setup → X/Twitter BYO credentials](/additional/mcp-action-connect#xtwitter-byo-credentials)。

## 了解更多

<ul class="custom-bullets">
  <li>进一步了解 [n8n](https://n8n.io) 及其 [AI Agent](https://docs.n8n.io/advanced-ai/) 和 [MCP Client Tool](https://docs.n8n.io/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.toolmcp/) 节点。</li>
  <li>参见 [MCP Server 概览](/additional/mcp-action-server)，了解该服务器是什么以及它如何映射到 Ayrshare API。</li>
  <li>浏览 [Tool Catalog](/additional/mcp-action-tools)，按业务领域查看 Agent 可调用的工具。</li>
  <li>阅读 [Connect & Setup](/additional/mcp-action-connect)，了解端点、传输、身份验证以及针对配置的调用细节。</li>
</ul>