confluence-automation

Confluence 自动化 - Rube MCP 智能体技能

技能概述

通过 Rube MCP 自动化 Confluence 操作，实现页面创建更新、CQL 内容搜索、空间管理和标签批量处理，无需 API 密钥即可连接。

适用场景

1. 文档批量创建与维护

当需要批量创建技术文档、API 参考或用户手册时，可以自动生成包含格式化内容的 Confluence 页面，支持 XHTML 存储格式，并可自动添加标签进行分类。

2. 知识库内容搜索与管理

使用 CQL（Confluence Query Language）进行高级搜索，快速定位特定空间、时间范围或标签的内容，支持全文检索和结构化查询，适合大型知识库的日常维护。

3. 空间和层级结构管理

自动化空间创建、页面层级遍历和子页面管理，可递归获取完整的页面树结构，适合项目文档初始化、空间迁移或内容重组场景。

核心功能

1. 页面创建与版本管理

支持在指定空间创建新页面，使用 XHTML 存储格式提交内容。更新页面时自动处理版本号，避免并发编辑冲突。可通过 parentId 参数控制页面在层级结构中的位置。

2. CQL 高级搜索

提供真正的全文搜索能力，支持按标题、正文、标签、创建者、修改时间等多维度筛选。CQL 支持复杂查询条件，如 text ~ "关键词" AND lastModified > now("-7d")，并可自定义排序和结果扩展。

3. 空间与标签管理

列出所有可用空间，支持按类型和状态过滤。可创建新空间（需注意 space key 只能包含字母数字）。支持页面级和空间级的标签添加与查询，方便内容分类和检索。

常见问题

如何连接 Confluence 到 Rube MCP？

首先将 https://rube.app/mcp 添加为 MCP 服务器，无需 API 密钥。然后调用 RUBE_MANAGE_CONNECTIONS 选择 confluence 工具包，按照返回的 OAuth 链接完成授权，确认状态为 ACTIVE 即可使用。

CQL 搜索和普通搜索有什么区别？

CONFLUENCE_SEARCH_CONTENT 是客户端过滤，最多获取 300 页然后筛选；CONFLUENCE_CQL_SEARCH 是服务端真正的全文搜索，支持复杂条件组合和索引查询。CQL 更适合大型空间和精确搜索需求。

如何避免 Confluence 更新版本冲突？

更新页面前必须先调用 GET_PAGE_BY_ID 获取当前版本号，然后将 version.number 设置为当前版本 + 1。建议在更新前立即获取版本信息，避免并发编辑导致的冲突。