--- 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: 403eac8ad8a0812e6d41ed70cbc0fdf2ff4b7542 license: MIT trust: tier: reviewed reviewed_at: '2026-08-26' reviewed_by: ulises-jeremias reviewed_provenance: sha256:4923ad4a63ce514adaf979d3f605282f676ee1983e2fa4f8c7ec9024e64b475d maintenance: status: active last_checked: '2026-08-26' 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