pilotfish (local)

io.github.gAI-ventures由 GitHub 帳號 gAI-ventures 發布v0.1.13更新於 Nov 6, 2026

A real Chromium on your machine for any MCP agent: ref-based tools, evidence per action, no API key.

概覽

AI 產生的概覽

在使用者電腦上執行真實的 Chromium 瀏覽器,讓 AI 助理透過以元素參照為基礎的工具瀏覽、讀取、填寫與點擊網頁。

可以做什麼
  • 開啟網址、列出並切換分頁、關閉或重新啟動瀏覽器
  • 以帶元素參照的快照樹檢視頁面、擷取視窗畫面,或讀取頁面文字(含 PDF)
  • 點擊、輸入、選擇下拉選項、按鍵與捲動,每一步都回傳變更證據
  • 用唯讀 JavaScript 運算式讀取所需數值,或依可見文字尋找頁面元素
  • 一次呼叫執行多個步驟、等待載入,並在人工完成登入、兩步驗證或驗證碼後繼續
適用情境
適合需要操作沒有 API 的網站:填寫表單、查看價格或清單、讀取登入後的頁面,或確認頁面實際顯示的內容。它是本機桌面工具,適合有人可隨時介入完成登入的互動情境。
執行需求
以本機 npm 套件安裝,作為 stdio 程序在使用者電腦上執行,需要 Chromium 瀏覽器,僅支援桌面端。選用環境變數:PILOTFISH_ALLOWED_HOSTS 限制可造訪的主機名稱,PILOTFISH_HEADLESS 隱藏瀏覽器視窗,PILOTFISH_SECRETS 存放佔位符值。未宣告需要 API 金鑰或帳號。
安裝前請注意
瀏覽器操作的是真實網站:點擊、輸入與送出表單會變更真實資料,browser_close 會清除 Cookie 與登入狀態。除非設定 PILOTFISH_ALLOWED_HOSTS,預設可造訪任何公開主機。PILOTFISH_SECRETS 保存以佔位符輸入的值,不應放入共用設定;助理讀取的頁面內容會傳送給模型供應商。無頭模式無法人工完成登入與驗證碼。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 pilotfish (local),將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

工具

16

browser_navigate

Open a URL

Open an http(s) URL in the current tab. Returns evidence and a snapshot of the visible screen (elements carry refs like e12), with counts of what is above and below. Words like cheapest, latest, highest-rated or most mean the site's own sort or tab for that order (a list's default order is usually something else, e.g. 'Best' or 'Featured'): apply it, then read the top.

輸入參數url必填snapshot

browser_snapshot

Read the page

The current page as a compact tree of headings, text and elements with refs (e12) to act on: three screens around the viewport, or everything with whole_page. Refs stay valid while their element is on the page.

輸入參數whole_page

browser_click

Click

Click an element by ref. Refuses with a reason (obscured, stale, not visible) instead of clicking the wrong thing. Returns evidence of what changed.

輸入參數ref必填

browser_type

Type

Type into an input, textarea or editable element by ref, replacing its text. Returns evidence.

輸入參數ref必填text必填submit

browser_select

Select options

Choose option(s) of a <select> by label or value. Returns evidence.

輸入參數ref必填values必填

browser_press

Press a key

Press a key or shortcut on the focused element. Returns evidence.

輸入參數key必填

browser_scroll

Scroll

Scroll about one screen. Returns evidence and the newly visible elements.

輸入參數direction必填

browser_screenshot

Screenshot

JPEG of the current viewport. Prefer browser_snapshot (cheaper, has refs); use this when layout or images matter.

無需輸入參數。

browser_get_text

Page text

Readable text of the page (PDFs too), secrets masked, without refs. To read a few values or a list, browser_query is far smaller.

輸入參數selectormax_chars

browser_query

Read values with JavaScript

Read just the values you need (prices, counts, titles, a results list) with a read-only JavaScript expression returning JSON (at most 4000 characters): the cheapest way to read, far smaller than browser_get_text or a snapshot. It runs in a world of its own where clicks, typing, submits and network writes are refused.

輸入參數expression必填

browser_find

Find elements

Refs of elements anywhere on the page, outside the visible screen too, by the words they show or are labelled with, best match first. Separate several targets by commas.

輸入參數query必填

browser_actions

Several actions in one call

Several steps in order in one call, e.g. fill a form's fields and submit it; each gets the same checks as its own tool. Stops at the first that fails, or after one that moves the page to another address (later refs would belong to the old page). Returns a line per step and the evidence and visible screen after the last one run.

輸入參數actions必填

browser_resume

Continue after the person

When a result says NEEDS A PERSON (a sign-in, a one-time code or 2FA, a device approval, a CAPTCHA), tell the user in your reply what the page needs and that the pilotfish browser window is open on it; when they have done it there (or right after asking), call this and carry on: it waits until the page has moved on, then returns it. BLOCKED and STOP mean the site cannot be continued that way.

輸入參數timeout_s

browser_wait

Wait

Wait 0.5-10 seconds, then return what changed. Only for a page that is visibly still loading: every action already waits for the requests it started.

輸入參數seconds必填

browser_tabs

Tabs

List the open tabs (the current one is marked). switch_to makes another tab current and returns its snapshot.

輸入參數switch_to

browser_close

Close the browser

Only to start over: closes the browser, and the next call starts a fresh one (cookies and logins are gone). It closes by itself when the client disconnects.

無需輸入參數。

版本歷史

3
  1. v0.1.13最新Nov 6, 2026
  2. v0.1.9Nov 5, 2026
  3. v0.1.1Nov 5, 2026

評分

已滿足適用檢查項的 65%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分

    請宣告包含 README 的 GitHub 儲存庫,或在 OAuth 受保護資源後設資料中提供 resource_documentation。

  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。