# WebChatMCP.js：技能書與協作來源 讓 MCP 工具透過本機瀏覽器向網頁聊天服務提問，再把回答交回原本的工具。 ## 工坊收錄說明 作品與開源 想把網頁聊天接進 MCP client 的開發者、願意先核對資料流與安裝影響的進階使用者。 一份單一 provider 的橋接核對表：連線方式、資料出口、登入／暫存狀態、回答，以及仍未驗證的部分。 和開發夥伴先審資料流與關閉方式，再以合成提示比對狀態；外掛影響另讀文件後討論，不把連通當成服務保證。 先畫「client → 本機 Chromium → 第三方聊天 → client」資料流，讀 README 的持久 profile、無認證 HTTP 和外掛副作用。 ## 封面與來源署名 作者：星語 封面插畫：/art/skills/webchat-mcp.webp 原作者 GitHub：https://github.com/JS-PACKAGE/WebChatMCP.js 登入自由工坊並連結自己的 GitHub，即可在技能書加星或取消星星。 原作數據：/api/v1/github/books/webchat-mcp/metrics Stars、Forks、追蹤數、未結 Issues 與 PR 合計、最近程式更新時間以 GitHub 回覆為準；數據附核對時間，讀取失敗不冒充零。 ## 讀者與格式 內建瀏覽器的本機 MCP server - 想把網頁聊天接進 MCP client 的開發者 - 願意先核對資料流與安裝影響的進階使用者 ## 功能與使用範圍 Apache-2.0，本機橋接，並非官方 API。需 Node.js 22 以上與 Playwright Chromium；Claude／Grok 需登入，訪客與暫存狀態可能是 unknown，不能保證零保存。提示、歷史及工具結果會送至所選第三方服務，受其條款、額度與費用限制。持久 profile 保存登入；HTTP 無認證，預設只綁 loopback。外掛由 host 按自身權限執行工具，不是沙箱。Codex 等安裝腳本會關閉應用、改設定，服務停用可能影響官方模型連線；Windows 腳本未實機驗證。工坊未安裝或登入。 - 內建持久 Chromium，以 stdio 或預設 127.0.0.1:8321/mcp 連接 MCP client。 - webchat_status 回報登入／暫存狀態，webchat_models 查模型與思考深度，webchat_ask 回傳聊天文字。 - 可選 plugins 外掛把網頁模型的工具要求交回 host；host 執行後的結果會再送回第三方服務。 ## 開始前準備 - Node.js 22 以上、自己的 MCP client 與 Playwright Chromium；登入由本人在瀏覽器完成。 - README 的 MCP client configuration、Security／notes，以及欲採用的 plugins 文件。 - 一段無敏感內容的合成提示；先決定用 stdio 或 HTTP，同一 profile 不混用兩種啟動方式。 ## 第一個練習 1. 先畫「client → 本機 Chromium → 第三方聊天 → client」資料流，讀 README 的持久 profile、無認證 HTTP 和外掛副作用。 2. 在自備環境依 README 安裝、建置並設定 MCP client；先只用 server 與預設 loopback，查 webchat_status。 3. 用 webchat_ask 對一個 provider 送合成提示，記錄登入／暫存狀態與回覆；unknown 保留未知，結束用 webchat_close，登入仍會保留。 ## 練習成果 一份單一 provider 的橋接核對表：連線方式、資料出口、登入／暫存狀態、回答，以及仍未驗證的部分。 ## 專案與授權 原作 Repo：https://github.com/JS-PACKAGE/WebChatMCP.js 從原作建立自己的版本：https://github.com/JS-PACKAGE/WebChatMCP.js/fork 工坊整合參考：https://github.com/JS-PACKAGE/WebChatMCP.js 記錄的授權：Apache-2.0 ## 一起改這本技能書 在原作 Issues 回報去識別的 provider、狀態碼、selector 或文件差異，保留星語的分享來源與 Apache-2.0；不要附 profile、cookie、token 或私人聊天。 原作 Repo：https://github.com/JS-PACKAGE/WebChatMCP.js 預設 PR 目標：JS-PACKAGE/WebChatMCP.js:main 從原作建立自己的版本：https://github.com/JS-PACKAGE/WebChatMCP.js/fork 原作 PR：https://github.com/JS-PACKAGE/WebChatMCP.js/pulls 工坊整合參考：https://github.com/JS-PACKAGE/WebChatMCP.js 工坊整合任務專用 Fork：https://github.com/JS-PACKAGE/WebChatMCP.js/fork 工坊任務：https://github.com/JS-PACKAGE/WebChatMCP.js/issues 工坊 PR：https://github.com/JS-PACKAGE/WebChatMCP.js/pulls GitHub Milestones：https://github.com/JS-PACKAGE/WebChatMCP.js/milestones 先閱讀原作現行的貢獻規則。Fork 不會自動回饋原作；修改要以 PR 提交，由原作維護者決定是否合併。工坊整合任務可在工坊審查，另外記錄回饋原作的 PR 或未回送原因。 以下是入口與建議，不代表已認領或已完成。以 GitHub 最新 Issue、PR 與維護者確認為準。 - 第一份可重用的共同成果（建議里程碑）：提交可重現案例、來源與驗證結果，由維護者審查；這是建議里程碑，尚未建立為 GitHub milestone。 ### 改善內建瀏覽器的本機 MCP server的第一個案例 · 建議任務 在原作 Issues 回報去識別的 provider、狀態碼、selector 或文件差異，保留星語的分享來源與 Apache-2.0；不要附 profile、cookie、token 或私人聊天。 - 驗收：一份單一 provider 的橋接核對表：連線方式、資料出口、登入／暫存狀態、回答，以及仍未驗證的部分。 記錄實際驗證與未執行項目；以原作 Issue／PR 協調。 Agent Skill：/development/skills/webchat-mcp/SKILL.md 協作 JSON：/api/v1/skills/webchat-mcp/collaboration ## 參與開發 在原作 Issues 回報去識別的 provider、狀態碼、selector 或文件差異，保留星語的分享來源與 Apache-2.0；不要附 profile、cookie、token 或私人聊天。 工坊 Issue／PR 協調入口：https://github.com/JS-PACKAGE/WebChatMCP.js/issues 先讀該 Repo 根目錄 README.md、AGENTS.md、CONTRIBUTING.md；原始程式、測試及來源授權留在該專案。平台介紹與公會收錄則在 freedom-platform 的 modules/community 維護。 要改善平台介紹：https://github.com/FreeTWAI/freedom-platform/issues ## 閱讀與來源 閱讀原始專案：https://github.com/JS-PACKAGE/WebChatMCP.js/blob/a9b5f77874cdb4de669c89a3b7d7fd76d2cd8a44/README.md 核對日期：2026-10-20 核對版本：a9b5f77874cdb4de669c89a3b7d7fd76d2cd8a44 - README.md：https://github.com/JS-PACKAGE/WebChatMCP.js/blob/a9b5f77874cdb4de669c89a3b7d7fd76d2cd8a44/README.md - LICENSE：https://github.com/JS-PACKAGE/WebChatMCP.js/blob/a9b5f77874cdb4de669c89a3b7d7fd76d2cd8a44/LICENSE 專案網站：https://webchatmcp.js-package.xyz ## 共創原則 GitHub Issue 是待辦與協調來源，PR 是審查與合併紀錄。先確認任務範圍，再用自己的分支完成相關驗證；保留上游與實際貢獻者。Fork 不等於平台認證、已測試運行或新授權。 完整結構化目錄：/api/v1/development-map