| name | grok-share |
| description | Read full public Grok online chat sessions from grok.com/share or x.com/i/grok/share URLs using Safari (authenticated session on this Mac). Use when the user shares a Grok conversation link, asks to read/import/sync/retrieve an online Grok chat transcript, says "get the full Grok share", "read this grok.com/share", runs /grok-share or /read-grok-share, or needs online session content for research. Happy path: ~/.grok/skills/safari-browser/scripts/safari_read_page.sh — NOT Playwright. Do NOT use web_fetch, curl, or x-api alone for transcripts. Complements local ~/.grok/sessions for CLI sessions.
|
| metadata | {"short-description":"Extract full grok.com/share conversation transcripts","version":"1.0.0","canonical-phoenix-skill":"/Users/velocityworks/IdeaProjects/phoenix/.grok/skills/grok-share/SKILL.md"} |
Grok Share Reader (global)
Extract full conversation turns from public Grok share links.
Non-negotiable access path (this Mac)
| Method | Result |
|---|
web_fetch / curl | SPA shell — title only, no turns |
| x-api MCP | Post metadata / preview — not full transcript |
Playwright read_share.sh | Works but deprecated here — use Safari instead |
safari_read_page.sh (safari-browser skill) | Happy path — clean innerText in ~13s |
bash "$HOME/.grok/skills/safari-browser/scripts/safari_read_page.sh" \
'<grok-share-url>' --output experiments/<topic>/safari_transcript.txt --wait 12
Always use the Safari happy path on this machine. Never guess DOM selectors ad hoc.
Supported URL forms
https://grok.com/share/bGVnYWN5_<uuid>https://x.com/i/grok/share/<id> (X-hosted share page; same conversation)
Quick usage
GROK_SHARE="$HOME/.grok/skills/grok-share/scripts/read_share.sh"
bash "$GROK_SHARE" 'https://grok.com/share/bGVnYWN5_...'
bash "$GROK_SHARE" 'https://grok.com/share/...' \
--output experiments/my-topic/grok_share_transcript.md
bash "$GROK_SHARE" 'https://grok.com/share/...' --json
Slow networks / heavy pages:
GROK_SHARE_WAIT_SECONDS=12 GROK_SHARE_POLL_ATTEMPTS=20 \
bash "$GROK_SHARE" '<url>'
Optional: set PWCLI to ~/.grok/skills/playwright/scripts/playwright_cli.sh when available.
Agent workflow
When the user provides a Grok share URL or asks for online chat content:
- Do not start with
web_fetch or x-api for the transcript body.
- Run
read_share.sh with the URL. Add --output when the project should keep a durable artifact (prefer experiments/<topic>/ or docs/ under the active repo).
- Read the Markdown or JSON output as ground truth for the conversation.
- If extraction fails, retry once with higher
GROK_SHARE_WAIT_SECONDS / GROK_SHARE_POLL_ATTEMPTS.
- Only then summarize, advance research, or align repo work to the extracted turns.
x-api complementary role
Use x-api after or beside share extraction when you need:
- who posted or linked a share on X
- tweet context, thread replies, or outreach targets
- title/description preview from
x.com/i/grok/share/ links embedded in posts
x-api does not replace read_share.sh for full transcripts.
Output shape
Markdown (default):
- Title, source URL, extraction timestamp, turn count
## Turn N — User|Grok sections with full text
JSON (--json):
title, url, extracted_at, turn_count, turns[] with role + text
Script files
| File | Role |
|---|
scripts/read_share.sh | Entry point |
scripts/extract.js | DOM extraction (update if grok.com layout changes) |
scripts/parse_playwright_result.py | Parse playwright-cli eval output |
scripts/to_markdown.py | JSON → Markdown formatter |
Requirements
npx (installs @playwright/cli on demand via npx --yes)python3
Limits
- Public share links only. Private chats need a share link or manual export.
- Read-only. Cannot continue the online thread from this tool.
- Layout coupling. Targets current grok.com share DOM. If xAI changes the page, update
extract.js.
Local CLI sessions (alternate path)
For sessions run in Grok CLI on this machine, read disk state directly:
grok sessions list
grok sessions search "keyword"
Use grok-share for online shared sessions; use ~/.grok/sessions/ for local CLI sessions.
