confluence-analytics

Files (2)

• SKILL.md
• API_NOTES.md · references/

SKILL.md (first lines)

# Confluence Analytics Skill

---

## ⚠️ PRIMARY USE CASE

**This skill views content analytics (READ-ONLY).** Use for:
- Checking page view counts
- Finding popular/most viewed content
- Seeing who contributed to pages
- Space-level analytics

**This is a read-only skill** - it cannot modify content.

---

## When to Use / When NOT to Use

| Use This Skill | Use Instead |
|----------------|-------------|
| View page statistics | - |
| Find popular pages | - |
| See contributors | - |
| View watcher list | `confluence-watch` (to modify) |
| Edit content | `confluence-page` |

---

## Risk Levels

All operations are **read-only** with no risk:

| Operation | Risk | Notes |
|-----------|------|-------|
| All analytics operations | - | Read-only |

---

## Overview

This skill provides analytics and statistics for Confluence content, including page view information, contributor data, space-level analytics, popular content identification, and watcher lists.

**Note:** Confluence Cloud has limited analytics APIs compared to Server/Data Center. This skill uses the v1 REST API's history endpoints and CQL queries to provide analytics insights.

## CLI Commands

### confluence-as analytics views

Get analytics and view information for a specific page.

Retrieves:
- Version history
- Last modified date and author
- Creation date and author
- List of contributors who have edited the page

**Usage:**
```bash
confluence-as analytics views PAGE_ID [--output json]
```

**Arguments:**
- `PAGE_ID` - The page ID (required)
- `--output` - Output format: text or json (default: text)

**Examples:**
```bash
# Get page analytics
confluence-as analytics views 12345

# Get as JSON
confluence-as analytics views 12345 --output json
```

**Output (text):**
```
Page Statistics: API Documentation (12345)
============================================================

History Information:
  Created: 2024-01-01
  Last Updated: 2024-01-15
  Updated By: John Doe

Contributors: 5
  - Jane Smith
  - John Doe
  - Alice Johnson
  - Bob Wilson
  - Carol Davis
✓ Retrieved page statistics
```

If page history data is unavailable, the command falls back to basic page info with a note that detailed view analytics may require Confluence Premium.

---

### confluence-as analytics space

Get aggregate analytics for an entire space.

Retrieves:
- Total content count
- Breakdown by content type (pages, blog posts)
- Top contributors
- Recent updates

**Usage:**
```bash
confluence-as analytics space SPACE_KEY [--days N] [--output json]
```

**Arguments:**
- `SPACE_KEY` - The space key (required)
- `--days` - Limit to content from last N days (optional)
- `--output` - Output format: text or json (default: text)

**Examples:**
```bash

From ulises-jeremias/agent-toolkit, MIT.

More from ulises-jeremias/agent-toolkit