browser-session-archive

Extracts and archives chatgpt.com and claude.ai share links to Markdown using Chrome CDP (e.g., ChatGPT or Claude conversations).

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

Triggers

User message contains:

1. Keywords: 提取 chatgpt, 提取 claude, 提取文档, 提取 chatgpt 对话, 提取 claude 对话, 归档 chatgpt 对话, 归档 claude 对话, 保存 chatgpt 对话, 保存 claude 对话, extract chatgpt, extract claude, archive chatgpt, archive claude, save chatgpt, save claude
2. 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

1. 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
   

2. 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

References

• Chrome DevTools Protocol
• OpenClaw Skills