Confluence Analytics

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

Risk Levels

All operations are read-only with no risk:

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:

confluence-as analytics views PAGE_ID [--output json]

Arguments:

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

Examples:

# 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:

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:

# 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:

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:

# 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:

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:

# 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
• CQL (Confluence Query Language)
• API docs in references/ directory