ankn
a5f8fb49ab
Bahn: aisupport, Analyse-O2C-C2S, awesome-bahn-mcp-servers, beam-mcp,
Confluence_Bot, db-planet-mcp-server, O2C-Harness, project-audit,
Projekt-KIQ-HP, teamlandkarte-mcp
Dhive: Jury-Voting
Privat: CV, NoteGraph (NOTE: NoteGraph needs complete redo after consolidation)
Shared: AI-Orchestrator, OrgMyLife, power_skills_and_more
Shared/references: symphony (read-only)
Bahn repos remain available as independent remotes - this monorepo
pulls them in via subtree, the originals are untouched.
79 lines
2.1 KiB
Markdown
79 lines
2.1 KiB
Markdown
# Confluence Bot
|
|
|
|
A standalone toolkit for analyzing and maintaining Confluence spaces. Clone this repo, configure your Confluence instance, and use the scripts to export, push, read, check, and reorganize pages.
|
|
|
|
## Features
|
|
|
|
- **Export** — Full page tree export (HTML + Markdown + JSON index)
|
|
- **Push** — Create/update pages from local Markdown files with automatic Umlaut handling
|
|
- **Read** — Read specific pages and their children
|
|
- **Check** — Verify which pages exist under a parent
|
|
- **Reorganize** — Move pages into a category structure
|
|
- **Delete** — Remove test/draft pages
|
|
|
|
## Quick Start
|
|
|
|
### 1. Clone and configure
|
|
|
|
```bash
|
|
git clone https://github.com/DoctoDre/Confluence_Bot.git my-confluence-project
|
|
cd my-confluence-project
|
|
cp .secrets.example .secrets
|
|
# Edit .secrets with your Confluence PAT
|
|
```
|
|
|
|
### 2. Set your Confluence details
|
|
|
|
Edit `config.ps1`:
|
|
```powershell
|
|
$ConfluenceUrl = "https://your-confluence.example.com"
|
|
$SpaceKey = "YOUR_SPACE"
|
|
$RootPageId = "123456789" # The root page ID to work under
|
|
```
|
|
|
|
### 3. Run scripts
|
|
|
|
```powershell
|
|
# Export entire page tree
|
|
powershell -ExecutionPolicy Bypass -File scripts/confluence-export.ps1
|
|
|
|
# Push local markdown as pages
|
|
powershell -ExecutionPolicy Bypass -File scripts/confluence-push.ps1
|
|
|
|
# Check what pages exist
|
|
powershell -ExecutionPolicy Bypass -File scripts/confluence-check.ps1
|
|
|
|
# Read specific pages
|
|
powershell -ExecutionPolicy Bypass -File scripts/confluence-read.ps1
|
|
|
|
# Reorganize pages into categories
|
|
powershell -ExecutionPolicy Bypass -File scripts/confluence-reorganize.ps1
|
|
```
|
|
|
|
## Configuration
|
|
|
|
### `.secrets` file
|
|
```
|
|
CONFLUENCE_TOKEN=your_personal_access_token_here
|
|
```
|
|
|
|
### `config.ps1`
|
|
```powershell
|
|
$ConfluenceUrl = "https://your-confluence.example.com"
|
|
$SpaceKey = "MYSPACE"
|
|
$RootPageId = "123456789"
|
|
$ApiBase = "$ConfluenceUrl/rest/api"
|
|
```
|
|
|
|
## For AI Agents
|
|
|
|
See [AGENTS.md](AGENTS.md) for instructions on how to use this repo as an AI agent working on Confluence maintenance tasks.
|
|
|
|
## Setting Up a New Project
|
|
|
|
See [SETUP_NEW_PROJECT.md](SETUP_NEW_PROJECT.md) for step-by-step instructions on cloning this template for a new Confluence space.
|
|
|
|
## License
|
|
|
|
MIT
|