Export DeepSeek shared conversation to Markdown

A developer created a Python tool to export shared DeepSeek conversations to Markdown, JSON, or plain text. The script automatically bootstraps its environment using uv, the fast Python package installer, and requires only a share URL or ID to run.

| /usr/bin/env python3 | | | """ | | | Export DeepSeek shared conversation to Markdown. | | | Requires uv — the fast Python package installer. | | | Install: curl -LsSf https://astral.sh/uv/install.sh | sh | | | Usage just run it — venv is created automatically : | | | python deepseek export.py <share url or id -o output.md --json --txt --token TOKEN | | | Examples: | | | python deepseek export.py https://chat.deepseek.com/share/nvy7v2ps1r6e2wyoyj | | | python deepseek export.py nvy7v2ps1r6e2wyoyj -o my chat.md | | | python deepseek export.py nvy7v2ps1r6e2wyoyj --json -o chat.json | | | python deepseek export.py nvy7v2ps1r6e2wyoyj --txt | | | First run will create .venv/ and install requests via uv. | | | """ | | | ── auto-venv bootstrap ───────────────────────────────────────────────────── | | | import os | | | import shutil | | | import subprocess | | | import sys | | | from pathlib import Path | | | SCRIPT DIR = Path file .resolve .parent | | | VENV DIR = SCRIPT DIR / ".venv" | | | VENV PYTHON = VENV DIR / "Scripts/python.exe" if os.name == "nt" else "bin/python" | | | USAGE TEXT = | | | "Export DeepSeek shared conversations to Markdown/JSON/text.\n" | | | "Run with -h for full help." | | | | | | def find uv - str | None: | | | return shutil.which "uv" | | | def install uv - bool: | | | print " boot uv is not installed.", flush=True | | | answer = input "Install uv now? Y/n " .strip .lower | | | if answer and answer = "y": | | | print "Aborted. Install uv manually: curl -LsSf https://astral.sh/uv/install.sh | sh" | | | return False | | | print " boot Installing uv …", flush=True | | | try: | | | subprocess.check call | | | "curl", "-LsSf", "https://astral.sh/uv/install.sh", "|", "sh" , | | | cwd= SCRIPT DIR, | | | | | | except Exception: | | | curl ... | sh doesn't work via subprocess.check call, use shell | | | subprocess.check call "curl -LsSf https://astral.sh/uv/install.sh | sh", shell=True | | | if not find uv : | | | print " boot uv installation failed. Install manually: curl -LsSf https://astral.sh/uv/install.sh | sh" | | | return False | | | return True | | | def ensure venv : | | | """Create venv + install deps if missing, then re-exec inside it.""" | | | if sys.prefix = sys.base prefix: | | | return already inside a venv | | | print USAGE TEXT, flush=True | | | print flush=True | | | uv = find uv | | | if not uv: | | | if not install uv : | | | sys.exit 1 | | | uv = find uv | | | if not uv: | | | sys.exit 1 | | | if not VENV PYTHON.exists : | | | print " boot Creating .venv …", flush=True | | | subprocess.check call uv, "venv", str VENV DIR , cwd= SCRIPT DIR | | | print " boot Installing dependencies …", flush=True | | | subprocess.check call | | | uv, "pip", "install", "--python", str VENV PYTHON , "requests" , | | | cwd= SCRIPT DIR, | | | | | | os.execv str VENV PYTHON , str VENV PYTHON , sys.argv | | | ensure venv | | | ── end bootstrap ──────────────────────────────────────────────────────────── | | | import argparse | | | import json | | | import re | | | from datetime import datetime, timezone | | | import requests | | | --------------------------------------------------------------------------- | | | Helpers | | | --------------------------------------------------------------------------- | | | SHARE URL RE = re.compile | | | r" ?:https?://chat\.deepseek\.com ?/share/ ?P<id A-Za-z0-9 - + " | | | | | | def extract share id raw: str - str: | | | m = SHARE URL RE.search raw | | | if m: | | | return m.group "id" | | | if re.fullmatch r" A-Za-z0-9 - {6,}", raw : | | | return raw | | | raise ValueError f"Cannot extract share id from: {raw}" | | | HEADERS = { | | | "accept": "application/json, text/plain, / ", | | | "accept-language": "en-US,en;q=0.9", | | | "referer": "https://chat.deepseek.com/", | | | "user-agent": | | | "Mozilla/5.0 X11; Linux x86 64 AppleWebKit/537.36 " | | | " KHTML, like Gecko Chrome/136.0.0.0 Safari/537.36" | | | , | | | } | | | --------------------------------------------------------------------------- | | | Strategy 1 — plain requests works when WAF is not aggressive | | | --------------------------------------------------------------------------- | | | def fetch via requests share id: str, token: str | None = None - dict: | | | s = requests.Session | | | s.headers.update HEADERS | | | s.get "https://chat.deepseek.com/", timeout=15 | | | if token: | | | s.headers "authorization" = f"Bearer {token}" | | | url = f"https://chat.deepseek.com/api/v0/share/content?share id={share id}" | | | r = s.get url, timeout=15 | | | r.raise for status | | | data = r.json | | | if data.get "code" = 0: | | | raise RuntimeError f"API error: {data.get 'msg', data }" | | | return data | | | --------------------------------------------------------------------------- | | | Strategy 2 — Playwright headless browser bypasses WAF reliably | | | --------------------------------------------------------------------------- | | | def fetch via playwright share id: str, token: str | None = None - dict: | | | try: | | | from playwright.sync api import sync playwright | | | except ImportError: | | | raise RuntimeError | | | "playwright not installed. Run:\n" | | | " uv pip install playwright && uv run playwright install chromium" | | | | | | captured = {} | | | def on response response : | | | if "/api/v0/share/content" in response.url: | | | try: | | | captured "data" = response.json | | | except Exception: | | | pass | | | with sync playwright as p: | | | browser = p.chromium.launch headless=True | | | ctx = browser.new context | | | user agent=HEADERS "user-agent" , | | | viewport={"width": 1280, "height": 800}, | | | | | | page = ctx.new page | | | page.on "response", on response | | | if token: | | | ctx.add cookies { | | | "name": "ds session id", | | | "value": token, | | | "domain": "chat.deepseek.com", | | | "path": "/", | | | } | | | page.goto | | | f"https://chat.deepseek.com/share/{share id}", | | | wait until="networkidle", | | | timeout=30000, | | | | | | page.wait for timeout 3000 | | | browser.close | | | if not captured.get "data" : | | | raise RuntimeError "Playwright could not capture the share API response" | | | data = captured "data" | | | if data.get "code" = 0: | | | raise RuntimeError f"API error: {data.get 'msg', data }" | | | return data | | | --------------------------------------------------------------------------- | | | Main fetch tries requests first, falls back to playwright | | | --------------------------------------------------------------------------- | | | def fetch share share id: str, token: str | None = None - dict: | | | try: | | | print " 1/2 Trying direct API…", end=" ", flush=True | | | data = fetch via requests share id, token | | | print "OK" | | | return data | | | except Exception as e: | | | print f"failed {e} " | | | print " 2/2 Falling back to Playwright…", end=" ", flush=True | | | try: | | | data = fetch via playwright share id, token | | | print "OK" | | | return data | | | except Exception as e: | | | print f"failed {e} " | | | raise RuntimeError | | | "Both strategies failed. If WAF is blocking you, install Playwright:\n" | | | " uv pip install playwright && uv run playwright install chromium\n" | | | "Or pass your token with --token." | | | | | | --------------------------------------------------------------------------- | | | Formatting | | | --------------------------------------------------------------------------- | | | def ts ts - str: | | | if not ts: | | | return "" | | | try: | | | return datetime.fromtimestamp ts, tz=timezone.utc .strftime "%Y-%m-%d %H:%M:%S UTC" | | | except Exception: | | | return str ts | | | def to markdown data: dict - str: | | | biz = data.get "data", {} .get "biz data", {} | | | messages = biz.get "messages", or biz.get "chat messages", | | | title = biz.get "title" or "DeepSeek Conversation" | | | model = biz.get "model type" or biz.get "model" or "" | | | parts = f" {title}\n" | | | if model: | | | parts.append f" Model: {model}" | | | parts.append "" | | | if not messages: | | | parts.append " No messages found. \n" | | | return "\n".join parts | | | for msg in messages: | | | role = msg.get "role" or "" .upper | | | content = msg.get "content" or msg.get "message" or "" | | | if not content and not role: | | | continue | | | thinking = msg.get "thinking content" or msg.get "reasoning content" or "" | | | elapsed = msg.get "thinking elapsed secs" | | | search = msg.get "search results" or | | | if role == "USER": | | | header = "You" | | | elif role in "ASSISTANT", "AI" : | | | header = "DeepSeek" | | | elif role == "SYSTEM": | | | header = "System" | | | else: | | | header = role.title | | | parts.append f" {header}\n" | | | if thinking: | | | label = f"Thinking {elapsed}s " if elapsed else "Thinking" | | | parts.append f"<details <summary {label}</summary \n\n{thinking}\n\n</details \n" | | | if search: | | | refs = | | | for item in search: | | | t = item.get "title" or "" | | | u = item.get "url" or "" | | | if u: | | | refs.append f"- {t} {u} " if t else f"- {u}" | | | if refs: | | | parts.append " Sources: \n" + "\n".join refs + "\n" | | | if content: | | | parts.append f"{content}\n" | | | parts.append "---\n" | | | return "\n".join parts | | | def to plain text data: dict - str: | | | biz = data.get "data", {} .get "biz data", {} | | | messages = biz.get "messages", or biz.get "chat messages", | | | title = biz.get "title" or "DeepSeek Conversation" | | | parts = f"=== {title} ===\n" | | | for msg in messages: | | | role = msg.get "role" or "" .upper | | | content = msg.get "content" or msg.get "message" or "" | | | thinking = msg.get "thinking content" or msg.get "reasoning content" or "" | | | if role == "USER": | | | parts.append f" User \n{content}\n" | | | elif role in "ASSISTANT", "AI" : | | | if thinking: | | | parts.append f" Thinking \n{thinking}\n" | | | parts.append f" DeepSeek \n{content}\n" | | | else: | | | parts.append f" {role} \n{content}\n" | | | return "\n".join parts | | | --------------------------------------------------------------------------- | | | CLI | | | --------------------------------------------------------------------------- | | | class ArgumentParser argparse.ArgumentParser : | | | def error self, message : | | | self.print usage sys.stderr | | | sys.stderr.write "\n" | | | sys.stderr.write f"{self.prog}: error: {message}\n" | | | sys.exit 2 | | | def main : | | | ap = ArgumentParser | | | description="Export a DeepSeek shared conversation", | | | epilog="Example: % prog s https://chat.deepseek.com/share/nvy7v2ps1r6e2wyoyj", | | | | | | ap.add argument "link", help="Share URL or share ID" | | | ap.add argument "-o", "--output", help="Output file path default: auto-named " | | | ap.add argument "--json", action="store true", help="Dump raw JSON instead of Markdown" | | | ap.add argument "--txt", action="store true", help="Dump plain text" | | | ap.add argument "--token", help="Bearer token for auth optional, needed for private shares " | | | args = ap.parse args | | | share id = extract share id args.link | | | print f"Share ID: {share id}" | | | data = fetch share share id, args.token | | | if args.output: | | | out = Path args.output | | | elif args.json: | | | out = Path f"export {share id}.json" | | | elif args.txt: | | | out = Path f"export {share id}.txt" | | | else: | | | out = Path f"export {share id}.md" | | | if args.json: | | | content = json.dumps data, indent=2, ensure ascii=False | | | elif args.txt: | | | content = to plain text data | | | else: | | | content = to markdown data | | | out.write text content, encoding="utf-8" | | | print f"Saved to {out} {len content } bytes " | | | if name == " main ": | | | main |