confluence-to-markdown

1# Confluence Fetcher
2 
3Internal module — invoked by `/bedrock:teach` Phase 1 and `/bedrock:sync` Phase 2, not user-invocable.
4 
5Fetches a Confluence page and returns its content as Markdown. Three layers in fallback order:
6**MCP (preferred) → REST API → Browser DOM extraction.**
7 
8**Dependency:** Browser fallback (Layer 3) requires `scripts/extract.js` (relative to this skill directory).
9 
10---
11 
12## Step 1 — Parse URL
13 
14Parse the Confluence URL. Accept these formats:
15- `https://<domain>.atlassian.net/wiki/spaces/<spaceKey>/pages/<pageId>/<title>`
16- `https://<domain>.atlassian.net/wiki/spaces/<spaceKey>/pages/<pageId>`
17- `https://<domain>.atlassian.net/wiki/x/<shortlink>`
18- `https://<domain>.atlassian.net/wiki/pages/viewpage.action?pageId=<pageId>`
19 
20Extract:
21- **Base URL**: `https://<domain>.atlassian.net` (everything before `/wiki/...`)
22- **Page ID**: the numeric ID from the URL path (segment after `/pages/`) or `pageId` query parameter
23- **Full URL**: the original URL as provided (needed for browser fallback)
24 
25---
26 
27## Step 2 — Layer 1: MCP (Atlassian)
28 
29The preferred layer. Uses the `plugin:atlassian:atlassian` MCP server if installed and authenticated.
30 
31### 2.1 Check MCP availability
32 
33Use ToolSearch to check if Atlassian MCP tools are available:
34 
35```
36ToolSearch(query: "atlassian confluence page", max_results: 5)
37```
38 
39Evaluate the result:
40…