名称： confluence-v2
描述： 完整的 Confluence Cloud REST API v2 技能（页面、空间、文件夹、数据库、白板、评论、标签、任务、属性等），支持基础/OAuth 认证、分页，并可从 confluence-cli 迁移。

Confluence Cloud REST API v2

使用此技能可直接调用 Confluence Cloud REST API v2 接口。支持 所有 v2 分组（页面、空间、文件夹、白板、数据库、嵌入、评论、标签、属性、任务等）。

快速开始

1) 配置凭据（任选其一）：
- 基础认证：邮箱 + API 令牌
- OAuth：访问令牌

2) 使用 scripts/ 目录下的脚本调用接口。

配置

设置以下环境变量（推荐）或存储在本地配置文件中：

CONFLUENCE_BASE_URL=https://pangin.atlassian.net/wiki
CONFLUENCE_AUTH_METHOD=basic   # basic | oauth
CONFLUENCE_EMAIL=chrono3412@gmail.com
CONFLUENCE_API_TOKEN=YOUR_TOKEN
# 或使用 OAuth
# CONFLUENCE_OAUTH_TOKEN=YOUR_OAUTH_ACCESS_TOKEN

# 可选的管理密钥请求头（仅限 Premium/Enterprise 版本）
# CONFLUENCE_ADMIN_KEY=true

基础 URL 始终为 https://<站点>.atlassian.net/wiki。

核心辅助工具

• scripts/client.js — HTTP 客户端封装、认证请求头、分页处理
• scripts/* — 接口分组（页面、空间、文件夹等）

示例

# 列出所有内容
node scripts/spaces.js list --all
node scripts/pages.js list --all
node scripts/labels.js list --all

# 获取单个项目
node scripts/pages.js get 89522178
node scripts/folders.js direct-children 87457793

# 临时调用
node scripts/call.js GET /folders/87457793/direct-children

从 confluence-cli 迁移

如果存在 ~/.confluence-cli/config.json 文件，请按以下映射迁移：
- domain → CONFLUENCE_BASE_URL (https://{domain}/wiki)
- email → CONFLUENCE_EMAIL
- token → CONFLUENCE_API_TOKEN

参考文档

• OpenAPI 规范：refs/openapi-v2.v3.json
• 接口列表：refs/endpoints.md
• 权限范围：refs/scopes.md
• 测试：refs/tests.md
• 使用技巧：refs/usage.md