Confluence Analytics

---
name: confluence-analytics
description: View analytics, statistics, and popularity metrics for Confluence content. ALWAYS use when
  user wants to see views, popularity, or contributor stats.
triggers:
- analytics
- statistics
- views
- popular
- watchers
- contributors
- page views
- space analytics
- most viewed
- most popular
- who is watching
- content analytics
origin:
  type: upstream
upstream:
  repository: grandcamel/Confluence-Assistant-Skills
  path: skills/confluence-analytics
  ref: 9cd07b2070b9aa0f4c6a15690306101727efe94a
  license: MIT
  version: 9cd07b2
trust:
  tier: experimental
  reviewed_at: '2026-09-14'
  reviewed_by: ulises-jeremias
maintenance:
  status: active
  last_checked: '2026-09-14'
distribution:
  mode: vendored
  redistribution_allowed: true
  attribution_file: LICENSE
security:
  scripts: false
  shell: false
  network: true
  mcp: false
  hooks: false
---

# 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
# Get all-time space analytics
confluence-as analytics space DOCS

# Get last 30 days
confluence-as analytics space DOCS --days 30

# Get as JSON
confluence-as analytics space DOCS --output json
```

**Output (text):**
```
Space Analytics: Documentation (DOCS)
Date Range: Last 30 days
============================================================

Content Summary:
  Pages: 142+
  Blog Posts: 14+
  Total: 156+
  Contributors: 8

Recent Activity:
  - [page] API Documentation
  - [page] Release Notes v2.1
  - [blogpost] Q1 Planning
✓ Retrieved analytics for space DOCS
```

The `Date Range` line appears only when `--days` is given.

---

### confluence-as analytics popular

Find the most popular or most recently updated content.

Uses CQL queries with ordering to identify popular content based on:
- Recent creation date
- Recent modification date
- Labels (e.g., "featured", "important")

**Usage:**
```bash
confluence-as analytics popular [--space SPACE_KEY] [--label LABEL] [--type TYPE] [--sort SORT] [--limit N] [--output json]
```

**Arguments:**
- `--space` - Space key to search within (optional)
- `--label` - Filter by label (optional)
- `--type` - Content type: page, blogpost, or all (default: all)
- `--sort` - Sort by: created or modified (default: modified)
- `--limit` - Number of results (default: 10)
- `--output` - Output format: text or json (default: text)

**Note:** Both `--space` and `--label` are optional. If neither is specified, the command searches across all accessible spaces.

**Examples:**
```bash
# Most recently modified in space
confluence-as analytics popular --space DOCS

# Most recently created pages
confluence-as analytics popular --space DOCS --type page --sort created --limit 5

# Content with featured label
confluence-as analytics popular --label featured --limit 10

# Recent blog posts
confluence-as analytics popular --space DOCS --type blogpost --limit 5
```

**Output (text):**
```
Popular Content
Space: DOCS
Sort: modified
════════════════════════════════════════════════════════════

ID      Title                               Type   Space  Modified
──────  ──────────────────────────────────  ─────  ─────  ──────────
12345   API Documentation                   page   DOCS   2024-01-15
12346   Getting Started Guide               page   DOCS   2024-01-14
12347   Configuration Reference             page   DOCS   2024-01-13
...

✓ Found 10 content item(s)
```

---

### confluence-as analytics watchers

Get the list of users watching a page (who will be notified of changes).

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

**Arguments:**
- `PAGE_ID` - The page ID (required). Blog post IDs are not supported: the command resolves the ID via the pages API, so a blog post ID fails with a not-found error.
- `--output` - Output format: text or json (default: text)

**Examples:**
```bash
# Get watchers for a page
confluence-as analytics watchers 12345

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

**Output (text):**
```
Watchers of: API Documentation (12345)
════════════════════════════════════════════════════════════

Name             Type   Email
───────────────  ─────  ──────────────────────────────
John Doe         user   john.doe@example.com
Jane Smith       user   jane.smith@example.com
Alice Johnson    user   alice.johnson@example.com

✓ Found 3 watcher(s)
```

**Note:** Some Confluence Cloud instances may have restricted watcher API access. If the watchers endpoint is not available, the command will report this.

---

## Natural Language Examples

When you ask Claude about analytics, this skill will be triggered:

- "Show me the analytics for page 12345"
- "Who has contributed to this page?"
- "Get statistics for the DOCS space"
- "What are the most popular pages in the KB space?"
- "Show me the most recently updated content"
- "Who is watching page 12345?"
- "Find the top 5 most active pages"
- "Get space analytics for the last 30 days"
- "Show me featured content"
- "What are the most viewed pages?"

## API Endpoints Used

This skill uses the following Confluence REST API endpoints:

### v2 API
- `GET /api/v2/pages/{id}` - Page metadata

### v1 API (Legacy)
- `GET /rest/api/content/{id}/history?expand=lastUpdated,contributors.publishers` - Page history and contributors
- `GET /rest/api/search?cql={query}` - CQL search for content
- `GET /rest/api/content/{id}/notification/child-created` - Watchers

### CQL Queries
- `space={key} AND type=page` - All pages in space
- `space={key} AND lastmodified >= {date}` - Recently modified content (built by the `--days` filter)
- `type=page ORDER BY lastModified DESC` - Recently modified
- `type=page ORDER BY created DESC` - Recently created
- `label={name}` - Content with label

## Limitations

1. **No Direct View Count:** Confluence Cloud API does not expose actual view/visit counts like Server/Data Center
2. **Watchers API:** May be restricted on some Confluence Cloud instances
3. **Analytics Proxy:** Uses modification dates, contributor lists, and labels as proxies for popularity
4. **Rate Limits:** Large spaces may hit API rate limits during analytics gathering

## Related Skills

- **confluence-page** - Page CRUD operations
- **confluence-space** - Space management
- **confluence-search** - Advanced CQL search
- **confluence-watch** - Watch/unwatch content

## References

- [Confluence REST API v1 Documentation](https://developer.atlassian.com/cloud/confluence/rest/v1/intro/)
- [CQL (Confluence Query Language)](https://developer.atlassian.com/cloud/confluence/advanced-searching-using-cql/)
- API docs in `references/` directory