Confluence云API调用

技能简介

该技能提供对 Confluence Cloud REST API v2 的完整封装，支持页面、空间、文件夹、数据库、白板、评论、标签、任务、属性等全部 v2 端点组，兼容 Basic 与 OAuth 两种认证方式。

业务背景

该技能让业务团队无需开发背景即可直接调用Confluence云端数据。市场、运营人员可批量导出产品文档、提取项目空间结构，或自动化整理知识库内容；项目经理能快速汇总任务与评论，打通协作流程中的信息孤岛，减少人工复制粘贴的低效操作。

落地案例：某产品线季度复盘时，运营同事需要整理散落在20个空间的用户反馈页面。通过配置站点URL和个人API Token，执行分页查询脚本一次性拉取所有页面的标题、标签及最后更新时间，导出为Excel后交叉分析高频问题，原本2天的人工整理缩短至30分钟完成。

能做什么

• 列出、创建、更新、删除 Confluence 页面与空间
• 管理文件夹层级与白板内容
• 操作评论、标签、任务及自定义属性
• 处理分页数据与批量查询
• 从旧版 confluence-cli 迁移配置

使用说明

1. 安装依赖：克隆仓库后执行 npm install
2. 配置环境变量（推荐）或本地配置文件：

   CONFLUENCE_BASE_URL=https://<site>.atlassian.net/wiki
   CONFLUENCE_AUTH_METHOD=basic
   CONFLUENCE_EMAIL=your-email@example.com
   CONFLUENCE_API_TOKEN=YOUR_TOKEN

3. 调用脚本示例：

   node scripts/spaces.js list --all
   node scripts/pages.js get 89522178
   node scripts/call.js GET /folders/87457793/direct-children

输入与输出

见下方输入与输出表格。

风险提示

• API Token 需妥善保管，避免泄露至代码仓库
• 删除操作不可逆，建议先备份关键内容
• Premium/Enterprise 功能的 admin key 需额外权限
• 频繁调用可能触发 Atlassian 速率限制

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/pangin/openclaw-confluence-skill/SKILL.md
来源类型：GitHub 开源仓库