Files
ankn a5f8fb49ab Migrate all repos into monorepo context folders
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.
2026-06-30 20:39:52 +02:00

2.1 KiB

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

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:

$ConfluenceUrl = "https://your-confluence.example.com"
$SpaceKey      = "YOUR_SPACE"
$RootPageId    = "123456789"  # The root page ID to work under

3. Run scripts

# 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

$ConfluenceUrl = "https://your-confluence.example.com"
$SpaceKey      = "MYSPACE"
$RootPageId    = "123456789"
$ApiBase       = "$ConfluenceUrl/rest/api"

For AI Agents

See 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 for step-by-step instructions on cloning this template for a new Confluence space.

License

MIT