Search Confluence Content

IMPORTANT: Always use this skill's Python script for searching Confluence. This skill provides CQL-based search with token-efficient output, including parent hierarchy information.

Quick Start

Use the Python script at scripts/search_confluence.py:

# Simple text search
python scripts/search_confluence.py "authentication"

# Search in specific space
python scripts/search_confluence.py "API documentation" --space DEV

# Search with type filter
python scripts/search_confluence.py "meeting notes" --type blogpost

# Search by label
python scripts/search_confluence.py --label "architecture"

Options

Option	Description
query	Search text (positional argument)
--space, -s	Limit search to specific space
--type, -t	Content type: page, blogpost, comment
--label, -l	Search for content with specific label
--contributor	Search by content contributor
--modified-after	Content modified after date (YYYY-MM-DD)
--modified-before	Content modified before date (YYYY-MM-DD)
--limit	Maximum results (default: 25)
--format, -f	Output: compact (default), text, json

Search Types

Text Search

Search in page titles and content:

python scripts/search_confluence.py "deployment guide"

Label Search

Find pages with specific labels:

python scripts/search_confluence.py --label "api-reference"

Combined Search

python scripts/search_confluence.py "authentication" --space DEV --label "security"

CQL (Confluence Query Language)

This skill uses CQL internally. Advanced users can leverage CQL patterns:

Search Pattern	CQL Equivalent
Text search	text ~ "query"
Space filter	space = "KEY"
Type filter	type = page
Label filter	label = "name"
Date filter	lastModified >= "2024-01-01"

Common Workflows

Find Documentation

# Find all API-related docs
python scripts/search_confluence.py "API" --space DEV --type page

# Find recent changes
python scripts/search_confluence.py "" --space DEV --modified-after 2024-01-01

Find Meeting Notes

python scripts/search_confluence.py "meeting notes" --type blogpost --limit 10

Find by Label

# Find all architecture decisions
python scripts/search_confluence.py --label "adr"

# Find deprecated content
python scripts/search_confluence.py --label "deprecated" --space DEV

Find Contributor's Content

python scripts/search_confluence.py --contributor "john.smith" --space DEV

Output Formats

compact (default):

SEARCH|5|"authentication"
HIT|123456|Authentication Guide|DEV|page|parent:Security Docs
HIT|123457|OAuth Setup|DEV|page|parent:Authentication Guide
HIT|123458|SSO Integration|DEV|page|parent:Authentication Guide
HIT|123459|Security Best Practices|DEV|page
HIT|123460|Login Flow|DEV|page|parent:User Management

Note: Parent information is included when available (e.g., parent:Security Docs).

text:

Search Results: "authentication" (5 found)

1. Authentication Guide
   ID: 123456 | Space: DEV | Type: page | Parent: Security Docs
   URL: https://yoursite.atlassian.net/wiki/spaces/DEV/pages/123456

2. OAuth Setup
   ID: 123457 | Space: DEV | Type: page | Parent: Authentication Guide
   URL: https://yoursite.atlassian.net/wiki/spaces/DEV/pages/123457
...

json:

{
  "query": "authentication",
  "count": 5,
  "results": [
    {
      "id": "123456",
      "title": "Authentication Guide",
      "space": "DEV",
      "type": "page",
      "url": "...",
      "parentId": "123400",
      "parentTitle": "Security Docs"
    }
  ]
}

Parent Information

Search results now include parent/hierarchy information when available:

• parentId - ID of the direct parent page or folder
• parentTitle - Title of the direct parent

This helps understand where each result is located in the content hierarchy.

Environment Setup

Requires environment variables:

• CONFLUENCE_BASE_URL - e.g., https://yoursite.atlassian.net
• CONFLUENCE_EMAIL - Your Atlassian account email
• CONFLUENCE_API_TOKEN - API token from Atlassian account settings

Reference

For detailed options, see references/options-reference.md.