用途
本技能通过 Rube MCP（底层使用 Composio 的 Confluence 工具包）来自动化 Confluence 平台的日常操作，涵盖页面创建与更新、内容检索、空间管理、标签维护以及页面层级导航。
前置条件
- 需要连接 Rube MCP，并确保
RUBE_SEARCH_TOOLS可用。 - 需要通过
RUBE_MANAGE_CONNECTIONS建立状态为 ACTIVE 的 Confluence 连接（toolkit 为 confluence）。 - 每次操作前应先调用
RUBE_SEARCH_TOOLS获取当前的工具结构。
设置方式
将 https://rube.app/mcp 添加为客户端配置中的 MCP 服务器，无需 API 密钥。之后确认 RUBE_SEARCH_TOOLS 有响应，调用 RUBE_MANAGE_CONNECTIONS 并选择 toolkit confluence；若连接不是 ACTIVE，则通过返回的授权链接完成 Confluence OAuth，确认状态为 ACTIVE 后再执行工作流。
主要能力
1. 创建与更新页面
常用工具序列包括：CONFLUENCE_GET_SPACES（定位目标空间 ID）、CONFLUENCE_SEARCH_CONTENT（查找现有页面避免重复或定位父页面）、CONFLUENCE_GET_PAGE_BY_ID（更新前获取当前内容与版本号）、CONFLUENCE_CREATE_PAGE（新建页面）、CONFLUENCE_UPDATE_PAGE（更新已有页面）、CONFLUENCE_ADD_CONTENT_LABEL（为页面添加标签）。关键参数涉及 spaceId、title、parentId、body.storage.value、body.storage.representation、version.number、version.message 等。
需要注意：同一空间内页面标题必须唯一；更新时 version.number 必须为当前版本加一；内容需为 Confluence storage 格式（XHTML），而不是普通文本或 Markdown；创建与更新在 body 参数结构上有所不同；GET_PAGE_BY_ID 需要数字型 ID。
2. 搜索内容
可使用 CONFLUENCE_SEARCH_CONTENT 进行关键词搜索，也可使用 CONFLUENCE_CQL_SEARCH 进行基于 Confluence 查询语言（CQL）的高级搜索，还可通过 CONFLUENCE_GET_PAGE_BY_ID 补全结果内容，或在相关性较弱时用 CONFLUENCE_GET_PAGES 按日期浏览。CQL 支持 text、title、label、space、type、creator、lastModified、created、ancestor 等字段，以及 =、!=、~、!~、>、<、>=、<=、IN、NOT IN 等操作符和 currentUser()、now("-7d") 等函数。
需要注意：SEARCH_CONTENT 并非真正的全文检索，而 CQL_SEARCH 才是；搜索接口可能出现 HTTP 429 限流，需控制频率；使用 body 扩展时结果上限可能降低；搜索索引存在延迟。
3. 管理空间
可使用 CONFLUENCE_GET_SPACES、CONFLUENCE_GET_SPACE_BY_ID、CONFLUENCE_CREATE_SPACE、CONFLUENCE_GET_SPACE_PROPERTIES、CONFLUENCE_GET_SPACE_CONTENTS、CONFLUENCE_GET_LABELS_FOR_SPACE 等工具。关键参数包括 key、name、type、status、spaceKey、id。需要注意：空间 key 只能由字母和数字组成；GET_SPACE_BY_ID 需要数字 ID 而非 key；默认分页为 25，需显式设置 limit。
4. 页面层级与标签
可使用 CONFLUENCE_GET_CHILD_PAGES（子页面）、CONFLUENCE_GET_PAGE_ANCESTORS（祖先链）、CONFLUENCE_GET_LABELS_FOR_PAGE、CONFLUENCE_ADD_CONTENT_LABEL、CONFLUENCE_GET_LABELS_FOR_SPACE_CONTENT、CONFLUENCE_GET_PAGE_VERSIONS 等工具。子页面接口仅返回直接子级，且使用游标分页。
常见模式
- ID 解析：先解析名称到 ID，例如空间 key 到空间 ID、页面标题到页面 ID。
- 分页：多数接口使用基于偏移的 start + limit；
GET_CHILD_PAGES、GET_PAGES使用基于游标的分页。 - 内容格式：页面使用 Confluence storage 格式（XHTML），支持 p、h1-h6、strong、em、code、ul、ol、li、table，以及通过 structured-macro 使用宏。
已知限制
- ID 格式要求严格：空间 ID 为数字，页面 ID 在
GET_PAGE_BY_ID中需为整数。 - 搜索接口存在速率限制，需遵循 Retry-After 并采用退避策略。
- 内容必须为合法的 XHTML，否则创建或更新会失败。
- 更新需要精确的下一版本号，并发编辑可能导致版本冲突，建议更新前立即获取当前版本。
适用场景
适合需要批量创建或维护 Confluence 文档、检索知识库内容、整理空间与标签体系、浏览页面层级的自动化流程。
限制说明
关于具体收费、价格、平台兼容范围及效果表现，资料中暂未提供。