clipsmith-xlisted

# clipsmith-x > **MANDATORY — load `references/plan.md` before any browser or extraction action begins.** ## ⚠️ NEVER WRITE YOUR OWN SCRIPT **The download logic is fully implemented. Always invoke the existing script — do NOT write a new one.** ```bash cd <clipsmith-repo>/skills/clipsmith-x npx tsx scripts/run.ts \ --post-url "<url>" \ --output-dir "$HOME/Downloads/x" ``` The sections below (image extraction, anti-detection, MHTML generation) are **implementation documentation for the script itself**, not instructions for you to re-implement. If the script doesn't exist or can't run, report the error — never substitute with hand-written Playwright code. ## Clipsmith Bundle Normalization The copied downloader produces a raw post folder with `post.md`, images, optional video, and optional MHTML. Before finalizing a Clipsmith capture job, convert that raw folder into a bundle with the shared normalizer: ```bash cd <clipsmith-repo> uv run clipsmith normalize raw x "<raw_dir>" "<bundle_dir>" \ --source-url "<original_url>" \ --canonical-url "<canonical_url>" \ --title "<title>" \ --author "<author>" \ --captured-at "<iso8601_time>" \ --json uv run clipsmith validate-bundle "<bundle_dir>" --json ``` The normalizer keeps `post.md`, creates or copies `summary.md`, preserves `ocr.md`/`ocr.txt` as `kind: "ocr-text"` if present, and writes `capture.json`. It intentionally does not copy downloaded media or MHTML into the final bundle because the bundle validator