arfar-x Confluence: Search
Read-only. Run from this skill's directory:
python3 ../confluence/scripts/confluence_tool.py search --cql "space = ENG AND type = page AND text ~ 'onboarding'" \
[--max_results 25] [--include_body]
(First-time setup, once per environment: pip install -r ../confluence/requirements.txt.)
--cql is required -- a real CQL
query, not a plain keyword string; build it yourself (e.g.
space = ENG, type = page, title ~ '...' for a title match,
text ~ '...' for a body-content match, label = "..."). Never guess
a space key -- resolve it via the parent confluence skill's
list_spaces/get_space first if you don't already know it.
Results don't include each page's body text by default -- pass
--include_body only when you actually need to quote matching content,
not just list titles; page bodies are often the largest single field
per result.
If the result contains "error", tell the user what went wrong in
plain language (e.g. a malformed CQL expression) instead of retrying
silently or fabricating a result.
See ../confluence/README.md for architecture details and the full
environment-variable table.