Stagehand AI 瀏覽器自動化實戰一個腳本跑通網頁數據采集全流程【免費下載鏈接】stagehandThe SDK For Browser Agents項目地址: https://gitcode.com/GitHub_Trending/stag/stagehandStagehand 是一個 AI 瀏覽器自動化 SDK用 act、extract、observe 三個原語驅動瀏覽器讓你不寫選擇器就能完成點擊、填表和抓取。本文用本地瀏覽器搭一條完整的網頁數據采集鏈路打開列表頁觀察可操作元素點擊進入詳情頁最后把結構化數據提取出來。 場景從電商頁采集商品數據假設你需要從一個商品列表頁批量抓取商品名和價格再交給下游程序處理。手寫選擇器很脆弱站點一改版腳本就失效。用 Stagehand 的 AI 瀏覽器自動化你只用自然語言描述意圖元素定位交給模型。跟完下面幾步你會得到一個在本機跑通的自動化腳本。 動手準備3 條命令裝好 Stagehand本地運行需要 Node.js 22.18 和已安裝的 Chrome。初始化項目并安裝 SDKmkdir my-stagehand-app cd my-stagehand-app pnpm init -y pnpm install browserbasehq/stagehand zod 分步實現1. 啟動本地瀏覽器并創建實例先用localBrowser在本機啟動一個 Chrome再把它交給Stagehand.create()。開發階段用headless: false你能直接看到瀏覽器每一步動作方便排查import { localBrowser, Stagehand } from browserbasehq/stagehand; import { z } from zod/v4; const browser await localBrowser.launch({ headless: false }); const stagehand await Stagehand.create({ browser }); const [page] await browser.context.pages(); await page.goto(https://example-store.com);2. 用 observe 預覽頁面上能做什么動手前先偵查observe返回當前頁面上可執行的操作列表。返回的Action對象之后可以直接回放不再觸發模型推理這是 Stagehand 省錢提速的核心模式const { data: actions } await stagehand.observe(Find all product links); console.log(actions.map((a) a.actionDescription)); // 偵查滿意后執行第一個動作 await stagehand.act(click the first product link);3. extract 提取結構化數據進入詳情頁后用extract配 Zod schema 取值。Stagehand 會先按 schema 校驗再返回你拿到的是強類型數據直接落盤或寫入數據庫const { data } await stagehand.extract( extract the product name and price, z.object({ name: z.string(), price: z.number() }), ); console.log(data); // { name: Keyboard, price: 199 } 調優進階成本與速度問題每步都走大模型慢且貴。手段默認掛便宜模型只在關鍵提取調用上換強模型單次調用即可覆蓋。問題重復運行任務時重復計費。手段切到 Browserbase 云瀏覽器并開啟緩存相同調用直接返回緩存結果不消耗任何 token。const stagehand await Stagehand.create({ browser, // 換成 browserbase.launch({ apiKey }) 得到 model: { modelName: google/gemini-2.5-flash }, // 默認用便宜模型 cache: { threshold: 1 }, // 一次相同結果后開始命中緩存 });? 常見問題緩存為什么一直不命中本地瀏覽器沒有緩存服務cache選項不生效必須用browserbase.launch()啟動。另外指令措辭是緩存鍵的一部分換同義詞就會變成新鍵。act 點錯元素怎么辦先用observe確認頁面實際內容再給調用傳locator把快照范圍收斂到你關心的容器減少無關干擾。支持 Python 和 Go 嗎支持。三個原語語義與 TypeScript 版一致分別用 Pydantic 模型和 Go 結構體替代 Zod schemaAPI key 也換成對應語言的 launch 參數傳遞。 延伸閱讀快速上手packages/docs/v4/first-steps/quickstart.mdxact 完整參考packages/docs/v4/basics/act.mdxobserve 完整參考packages/docs/v4/basics/observe.mdx緩存最佳實踐packages/docs/v4/best-practices/caching.mdxSDK 核心源碼packages/sdk-ts/src/stagehand.ts【免費下載鏈接】stagehandThe SDK For Browser Agents項目地址: https://gitcode.com/GitHub_Trending/stag/stagehand創作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考