| name | notion-public-site |
| description | Download all pages from a public Notion site as Markdown files with cross-references and embedded images. Use when the user shares a public Notion site URL and wants to archive, save, mirror, or extract the contents as local markdown. |
Download Notion Site
Download all content from a public Notion site as Markdown files.
Browser — always gstack, never headless
Browser work goes through the gstack browser, which holds the user's logged-in
sessions. A fresh Playwright instance is logged out: it silently returns login walls
or truncated content that looks like a successful capture.
B="$HOME/.claude/skills/gstack/browse/dist/browse"
"$B" connect
"$B" goto "<url>"
"$B" js '<expression>'
Do NOT disconnect when done. browse disconnect tears down the daemon and
the logged-in sessions with it. Leave it running — the daemon is a shared user
resource, connect is safe to call again, and only whoever started it should
close it.
Never launch a headless browser. Not headless=True, not --headless, not a
fresh chromium.launch(). If gstack is unavailable, stop and say so rather than
falling back — a logged-out capture is worse than no capture, because it looks fine.
Arguments
$ARGUMENTS should contain: <url> <output_dir> [--test]
Instructions
Run the Notion downloader script:
python3 ${CLAUDE_PLUGIN_ROOT}/scripts/notion_public_site_downloader.py $ARGUMENTS
If httpx or playwright are not installed, install them first:
pip3 install httpx playwright
python3 -m playwright install chromium
Features
- Automatically crawls all internal pages starting from the base URL
- Downloads embedded images to
attachments/ folder
- Converts Notion content to clean Markdown
- Rewrites internal links as Obsidian wikilinks
- Creates an index file with table of contents
- Use
--test flag to download only the first page for testing
Verification Steps
After download completes, verify the content:
- Count verification: Compare number of downloaded pages against expected (check _page_map.json)
- Content spot-check: open 2-3 random pages in the gstack browser and compare visible content with the downloaded markdown
- Link verification: Confirm wikilinks in markdown files point to existing files
- Image verification: Confirm images in attachments/ folder are valid and referenced
Example Usage
/fetch:notion-public-site https://guide.sillymoney.com/ ./output --test
/fetch:notion-public-site https://guide.sillymoney.com/ ./output
