Composio 完全入门教程：用 AI Agent 连接 500+ 应用的终极指南

面向开发者的 Composio MCP 实战教程 — 从安装到社媒营销自动化

目录

1. Composio 是什么？
2. 竞品对比：Composio vs Zapier vs Make
3. 定价方案
4. 注册 Composio 账号
5. 在 Composio 网站上 Connect 应用
6. 安装 MCP Server
7. 实战：Reddit 搜索与发帖
8. 实战：Facebook 搜索与发帖
9. 杀手锏：多平台并行查询
10. 营销自动化实战
11. 常见坑与注意事项
12. 总结

1. Composio 是什么？

Composio 是一个为 AI Agent 设计的应用集成平台。它提供了一个统一的 API/MCP 接口，让你的 AI 助手（Claude、ChatGPT、Cursor 等）可以直接操作 500+ 第三方应用 — 包括 Reddit、Facebook、Twitter、Instagram、TikTok、Gmail、Google Sheets、GitHub 等等。

核心价值： 你不需要自己写每个平台的 API 集成代码。Composio 帮你处理 OAuth 认证、API 调用、数据格式转换。你只需要通过 MCP（Model Context Protocol）连接，就能让 AI 直接操作这些应用。

架构总览

graph LR
    A[你的 AI 助手
Claude / Cursor / VS Code] -->|MCP Protocol| B[Composio MCP Server]
    B --> C[Reddit]
    B --> D[Facebook]
    B --> E[Twitter/X]
    B --> F[Instagram]
    B --> G[TikTok]
    B --> H[Gmail]
    B --> I[500+ 更多应用]
    
    style A fill:#4A90D9,color:#fff
    style B fill:#FF6B35,color:#fff

一句话总结： Composio 是 AI Agent 的「万能遥控器」。

2. 竞品对比：Composio vs Zapier vs Make

⚠️ 关键区别： Zapier 和 Make 是「无代码自动化工具」，面向非技术用户。Composio 是「AI Agent 集成层」，面向开发者。

什么时候选 Composio：

• 你用 Claude Code / Cursor / AI Agent 做开发
• 你需要 AI 直接操作第三方应用
• 你需要一次查询多个平台并汇总结果
• 你是开发者，喜欢用代码控制一切

什么时候选 Zapier/Make：

• 你不懂代码，只想做简单的 if-this-then-that
• 你需要连接冷门应用（Zapier 生态最广）
• 你的流程是固定的，不需要 AI 参与

3. 定价方案

Composio 采用按调用次数计费的模式，非常开发者友好：

💡 对开发者的建议： Free 方案的 20K calls/月 足够个人项目和测试使用。一个典型的 Reddit 搜索大约消耗 1-2 次调用，20K 次可以做很多事了。

⚠️ 注意： 每次工具调用（搜索、发帖、获取评论等）都算一次 call。多平台并行查询时，每个平台各算一次。

4. 注册 Composio 账号

⚠️ 这是第一步，不能跳过！ 必须先有 Composio 账号，才能 Connect 应用，MCP 才能正常工作。

4.1 整体流程

flowchart LR
    A[1️⃣ 注册 Composio] --> B[2️⃣ 在网页上 Connect 应用]
    B --> C[3️⃣ 安装 MCP Server]
    C --> D[4️⃣ Claude Code 中使用]
    
    style A fill:#E74C3C,color:#fff
    style B fill:#E67E22,color:#fff
    style C fill:#3498DB,color:#fff
    style D fill:#2ECC71,color:#fff

为什么要先注册和 Connect？ MCP Server 只是一个「管道」，它通过你的 Composio 账号来访问第三方应用的 API。如果你没有在 Composio 网站上连接 Reddit，MCP 调用 Reddit API 时会报错：No active connection for toolkit: reddit。

4.2 注册步骤

1. 打开 Composio 官网： https://composio.dev

2. 点击 "Get Started" 或 "Sign Up"

3. 选择注册方式：

   • GitHub 账号登录（推荐，开发者首选）
   • Google 账号登录
   • 邮箱 + 密码注册

4. 完成注册后，进入 Composio Dashboard

💡 免费方案无需绑卡。 注册即用，20K calls/月 免费。

5. 在 Composio 网站上 Connect 应用

🔥 这是最关键的一步！ 所有第三方应用的 OAuth 授权都在这里完成。MCP 只是「读取」这些授权，不能替代这一步。

5.1 Connect 流程详解

flowchart TD
    A[登录 Composio Dashboard] --> B[进入 Integrations 页面]
    B --> C[搜索你想连接的应用]
    C --> D[点击 Connect]
    D --> E[跳转到第三方 OAuth 页面]
    E --> F[登录并授权]
    F --> G[自动跳回 Composio]
    G --> H{状态显示 Connected?}
    H -->|是| I[✅ 可以通过 MCP 调用了]
    H -->|否| J[❌ 重试或检查账号权限]
    J --> D
    
    style A fill:#4A90D9,color:#fff
    style I fill:#2ECC71,color:#fff
    style J fill:#E74C3C,color:#fff

5.2 Connect Reddit

步骤：

1. 登录 Composio Dashboard
2. 左侧菜单找到 Integrations 或 Connected Apps
3. 搜索 Reddit，点击进入
4. 点击 Connect 按钮
5. 浏览器会跳转到 Reddit 的 OAuth 授权页面
6. 登录你的 Reddit 账号 → 点击 Allow
7. 自动跳回 Composio，状态变为 Connected ✅

Reddit 授权后你可以做什么：

5.3 Connect Facebook

步骤：

1. 在 Composio Dashboard 搜索 Facebook
2. 点击 Connect
3. 跳转到 Facebook OAuth 页面
4. 登录 Facebook 账号 → 选择你要关联的 Facebook Page → 点击 继续
5. 授权 Composio 管理你的 Page
6. 跳回 Composio，状态变为 Connected ✅

⚠️ Facebook 关键注意事项：

• Composio 的 Facebook 集成绑定的是 Facebook Page（公共主页），不是个人主页
• 如果你没有 Page，需要先在 Facebook 上创建一个
• 群组帖子目前不支持通过 API 发帖/评论，只能通过网页搜索间接获取内容
• 授权时确保勾选了所有权限（pages_manage_posts, pages_read_engagement 等）

5.4 Connect Instagram

步骤：

1. 在 Composio Dashboard 搜索 Instagram
2. 点击 Connect
3. 跳转到 Meta（Facebook）OAuth 页面（Instagram 用 Facebook 身份验证）
4. 选择关联的 Facebook Page → 授权 Instagram Professional 账号
5. 跳回 Composio，状态变为 Connected ✅

⚠️ Instagram 前提条件：

• 你的 Instagram 必须是 Professional 账号（Business 或 Creator）
• Instagram 账号必须关联一个 Facebook Page
• 普通个人账号无法使用 API

如何把个人 Instagram 升级为 Professional：

1. 打开 Instagram App → 设置 → 账号 → 切换为 Professional 账号
2. 选择 Creator 或 Business
3. 关联你的 Facebook Page

5.5 Connect Twitter/X

步骤：

1. 在 Composio Dashboard 搜索 Twitter
2. 点击 Connect
3. 跳转到 X (Twitter) OAuth 页面
4. 登录 Twitter 账号 → 点击 Authorize App
5. 跳回 Composio，状态变为 Connected ✅

5.6 Connect TikTok

步骤：

1. 在 Composio Dashboard 搜索 TikTok
2. 点击 Connect
3. 跳转到 TikTok OAuth 页面
4. 登录 TikTok 账号 → 授权
5. 跳回 Composio，状态变为 Connected ✅

5.7 Connect Gmail / Google Sheets 等 Google 系应用

Google 系应用共用一个 Google OAuth：

1. 搜索 Gmail 或 Google Sheets 等
2. 点击 Connect
3. 跳转 Google OAuth → 选择 Google 账号 → 授权
4. 一次授权，所有 Google 应用通用 ✅

5.8 所有已连接应用一览

Connect 完成后，在 Composio Dashboard 的 Integrations 页面可以看到所有已连接的应用：

✅ Reddit       — ericwhk1205       — Connected
✅ Facebook     — Wang Jianping     — Connected
⬜ Instagram   — 未连接
⬜ Twitter/X   — 未连接
⬜ TikTok      — 未连接
✅ Gmail        — [email protected]    — Connected

💡 多账号支持： 同一个应用可以连接多个账号。比如 Facebook 上连接了个人 Page 和公司 Page，调用时通过 account 参数指定用哪个。

💡 另一种 Connect 方式（通过 MCP 对话连接）： 如果你没有在网站上预先 Connect，在 Claude Code 对话中请求操作某个平台时，Composio 也会弹出授权链接。但强烈建议先在网站上 Connect 好所有应用，这样使用体验更流畅。

6. 安装 MCP Server

前提：你已经完成了 第4步注册 和 第5步 Connect 应用。

什么是 MCP？

MCP（Model Context Protocol）是 Anthropic 提出的标准协议，让 AI 助手可以通过统一的接口调用外部工具。你可以把它理解为 AI 世界的「USB 接口」— 一个标准，连接万物。

安装步骤

一行命令搞定：

claude mcp add --scope user --transport http composio https://connect.composio.dev/mcp

参数说明：

验证安装：

在 Claude Code 中输入 /mcp，应该能看到 composio 出现在已安装列表中。

sequenceDiagram
    participant User as 你的终端
    participant Claude as Claude Code
    participant MCP as Composio MCP Server
    participant Apps as 已 Connect 的应用

    User->>Claude: claude mcp add composio ...
    Claude->>MCP: 建立 SSE 连接
    MCP-->>Claude: 连接成功 ✅
    
    User->>Claude: "帮我搜索Reddit中国旅游帖子"
    Claude->>MCP: 调用 REDDIT_SEARCH
    MCP->>Apps: 用你已授权的 Reddit Token 调 API
    Apps-->>MCP: 返回帖子数据
    MCP-->>Claude: 格式化结果
    Claude-->>User: 展示搜索结果

⚠️ 重要提示：

• 安装后需要重启 Claude Code才能生效
• 如果连接失败，检查网络是否需要代理
• MCP 不会帮你做 OAuth 授权 — 必须先在网站或对话中 Connect 好应用

7. 实战：Reddit 搜索与发帖

7.1 搜索帖子

搜索关键词：

帮我搜索 Reddit 上最近关于"去中国旅游"的热门帖子

Claude 会调用 REDDIT_SEARCH_ACROSS_SUBREDDITS 工具：

实际调用示例（你看不到，但 Claude 在后台做了这些）：

// 搜索请求
{
  "tool_slug": "REDDIT_SEARCH_ACROSS_SUBREDDITS",
  "arguments": {
    "search_query": "travel China tourism",
    "sort": "hot",
    "limit": 25
  }
}

返回结果示例：

{
  "posts": [
    {
      "title": "云南玉龙雪山蓝月谷",
      "score": 379,
      "num_comments": 9,
      "subreddit": "travelchina",
      "permalink": "/r/travelchina/comments/xxx/",
      "created_utc": 1780223243
    },
    // ... 更多帖子
  ]
}

获取特定 Subreddit 的热门帖子：

看看 r/travelchina 今天最热的5个帖子

这会调用 REDDIT_GET_R_TOP：

{
  "tool_slug": "REDDIT_GET_R_TOP",
  "arguments": {
    "subreddit": "travelchina",
    "t": "day",
    "limit": 5
  }
}

7.2 发帖

⚠️ 发帖是公开操作！ 发出去就删不回来了。Claude 会先跟你确认内容再发布。

创建新帖：

在 r/test 发一个帖子，标题是"测试"，内容是"这是通过 Composio API 发的测试帖子"

{
  "tool_slug": "REDDIT_CREATE_REDDIT_POST",
  "arguments": {
    "subreddit": "test",
    "title": "测试",
    "kind": "self",
    "text": "这是通过 Composio API 发的测试帖子"
  }
}

7.3 评论帖子

在这个帖子下评论：https://www.reddit.com/r/travelchina/comments/xxx/
评论内容："Great post! Very helpful."

{
  "tool_slug": "REDDIT_POST_REDDIT_COMMENT",
  "arguments": {
    "thing_id": "t3_xxx",
    "text": "Great post! Very helpful."
  }
}

⚠️ thing_id 格式： t3_ 前缀表示回复帖子，t1_ 前缀表示回复评论。别搞混了。

8. 实战：Facebook 搜索与发帖

8.1 搜索 Facebook 内容

Facebook 的内容不能直接搜索帖子（API 限制），但可以通过网页搜索间接找到公开的 Facebook 帖子和群组：

搜索 Facebook 上关于中国旅游的热门群组和帖子

Claude 会使用 COMPOSIO_SEARCH_WEB 搜索：

{
  "tool_slug": "COMPOSIO_SEARCH_WEB",
  "arguments": {
    "query": "site:facebook.com China travel groups posts 2026"
  }
}

返回结果包含：

• 群组链接（如 facebook.com/groups/travelchina3/）
• 公开帖子链接
• 帖子标题和摘要

8.2 Facebook Page 发帖

⚠️ 重要限制： Composio 的 Facebook 集成只支持 Page（公共主页），不支持个人主页和群组。如果你想在群组里发帖，需要手动操作。

在 Page 上发帖：

在我的 Facebook Page 上发一条关于中国旅游的帖子

{
  "tool_slug": "FACEBOOK_CREATE_POST",
  "arguments": {
    "page_id": "你的Page ID",
    "message": "🇨🇳 中国旅游小贴士：推荐使用支付宝、高德地图和12306买火车票！"
  }
}

8.3 Facebook vs Reddit 能力对比

9. 杀手锏：多平台并行查询

🔥 这是 Composio 最强大的功能之一 — 一次请求，同时查询多个平台。

场景：你想知道全网关于"中国旅游"的讨论热度

不用 Composio 的情况： 分别打开 Reddit、Facebook、Twitter，一个一个搜。

用 Composio 的情况： 一句话搞定。

帮我同时搜索 Reddit、Facebook 网页、Twitter 上关于"去中国旅游"的最新热门内容

Claude 会并行调用多个工具：

sequenceDiagram
    participant User as 你
    participant Claude as Claude + Composio
    participant R as Reddit API
    participant F as Web Search (Facebook)
    participant T as Twitter API

    User->>Claude: 搜索"去中国旅游"多平台

    par 并行执行
        Claude->>R: REDDIT_SEARCH_ACROSS_SUBREDDITS
        Claude->>F: COMPOSIO_SEARCH_WEB (site:facebook.com)
        Claude->>T: TWITTER_RECENT_SEARCH
    end

    R-->>Claude: Reddit 帖子列表
    F-->>Claude: Facebook 群组/帖子
    T-->>Claude: Twitter 推文

    Claude->>Claude: 去重 + 排序 + 汇总
    Claude-->>User: 统一结果列表 ✅

实际代码调用：

// COMPOSIO_MULTI_EXECUTE_TOOL — 一次请求，并行调用
{
  "tools": [
    {
      "tool_slug": "REDDIT_SEARCH_ACROSS_SUBREDDITS",
      "arguments": {
        "search_query": "travel China tourism",
        "sort": "hot",
        "limit": 10
      }
    },
    {
      "tool_slug": "COMPOSIO_SEARCH_WEB",
      "arguments": {
        "query": "site:facebook.com China travel groups 2026"
      }
    },
    {
      "tool_slug": "TWITTER_RECENT_SEARCH",
      "arguments": {
        "query": "China travel tips"
      }
    }
  ]
}

你拿到的结果：

💡 营销价值： 一次查询就能掌握全网讨论趋势，比人工逐个平台搜索效率高10倍。

10. 营销自动化实战

场景：你想在中国旅游社区推广你的旅游产品

完整的营销工作流：

flowchart TD
    A[🔍 第一步：多平台监听] --> B[📊 第二步：分析热度趋势]
    B --> C[🎯 第三步：找到目标用户]
    C --> D[💬 第四步：精准互动]
    D --> E[📈 第五步：效果追踪]
    
    A1[Reddit r/travelchina
r/Chinavisa] --> A
    A2[Facebook 中国旅游群组] --> A
    A3[Twitter #ChinaTravel] --> A
    A4[TikTok China Travel 视频] --> A
    
    style A fill:#3498DB,color:#fff
    style B fill:#9B59B6,color:#fff
    style C fill:#E67E22,color:#fff
    style D fill:#2ECC71,color:#fff
    style E fill:#E74C3C,color:#fff

10.1 多平台监听

搜索 Reddit、Facebook、Twitter 上最近7天关于"中国旅游攻略"的讨论，按热度排序

10.2 找到目标用户

在 Reddit 上找到最近准备去中国旅游的帖子，列出发帖人的用户名和帖子链接

10.3 精准互动（评论）

在这个帖子下评论："推荐下载 Alipay 和 Amap，基本覆盖所有支付和导航需求。
另外12306 app可以买火车票，支持英文界面。"

⚠️ 营销注意事项：

• 不要发硬广！ Reddit 社区对广告极度反感，容易被 downvote 甚至 ban
• 以提供价值为主：分享真实经验、实用攻略
• 先混脸熟，再自然带出你的产品
• 每次操作间隔至少几分钟，避免被判定为 spam

10.4 自动化发帖示例

如果你想定时在多个平台发布内容：

# 伪代码 — 展示 Composio 的多平台发布能力
# 实际使用中通过 Claude Code 对话完成

platforms = {
    "reddit": {
        "tool": "REDDIT_CREATE_REDDIT_POST",
        "subreddit": "travelchina",
        "title": "My China Travel Tips After 30 Days",
        "text": "Just came back from a 30-day trip across China..."
    },
    "facebook": {
        "tool": "FACEBOOK_CREATE_POST",
        "page_id": "your_page_id",
        "message": "🇨🇳 Just came back from 30 days in China..."
    }
}

# Composio MULTI_EXECUTE 一次并行发布

11. 常见坑与注意事项

🚨 必须知道的坑

⚡ 效率技巧

1. 用 COMPOSIO_SEARCH_WEB 先广搜，再用平台 API 精搜 — 效率最高
2. 先查规则再发帖 — REDDIT_GET_SUBREDDIT_RULES 能避免帖子被删
3. 用 REDDIT_GET_R_TOP 按时间范围获取 — t: "day" / "week" / "month"
4. 多账号管理 — 同一平台可以连多个账号，调用时指定 account 参数

12. 总结

Composio 的核心优势

mermaid mindmap root((Composio)) AI 原生 MCP 协议支持 Claude/GPT 直接调用 自然语言控制 多平台 500+ 应用 统一 API 并行查询 开发者友好 代码控制 SDK 支持 免费 20K calls 营销利器 全网监听 自动化发布 精准互动

快速开始 Checklist

• 注册 Composio 账号：composio.dev
• 在 Dashboard 上 Connect 你需要的应用（Reddit、Facebook、Instagram...）
• 安装 MCP Server：claude mcp add --scope user --transport http composio https://connect.composio.dev/mcp
• 重启 Claude Code
• 验证连接：/mcp 查看 composio 是否在列表中
• 搜索测试：搜一个你感兴趣的话题
• 发帖测试：先在 r/test 测试发帖
• 尝试多平台并行查询
• 开始你的营销自动化之旅 🚀

📝 本文作者： eric
最后更新： 2026-06-01
Composio 官网： composio.dev
文档： docs.composio.dev
定价： composio.dev/pricing