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"]

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 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 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 analytics views 12345

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

Output (text):

Page: API Documentation
ID: 12345
Type: page
Space: DOCS

History Information
Last Modified: 2024-01-15
Modified By: John Doe

Created: 2024-01-01

Contributors (5):
  - Jane Smith
  - John Doe
  - Alice Johnson
  - Bob Wilson
  - Carol Davis

Web UI: https://your-site.atlassian.net/wiki/spaces/DOCS/pages/12345

---

confluence 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 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 analytics space DOCS

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

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

Output (text):

Space: DOCS
Period: Last 30 days

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

Recent Updates:
  - API Documentation (page) - 2024-01-15
  - Release Notes v2.1 (page) - 2024-01-14
  - Q1 Planning (blogpost) - 2024-01-13
  ...

---

confluence 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 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 analytics popular --space DOCS

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

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

# Recent blog posts
confluence 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 analytics watchers

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

Usage:

confluence analytics watchers PAGE_ID [--output json]

Arguments:

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

Examples:

# Get watchers for a page
confluence analytics watchers 12345

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

Output (text):

Watchers of: API Documentation (12345)
════════════════════════════════════════════════════════════

Name             Type   Email
───────────────  ─────  ──────────────────────────────
John Doe         user   [e-mail]
Jane Smith       user   [e-mail]
Alice Johnson    user   [e-mail]

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

v1 API (Legacy)

• GET /rest/api/content/{id}?expand=history,version,history.contributors.publishers - Page analytics
• 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 created >= "{date}" - Recent content
• 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