read-claude-web-conversation
Reads or exports the COMPLETE transcript of a Claude.ai web conversation — private /chat/... and public /share/... links — via Claude.ai's internal API in the user's logged-in Chrome, plus its files
Install / Use
npx skills add daymade/claude-code-skills --skill read-claude-web-conversationInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
MarketingSupported Platforms
Our assessment of read-claude-web-conversation
read-claude-web-conversation scores 93/100 on our quality scale, 147th of 642 Marketing skills we index (top 23%).
Its SKILL.md is 25 KB long, well organised into 20 sections with 11 code examples: a thorough specification that gives an agent plenty to work with.
With 1,426 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so read-claude-web-conversation is actively maintained.
- Our last check on 2026-10-26 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-04. Automated pattern scan on 2026-10-04. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
read-claude-web-conversation compared with similar skills
All 4 of these similar skills score higher than read-claude-web-conversation; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| read-claude-web-conversation (this skill)by daymade | 93 | 1.4k | 53d ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| Scraplingby D4Vinci | 100 | 103.6k | 2d ago | MCP Server |
| crawl4aiby unclecode | 100 | 87.4k | 3d ago | MCP Server |
Frequently asked questions
- How do I install read-claude-web-conversation?
- Run
npx skills add daymade/claude-code-skills --skill read-claude-web-conversation. The install tabs above show the steps for each supported agent. - Which AI agents does read-claude-web-conversation work with?
- It is written for Claude Code, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is read-claude-web-conversation safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is read-claude-web-conversation still maintained?
- The repository was last updated about 2 months ago, so read-claude-web-conversation is actively maintained.
Skill content
View source on GitHubname: read-claude-web-conversation description: >- Reads or exports the COMPLETE transcript of a Claude.ai web conversation — private /chat/... and public /share/... links — via Claude.ai's internal API in the user's logged-in Chrome, plus its files. Use when the user pastes a claude.ai link and asks to read, summarize, export, archive, or extract it — "读这个对话", "导出网页版对话", "拉到本地". Local sessions: read-claude-code-history; exported files: claude-export-txt-better.
Read Claude.ai Web Conversation
Pull a Claude.ai web conversation into a full, structured transcript — every message and every tool call, not just what is currently on screen.
Verified against Claude.ai's web API as of July 2026. These are the same private JSON endpoints the Claude.ai front-end calls; they are not a documented or version-stable public API, so if a request 404s, re-derive the shape from the Network tab (see references/claude-web-api-extraction.md).
This skill vs. its siblings
Pick by the source you are holding, not by the word "conversation":
| Source | Use |
|--------|-----|
| A live claude.ai/chat/… or claude.ai/share/… URL | This skill |
| Local Claude Code sessions (~/.claude/projects/*.jsonl) | read-claude-code-history |
| An already-exported .txt / .json conversation file | claude-export-txt-better |
Why the obvious approaches fail (read this first)
Four traps, and every one of them fails silently — you get back something that looks like a complete export, and you only notice the loss if you happen to know how long the conversation really was. Assume you are being lied to by default; the fidelity gate in Step 4 exists to make the lies audible.
- Login wall.
curlandWebFetchdon't get an auth redirect — they get a Cloudflare challenge page (HTTP 403,Just a moment...). Nothing you do to the headers fixes this; the page is gated on a session that lives in the user's Chrome. Never reach for curl here, not even to "just check". - Virtual scrolling. With the conversation open,
get_page_textand DOM scraping still only see the handful of messages currently rendered — often just the last one. A 40-message thread comes back as 1. - Default rendering collapses the tool calls. The API's default rendering
turns every tool call into a "not supported on your current device"
placeholder. On a research/agent conversation the tool blocks ARE the content:
measured on a real one, the default rendering returned 9.4k chars against
173k with
render_all_tools=true— 5%. Always request the full rendering. - A /chat/-shaped renderer silently drops /share/ blocks. A share payload
returns web_search hits as
knowledgeitems, nottextitems. A renderer that only knowstextreturns the empty string for them and reports no error — the same real conversation rendered to 8k chars instead of 146k (4.8% retention) and looked completely fine.
The reliable path: run JavaScript inside the user's logged-in page and let
fetch inherit the session cookie, then render locally through the fidelity gate.
Step 0 — Choose an injection channel
Three channels can execute JS inside the user's page. They differ only in plumbing, and each fails in its own way, so pick in this order and verify rather than assume.
| Order | Channel | Use when | Fails when |
|-------|---------|----------|-----------|
| 1 | claude-in-chrome extension | list_connected_browsers returns a browser | Returns [] → the extension's claude.ai login ≠ the Claude Code account. This is structural — retrying, reinstalling, and switch_browser all fail. Move on immediately. |
| 2 | CDP (scripts/cdp_channel.py probe) | probe says available: true — then it is the best channel there is | Usually unavailable, and that is normal, not a malfunction — see below. Probe is cheap; believe its answer and move on. |
| 3 | AppleScript (macOS only) | The realistic fallback when the extension can't pair | See the routing trap below — check for it BEFORE blaming the user |
| ✗ | curl / WebFetch | never | Cloudflare 403. There is no header that fixes it. |
⚠️ Expect CDP to be unavailable, and never try to force it. Since Chrome 136
(April 2025) the debugging port is ignored on the default user-data-dir — a
deliberate hardening against malware that used CDP to steal cookies. You may still
find a listening socket and a stale DevToolsActivePort on disk while the
WebSocket handshake is never answered and /json/* returns 404.
And its availability flaps. Verified on Chrome 150, one machine, one browser session: the endpoint worked, then stopped answering entirely, then answered again — with no restart in between. So probe every time and never cache the verdict. "CDP worked five minutes ago" is not evidence that it works now, and "CDP failed once" is not evidence that this machine can't use it. The probe is cheap precisely so you can afford to re-ask.
The trap is what you'll be tempted to do next. Every fix on the web says "relaunch
Chrome with --user-data-dir=/tmp/whatever". For this skill that is worse than
useless: a fresh profile is signed out, and a signed-out browser cannot read a
single one of the user's conversations. The session you need lives in precisely
the profile Chrome is refusing to expose. So probe, take the answer, and fall
back — never reconfigure or relaunch the user's browser to chase a port.
CDP does work when Chrome was deliberately started on a non-default
--user-data-dir and is signed into claude.ai. That happens, and when it does
this channel beats the others outright (no menu toggle, immune to the Apple Events
capture below, enumerates every tab, returns the whole payload on stdout). That is
why it is worth one cheap probe before falling through.
To try channel 1, load the extension's tools in a single ToolSearch call
(they are deferred; the API path needs no get_page_text / read_page):
ToolSearch: select:mcp__claude-in-chrome__tabs_context_mcp,mcp__claude-in-chrome__navigate,mcp__claude-in-chrome__javascript_tool
then call list_connected_browsers. An empty list is the account mismatch — go to
channel 2 rather than retrying.
To try channel 2:
uv run --with websockets python scripts/cdp_channel.py probe
probe answers three questions at once: is CDP available, is it pointed at the
user's real browser (page count, and any claude.ai tabs already open), and are
there multiple Chrome instances running. Its output drives everything below —
including the AppleScript decision, since the chrome_instances.automation list is
what tells you whether Apple Events will even reach the right browser.
Exit codes are a contract, so you never have to guess whether to fall back:
| code | meaning | what to do |
|------|---------|-----------|
| 0 | worked | continue |
| 1 | bad input (unreadable --js, etc.) | fix the call |
| 2 | TAB_NOT_FOUND | use open, or ask the user to open the page |
| 3 | CDP unusable | fall back to another channel — this is the normal outcome |
| 4 | the browser answered with an error | the command was wrong, or the tab vanished mid-call; falling back won't help |
Exit 3 still prints chrome_instances, because that part needs no debugging port.
It is a routing fact, not an error: read it, fall through to channel 3, and say
nothing to the user about debugging ports.
The AppleScript routing trap (read before you blame the user)
AppleScript addresses Chrome by bundle id. If a second Chrome instance is
running — chrome-devtools-mcp, puppeteer, playwright, anything launched with its
own --user-data-dir — Apple Events can land on that instance instead, and
macOS gives you no way to target the first one by pid. There is no workaround.
What makes this genuinely dangerous is how it presents: the automation profile
has "Allow JavaScript from Apple Events" switched off, so your JS attempt fails
with "Executing JavaScript through AppleScript is turned off" — and you will
conclude the user forgot a menu toggle, and go ask them to flip it, while their
real browser had it enabled the whole time. Observed exactly this: AppleScript
reported windows=1 tabs=1 while the user's actual Chrome had 35 tabs open.
So before falling back to AppleScript, run probe (or chrome_instances() from
cdp_channel.py) and read the automation list. If it is non-empty, say so
plainly — "an automation Chrome is holding the Apple Events route, so
AppleScript will hit the wrong browser" — and either use CDP, or ask whether
that instance can be closed. Do not relay a toggle error you cannot attribute.
Channel details and the base64 binary bridge: references/applescript_fallback_channel.md.
Step 1 — Identify the account case (this decides what you can even get)
How much of the conversation exists for you to fetch depends on whose account the browser is signed into. Establish this early — it is the difference between a complete archive and one with unrecoverable holes, and the user deserves to know which they are getting before you hand it over.
| Case | Signal | What you can get |
|------|--------|------------------|
| A · Not signed in | /api/organizations returns no org | Nothing for /chat/ links. Stop and ask the user to sign into claude.ai in Chrome — never automate a login. |
| B · Signed in, conversation belongs to this account | GET .../chat_conversations/<conversation-id> returns 200 | Everything, including the content of uploaded attachments. Prefer this path whenever it is available. |
| C · Signed in, but it's someone else's share link | the conversation fetch 404s; the snapshot's creator ≠ this account | The snapshot only. The platform strips the arguments and results of every tool call that touched the sharer's uploads. Unrecoverable from that link. |
For a /share/… link, the snapshot payload itself tells you which case you're
in: it carries conversation_uuid (the original) and creator. So fetch the
snapshot first, then try the original with that conversation_uuid — if it
200s you are in case B and should re-export from there, because the snapshot is
strictly lossier. If it 404s, you are in case C: say so out loud, and let the
render step disclose the gaps in the transcript header (it does this on its own).
Case C's holes are real and worth naming precisely, because they look like a bug
in your export when they are not: a view of an uploaded file keeps its name but
loses its path and the file's entire content. The user's own copy of that file
is usually sitting on their disk — the export isn't broken, it just cannot speak
for a file the platform declined to share.
Step 2 — Open the conversation
Extension: tabs_context_mcp with { "createIfEmpty": true }, then navigate.
CDP: cdp_channel.py open --url <url> (reuses an existing tab; waits out the
Cloudflare interstitial, which the browser clears by itself).
Either way, confirm it actually loaded and is logged in — the tab title should be the conversation's name, not "Log in". If you land on a login page, stop and tell the user; do not automate a login.
Step 3 — Fetch the payload
Always request the full tool rendering. Without render_all_tools=true you
get placeholders where the analysis was (trap 3 above).
| Link type | Endpoint |
|-----------|----------|
| /chat/<conversation-id> | GET /api/organizations/<org-uuid>/chat_conversations/<conversation-id>?tree=True&rendering_mode=messages&render_all_tools=true |
| /share/<snapshot-id> | GET /api/chat_snapshots/<snapshot-id>?rendering_mode=messages&render_all_tools=true |
Note the share endpoint keys on the snapshot id from the URL, which is not the conversation id — feeding
Truncated for display — read the full file on GitHub.
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Scrapling
103.6k🕷️ The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev
crawl4ai
87.4kOfficial Crawl4AI Cloud: a hosted web scraping, extraction, and search API for AI agents. Free API key, 1,000 credits a month, no card. Fully open source: this repo is the Apache-2.0 crawler that powers it, and you can self-host it.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
