{"_id":"@mcpware/pagecast","_rev":"6-a94e7e561dd8a6bc0aa5d8cf4e6fe7f9","name":"@mcpware/pagecast","dist-tags":{"latest":"0.2.1"},"versions":{"0.1.0":{"name":"@mcpware/pagecast","version":"0.1.0","keywords":["mcp","pagecast","screen-recorder","playwright","gif","video","recording","demo","screencast","webm","browser","automation"],"author":{"name":"mcpware"},"license":"MIT","_id":"@mcpware/pagecast@0.1.0","maintainers":[{"name":"ithiria","email":"ithiriaca@gmail.com"}],"homepage":"https://github.com/mcpware/pagecast#readme","bugs":{"url":"https://github.com/mcpware/pagecast/issues"},"bin":{"pagecast":"src/index.js"},"dist":{"shasum":"41171cb44a28e2b48d55bc8544a0c686f39249ef","tarball":"https://registry.npmjs.org/@mcpware/pagecast/-/pagecast-0.1.0.tgz","fileCount":6,"integrity":"sha512-gQfoxjbmUHiDz+SdHLXMwJJtdbw2hucFavJJ0FnsVW3H8Yxf++y/Aq0YApsYvqF9ZeZ6supOJPsvoQsVTeyMEw==","signatures":[{"sig":"MEUCIQCXuVuoucBnNYkt0wB3wg44O8blCR87SP2jabBLlHex7QIgVxn9Wy+SWuaigsDs6USTRzInu14vgSsZZwxXR8TyXEo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":22938},"type":"module","engines":{"node":">=20.0.0"},"gitHead":"775bbba29582951b23a21dc36b2336a4ca843d19","mcpName":"io.github.mcpware/pagecast","scripts":{"dev":"node --watch src/index.js","start":"node src/index.js","postinstall":"npx playwright install chromium 2>/dev/null || true"},"_npmUser":{"name":"ithiria","email":"ithiriaca@gmail.com"},"repository":{"url":"git+https://github.com/mcpware/pagecast.git","type":"git"},"_npmVersion":"10.8.2","description":"Record any browser page as GIF or video via MCP — powered by Playwright + ffmpeg","directories":{},"_nodeVersion":"20.19.4","dependencies":{"zod":"^3.23.0","playwright":"^1.52.0","@modelcontextprotocol/sdk":"^1.27.1"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/pagecast_0.1.0_1773975071513_0.1076865877366282","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@mcpware/pagecast","version":"0.1.1","keywords":["mcp","mcp-server","pagecast","screen-recorder","screen-recording","playwright","gif","gif-recorder","video","recording","demo","screencast","webm","browser","automation","documentation","claude","model-context-protocol"],"author":{"name":"mcpware"},"license":"MIT","_id":"@mcpware/pagecast@0.1.1","maintainers":[{"name":"ithiria","email":"ithiriaca@gmail.com"}],"homepage":"https://github.com/mcpware/pagecast#readme","bugs":{"url":"https://github.com/mcpware/pagecast/issues"},"bin":{"pagecast":"src/index.js"},"dist":{"shasum":"d133160ebd0c82926c39ebf06a857f75b9d176bd","tarball":"https://registry.npmjs.org/@mcpware/pagecast/-/pagecast-0.1.1.tgz","fileCount":15,"integrity":"sha512-06Q1oaIMf+Nlcnn2LL1SGuTspCcsaU9RglqkgKMWXkyxm9Q8P2D+ptDbtxtVsAnFOVfSkb0cH4b1yQOYjh9D/A==","signatures":[{"sig":"MEYCIQDT0leZuiOp6wMhOsH83+LRi00RPPRDrIn83aNvd5uJwAIhAOayHn/5cQ1rN+Dd1zcLqufjichghn7JIAl1251f0mFZ","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":4075770},"type":"module","engines":{"node":">=20.0.0"},"gitHead":"64fcde7110863b5b1a18f65a12efc5afb28704a0","mcpName":"io.github.mcpware/pagecast","scripts":{"dev":"node --watch src/index.js","start":"node src/index.js","postinstall":"npx playwright install chromium 2>/dev/null || true"},"_npmUser":{"name":"ithiria","email":"ithiriaca@gmail.com"},"repository":{"url":"git+https://github.com/mcpware/pagecast.git","type":"git"},"_npmVersion":"10.8.2","description":"Record any browser page as GIF or video via MCP — powered by Playwright + ffmpeg","directories":{},"_nodeVersion":"20.19.4","dependencies":{"zod":"^3.23.0","playwright":"^1.52.0","@modelcontextprotocol/sdk":"^1.27.1"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/pagecast_0.1.1_1773975975890_0.9592217509996463","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@mcpware/pagecast","version":"0.1.2","keywords":["mcp","mcp-server","pagecast","screen-recorder","screen-recording","playwright","gif","gif-recorder","video","recording","demo","screencast","webm","browser","automation","documentation","claude","model-context-protocol"],"author":{"name":"mcpware"},"license":"MIT","_id":"@mcpware/pagecast@0.1.2","maintainers":[{"name":"ithiria","email":"ithiriaca@gmail.com"}],"homepage":"https://github.com/mcpware/pagecast#readme","bugs":{"url":"https://github.com/mcpware/pagecast/issues"},"bin":{"pagecast":"src/index.js"},"dist":{"shasum":"f4a5ea8c506fe67b8b517ecc0adb174e4061a47c","tarball":"https://registry.npmjs.org/@mcpware/pagecast/-/pagecast-0.1.2.tgz","fileCount":17,"integrity":"sha512-F0dVdZjLIS1NxjtaFsD1U4s5kre3v00b48Yq8jA2pweM+Mhy5mfzOMqv/chiMuKob9TQkjy8K5cl3rB50usJyQ==","signatures":[{"sig":"MEUCICXlYqaGnqfUTS1pXzQ7GbV6fDDqslRkuPRfUXAmnN62AiEAuFZd/HD5FMgJMBCXbmKA5CFRy9FBTIZNot2eQIrueHs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":4076770},"type":"module","engines":{"node":">=20.0.0"},"gitHead":"1f4c5fcc66fee93153ca28447be71a63d21b9f44","mcpName":"io.github.mcpware/pagecast","scripts":{"dev":"node --watch src/index.js","start":"node src/index.js","postinstall":"npx playwright install chromium 2>/dev/null || true"},"_npmUser":{"name":"ithiria","email":"ithiriaca@gmail.com"},"repository":{"url":"git+https://github.com/mcpware/pagecast.git","type":"git"},"_npmVersion":"10.8.2","description":"Record any browser page as GIF or video via MCP — powered by Playwright + ffmpeg","directories":{},"_nodeVersion":"20.19.4","dependencies":{"zod":"^3.23.0","playwright":"^1.52.0","@modelcontextprotocol/sdk":"^1.27.1"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/pagecast_0.1.2_1773976382747_0.961870370692882","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@mcpware/pagecast","version":"0.1.3","keywords":["mcp","mcp-server","pagecast","screen-recorder","screen-recording","playwright","gif","gif-recorder","video","recording","demo","screencast","webm","browser","automation","documentation","claude","model-context-protocol"],"author":{"name":"mcpware"},"license":"MIT","_id":"@mcpware/pagecast@0.1.3","maintainers":[{"name":"ithiria","email":"ithiriaca@gmail.com"}],"homepage":"https://github.com/mcpware/pagecast#readme","bugs":{"url":"https://github.com/mcpware/pagecast/issues"},"bin":{"pagecast":"src/index.js"},"dist":{"shasum":"4cea7845131f5d22fcd78f1f3d6588ef3d520550","tarball":"https://registry.npmjs.org/@mcpware/pagecast/-/pagecast-0.1.3.tgz","fileCount":24,"integrity":"sha512-pqR25R3rdTy9ieN+fhFp6nd14uL0onb9KxmLY4xdXknLXeQudGipFYFCioypp9iRXriywUvzb5+9HkHZK+C2jg==","signatures":[{"sig":"MEYCIQDoD1ddoGO5WbM+Q57KM4RhXnfQ/eekOOGuvNmTjLeo5QIhANAOHcTewyomuegm6qqCyGF+ZH+8qlNBD5CWJ24JsIDw","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":11924250},"type":"module","engines":{"node":">=20.0.0"},"gitHead":"4fc0a3d64e0c364df8f590b7fdf2ad0a148f95f2","mcpName":"io.github.mcpware/pagecast","scripts":{"dev":"node --watch src/index.js","start":"node src/index.js","postinstall":"npx playwright install chromium 2>/dev/null || true"},"_npmUser":{"name":"ithiria","email":"ithiriaca@gmail.com"},"repository":{"url":"git+https://github.com/mcpware/pagecast.git","type":"git"},"_npmVersion":"10.8.2","description":"Record any browser page as GIF or video via MCP — powered by Playwright + ffmpeg","directories":{},"_nodeVersion":"20.19.4","dependencies":{"zod":"^3.23.0","playwright":"^1.52.0","@modelcontextprotocol/sdk":"^1.27.1"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/pagecast_0.1.3_1773976822365_0.4608268803309141","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@mcpware/pagecast","version":"0.2.0","keywords":["mcp","mcp-server","pagecast","screen-recorder","screen-recording","playwright","gif","gif-recorder","video","recording","demo","screencast","webm","browser","automation","documentation","claude","model-context-protocol"],"author":{"name":"mcpware"},"license":"MIT","_id":"@mcpware/pagecast@0.2.0","maintainers":[{"name":"ithiria","email":"ithiriaca@gmail.com"}],"homepage":"https://github.com/mcpware/pagecast#readme","bugs":{"url":"https://github.com/mcpware/pagecast/issues"},"bin":{"pagecast":"src/index.js"},"dist":{"shasum":"6260fc34c913f094ce51401741f1fccd30a81c7c","tarball":"https://registry.npmjs.org/@mcpware/pagecast/-/pagecast-0.2.0.tgz","fileCount":45,"integrity":"sha512-flUMy0Q5i5DYUy6FU4t35QszXQrQp3K0w5XUD48iBIpIXGmbAwvnKAbund5gL5BOqnEznj5+3nP73pxo9W9swg==","signatures":[{"sig":"MEUCIQDFhTK03G1pgGMmjHSO0Ty8/TOM8BIJQ89iA6KhavTdZgIgbXRfR1lZ6tMDUlNLhCxkuBHS09GtfOzcaCepkq+74f4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":53277095},"type":"module","engines":{"node":">=20.0.0"},"gitHead":"af124f179e83b06d55603dc61bc5f019794e76bd","mcpName":"io.github.mcpware/pagecast","scripts":{"dev":"node --watch src/index.js","start":"node src/index.js","postinstall":"npx playwright install chromium 2>/dev/null || true"},"_npmUser":{"name":"ithiria","email":"ithiriaca@gmail.com"},"repository":{"url":"git+https://github.com/mcpware/pagecast.git","type":"git"},"_npmVersion":"10.8.2","description":"Record any browser page as GIF or video via MCP — powered by Playwright + ffmpeg","directories":{},"_nodeVersion":"20.19.4","dependencies":{"zod":"^3.23.0","playwright":"^1.52.0","@modelcontextprotocol/sdk":"^1.27.1"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/pagecast_0.2.0_1773986784882_0.023802543539923615","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@mcpware/pagecast","version":"0.2.1","description":"Record any browser page as GIF or video via MCP — powered by Playwright + ffmpeg","type":"module","bin":{"pagecast":"src/index.js"},"scripts":{"start":"node src/index.js","dev":"node --watch src/index.js","postinstall":"npx playwright install chromium 2>/dev/null || true"},"keywords":["mcp","mcp-server","pagecast","screen-recorder","screen-recording","playwright","gif","gif-recorder","video","recording","demo","screencast","webm","browser","automation","documentation","claude","model-context-protocol"],"mcpName":"io.github.mcpware/pagecast","author":{"name":"mcpware"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/mcpware/pagecast.git"},"dependencies":{"@modelcontextprotocol/sdk":"^1.27.1","playwright":"^1.52.0","zod":"^3.23.0"},"engines":{"node":">=20.0.0"},"_id":"@mcpware/pagecast@0.2.1","gitHead":"5c093dc69e3211c8749e8b1090ea79181c93abc8","bugs":{"url":"https://github.com/mcpware/pagecast/issues"},"homepage":"https://github.com/mcpware/pagecast#readme","_nodeVersion":"22.22.1","_npmVersion":"10.9.4","dist":{"integrity":"sha512-pNA3szdQtHNPeccsR1YWpoto4fi7KSjM4t83BJ50HjKa3MXkY5yo/gBGcrdndJ5dr52n6gSMcJYWNd/9W9jMbg==","shasum":"cdac443432647f082ad9c1562f70839f4269f8ac","tarball":"https://registry.npmjs.org/@mcpware/pagecast/-/pagecast-0.2.1.tgz","fileCount":20,"unpackedSize":4689948,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIEVzHkFfFSI+sFE9Fikvnd0dufET5L2r12AK9wAJ22XaAiAF1oWKUV8EqVKVWaH02Mu+mNP/bz3KoElODz+Bs2c8Fg=="}]},"_npmUser":{"name":"ithiria","email":"ithiriaca@gmail.com"},"directories":{},"maintainers":[{"name":"ithiria","email":"ithiriaca@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/pagecast_0.2.1_1774090022195_0.757553640086778"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-20T02:51:11.400Z","modified":"2026-03-21T10:47:02.599Z","0.1.0":"2026-03-20T02:51:11.842Z","0.1.1":"2026-03-20T03:06:16.179Z","0.1.2":"2026-03-20T03:13:03.083Z","0.1.3":"2026-03-20T03:20:22.800Z","0.2.0":"2026-03-20T06:06:26.086Z","0.2.1":"2026-03-21T10:47:02.457Z"},"bugs":{"url":"https://github.com/mcpware/pagecast/issues"},"author":{"name":"mcpware"},"license":"MIT","homepage":"https://github.com/mcpware/pagecast#readme","keywords":["mcp","mcp-server","pagecast","screen-recorder","screen-recording","playwright","gif","gif-recorder","video","recording","demo","screencast","webm","browser","automation","documentation","claude","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/mcpware/pagecast.git"},"description":"Record any browser page as GIF or video via MCP — powered by Playwright + ffmpeg","maintainers":[{"name":"ithiria","email":"ithiriaca@gmail.com"}],"readme":"# Pagecast\n\n[![npm version](https://img.shields.io/npm/v/@mcpware/pagecast)](https://www.npmjs.com/package/@mcpware/pagecast)\n[![license](https://img.shields.io/github/license/mcpware/pagecast)](LICENSE)\n[![GitHub stars](https://img.shields.io/github/stars/mcpware/pagecast?style=social)](https://github.com/mcpware/pagecast)\n[![GitHub forks](https://img.shields.io/github/forks/mcpware/pagecast?style=social)](https://github.com/mcpware/pagecast/fork)\n\n[English](README.md) | **廣東話**\n\n**將 AI 操作 browser 嘅過程變成你真正交付得到嘅 GIF 同影片。**\n\n叫你嘅 AI 錄低佢做緊嘅嘢。佢開個 browser，做完件事，然後畀返個 GIF、WebM 或者 MP4 你。你可以實時睇住佢做。\n\n### 下面呢個 demo 係 Pagecast 自己錄自己嘅。係真㗎。\n\n![Moltbook Demo](docs/moltbook-demo.gif)\n\n## 點解要用\n\n你整咗個 web app。你要整個 demo GIF 擺 README。所以你：\n\n1. 開個錄屏工具\n2. 自己手動 click 成個 demo\n3. Export、裁剪、壓縮\n4. UI 改咗 → 全部重嚟\n\n**或者** — 你同你嘅 AI 講：\n\n> 「去 https://myapp.localhost:3000，玩下佢 5 秒鐘然後整個 GIF」\n\nAI call `record_and_gif` → 出 `recordings/recording-{id}.gif`。搞掂。\n\n個 browser **預設係睇得到嘅** — 你可以實時睇住 AI 做嘢。\n\n## 使用場景\n\n| 你講嘅嘢 | AI 做咩 | 輸出 |\n|---|---|---|\n| 「錄低我個 app 整個 demo GIF」 | AI 開 browser，互動，出 GIF | `.gif` |\n| 「登入 dashboard，開 dark mode，錄低成個過程」 | AI 做晒成個流程，全部錄低 | `.webm` `.mp4` |\n| 「Submit 個空白 form，錄低出咩 error」 | AI 做 QA，你之後睇返段片 | `.webm` |\n| 「行一次成個註冊流程，錄條片」 | AI 整 onboarding 文件 | `.mp4` |\n| 「去 Moltbook 出個 post 同時錄低自己做呢件事」 | AI 錄低自己做 marketing 🤯 | `.gif` |\n| 「用 1080x1920 錄我個 app 做 IG Reel」 | AI 用直版格式錄 social media 內容 | `.mp4` |\n\n### 📐 任何 size。任何平台。\n\n用**任何 viewport size** 錄 — AI 開一個真正嘅 browser，你要幾大就幾大：\n\n| 格式 | Size | 用途 |\n|------|------|------|\n| 1280×720 | 16:9 | GitHub README、YouTube、文件 |\n| 1080×1920 | 9:16 | **IG Reels、TikTok、YouTube Shorts** |\n| 1080×1080 | 1:1 | Instagram posts、LinkedIn |\n| 自訂 | 任何 | 你要咩就咩 |\n\n## 快速開始\n\n要有 **Node.js ≥ 20** 同 **ffmpeg**。\n\n```bash\n# 加入 Claude Code\nclaude mcp add pagecast -- npx -y @mcpware/pagecast\n\n# 或者直接跑\nnpx @mcpware/pagecast\n\n# 無頭模式（冇 browser 視窗）\nclaude mcp add pagecast -- npx -y @mcpware/pagecast --headless\n\n# 第一次用：裝 browser\nnpx playwright install chromium\n```\n\n## MCP 工具\n\n| 工具 | 做咩 |\n|------|------|\n| `record_page` | 開一條 URL，開始錄。回傳 session ID |\n| `interact_page` | scroll、click、hover、**打字**、撳掣、揀 dropdown、navigate — 全部錄入去 |\n| `stop_recording` | 停止錄影，儲存 `.webm` |\n| `convert_to_gif` | WebM → 優化 GIF（兩步 palette，可調 FPS/闊度/修剪） |\n| `convert_to_mp4` | WebM → MP4（H.264，社交媒體 / 分享 / 嵌入用） |\n| `record_and_gif` | 一步搞掂：錄 URL N 秒 → GIF |\n| `list_recordings` | 列出所有 `.webm`、`.gif`、`.mp4` 檔案 |\n\n## 點樣運作\n\n```\nAI → MCP 工具 → Playwright（睇得到嘅 browser + 錄影）\n                       ↓\n                  .webm 錄影檔\n                       ↓\n              ffmpeg 兩步 palette 優化\n                       ↓\n               靚嘅 .gif / .mp4\n```\n\n1. `record_page` 開 Chromium，開咗 `recordVideo`\n2. `interact_page` 做動作 — scroll、click、hover、打字、撳掣\n3. `stop_recording` 將影片寫入硬碟\n4. `convert_to_gif` 跑兩步 ffmpeg：先分析所有 frame 整最靚嘅 256 色 palette，再用 Bayer dithering 編碼。質素好過單步好多。\n\n## 對比\n\n| 工具 | 自動化 | 互動 | 輸出 | AI 驅動 |\n|------|:------:|:----:|------|:------:|\n| **Pagecast** | ✅ | ✅ click/打字/scroll/hover | **GIF + WebM + MP4** | ✅ |\n| gifcap.dev | ❌ | ❌ | GIF | ❌ |\n| Peek / ScreenToGif / Kap | ❌ | ❌ | GIF | ❌ |\n| Playwright MCP（官方） | ✅ | ✅ | 只有截圖 | 部分 |\n| playwright-record-mcp | ✅ | ✅ | 只有 WebM | 部分 |\n| VHS (Charmbracelet) | ✅ | 只有 Terminal | GIF | ❌ |\n\nPagecast 係唯一一個做到 **browser 錄影 + AI 互動 + GIF/影片輸出** 嘅 MCP。\n\n## 設定\n\n| 設定 | 預設 | 備註 |\n|------|------|------|\n| Browser | **睇得到**（headed） | `--headless` 背景錄影 |\n| GIF FPS | 10 | 越高越順但越大 |\n| GIF 闊度 | 640px | 高度自動縮放 |\n| 錄影 viewport | 1280×720 | 出 GIF 時會縮細 |\n| 輸出目錄 | `./recordings` | 用 `RECORDING_OUTPUT_DIR` 改 |\n\n## 架構\n\n```\nsrc/\n├── index.js       # MCP server — 7 個工具，stdio transport\n├── recorder.js    # Playwright browser 生命週期 + session 管理\n└── converter.js   # ffmpeg 兩步 GIF 轉換\n```\n\n- **預設睇得到** — 睇住 AI 做咩\n- **懶啟動** — Chromium 要錄先開\n- **Session 制** — 可以同時錄幾條片\n- **一個 browser，多個 context** — 每條錄影獨立\n- **`execFile` 唔係 `exec`** — 防 shell injection\n\n## 更多 @mcpware 產品\n\n| 產品 | 做咩 | 安裝 |\n|------|------|------|\n| **[UI Annotator](https://github.com/mcpware/ui-annotator-mcp)** | Hover 任何 element 睇到佢個名 — 零 extension，任何 browser | `npx @mcpware/ui-annotator` |\n| **[Claude Code Organizer](https://github.com/mcpware/claude-code-organizer)** | 視覺化 dashboard 管理 memories、skills、MCP servers、hooks | `npx @mcpware/claude-code-organizer` |\n| **[Instagram MCP](https://github.com/mcpware/instagram-mcp)** | 23 個 Instagram Graph API 工具 | `npx @mcpware/instagram-mcp` |\n\n## 授權\n\nMIT\n","readmeFilename":"README.zh-HK.md"}