Browser Session Archive

Extracts and archives chatgpt.com and claude.ai share links to Markdown using Chrome DevTools Protocol.

Triggers

User message contains:

Keywords: 提取 chatgpt, 提取 claude, 提取文档, 提取 chatgpt 对话, 提取 claude 对话, 归档 chatgpt 对话, 归档 claude 对话, 保存 chatgpt 对话, 保存 claude 对话, extract chatgpt, extract claude, archive chatgpt, archive claude, save chatgpt, save claude
Links:
- https://chatgpt.com/share/{share-id}
- https://claude.ai/share/{share-id}

Usage

Quick Start

# Copy script to PATH
cp {baseDir}/scripts/extract.sh /usr/local/bin/
chmod +x /usr/local/bin/extract.sh

# Run
extract.sh "https://chatgpt.com/share/xxx"
extract.sh "https://claude.ai/share/xxx"

Step by Step

# 1. Capture HTML
cd {baseDir}/scripts
CHROME_DEBUG_PORT=9222 TARGET_URL="https://chatgpt.com/share/xxx" \
  node capture-cdp.js

# 2. Convert to Markdown (use output path from step 1)
node convert-markdown.js --metadata "~/LookBack/$(date +%Y-%m-%d)/ChatGPT/.metadata.json"

Environment Variables

| Variable | Description | Default | |----------|-------------|---------| | CHROME_DEBUG_PORT | Chrome debugging port | 9222 | | TARGET_URL | Share link URL | (required) | | OUTPUT_DIR | Output directory | ~/LookBack/{date}/{ChatGPT\|Claude} |

Output Structure

~/LookBack/{YYYY-MM-DD}/
├── ChatGPT/
│   ├── {title}-{timestamp}.md              # Markdown file
│   ├── {title}-{timestamp}-captured.html   # HTML snapshot
│   └── .metadata.json                       # Metadata
└── Claude/
    └── ...

Prerequisites

Chrome Debug Mode: Start Chrome with --remote-debugging-port=9222

# macOS
open -a "Google Chrome" --args --remote-debugging-port=9222

# Linux
google-chrome --remote-debugging-port=9222

Install Dependencies:
```
npm install -g ws
```

Error Handling

| Error | Cause | Solution | |-------|-------|----------| | Connection refused | Chrome debug port not open | Start Chrome with --remote-debugging-port | | Timeout | Page loading slow | Increase wait time or refresh manually | | Target not found | Invalid link | Verify the share link is correct |

Scripts

| Script | Description | |--------|-------------| | capture-cdp.js | CDP capture script, extracts HTML | | convert-markdown.js | HTML to Markdown converter | | extract.sh | One-click entry script |

browser-session-archive