---
name: docs/confluence-official:page-search
description: Search Confluence pages with CQL
version: "0.5.0"
---

> **Backend:** confluence-official (atlassian@claude-plugins-official)
> **Note:** Requires `atlassian@claude-plugins-official` plugin. Install: `/plugin install atlassian@claude-plugins-official`

# Page Search

## Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| cql | string | Yes | Confluence Query Language (CQL) string |
| max_results | integer | No | Maximum number of results to return (default: 10) |

## Implementation

Uses MCP Confluence tool: `mcp__atlassian__searchConfluenceUsingCql`

Example CQL:

```
space = {CONFLUENCE_SPACE_KEY} AND label = "specs-api"
space = {CONFLUENCE_SPACE_KEY} AND title ~ "Authentication"
```

## Output

| Field | Type | Description |
|-------|------|-------------|
| pages | object[] | List of matching page summaries |
| pages[].id | string | Page ID |
| pages[].title | string | Page title |
| pages[].url | string | URL to the page |
| total | integer | Total number of matches (may exceed max_results) |

## Errors

| Code | Cause | Recovery |
|------|-------|----------|
| INVALID_CQL | CQL syntax error | Review CQL syntax; check field names and operators |
| PERMISSION_DENIED | Token lacks read access to the queried space | Check plugin configuration and Confluence token scopes |
| EMPTY_RESULT | No pages match the query | Broaden the CQL or verify the space key |
| PLUGIN_UNAVAILABLE | atlassian@claude-plugins-official plugin is not installed or not responding | Run `/plugin install atlassian@claude-plugins-official` and retry |

## Used By

- sync-context (locating pages by label or title during sync)
- design-feature (finding related pages before creating new ones)
