AI Skills
use-tinyfish

use-tinyfish

熱門

使用 TinyFish 進行網路搜尋、擷取 URL、閱讀頁面、取得最新資訊、有來源佐證的答案、研究、文件、價格/產品頁面、資料擷取、網頁抓取以及瀏覽器自動化。每當使用者要求搜尋、尋找、查詢、研究、比較、從網路取得資訊、摘要 URL、擷取頁面內容或自動化網站時，請使用此技能。

2132星標
326分支
更新於 2026/8/27
獲取技能源代碼

相關技能

chrome-devtools3.6萬seo-dataforseo1.2萬growth-log24萬
SKILL.md
唯讀
名稱
use-tinyfish
描述

使用 TinyFish 進行網路搜尋、擷取 URL、閱讀頁面、取得最新資訊、有來源佐證的答案、研究、文件、價格/產品頁面、資料擷取、網頁抓取以及瀏覽器自動化。每當使用者要求搜尋、尋找、查詢、研究、比較、從網路取得資訊、摘要 URL、擷取頁面內容或自動化網站時，請使用此技能。

TinyFish CLI

您可以使用 TinyFish CLI（tinyfish）——這是一套可從終端機呼叫的網路工具組。

若未安裝：npm install -g @tiny-fish/cli
若未驗證：tinyfish auth login --source openclaw 或設定 TINYFISH_API_KEY 環境變數。

此技能何時應觸發

每當請求依賴即時網路資訊或頁面內容時，請使用 TinyFish。不要等待使用者說「TinyFish」或「scrape」。

強烈觸發情境包括：

  • 搜尋或探索：搜尋、尋找、查詢、研究、比較、最新、目前、新聞、文件、價格、產品詳細資訊、最佳選項。
  • URL/頁面閱讀：擷取、閱讀、摘要、從此頁面提取、檢查此 URL、取得內容、提取連結或中繼資料。
  • 有來源佐證的答案：使用網路來源回答、驗證事實、檢查是否有變更、從網路收集資訊。
  • 網站操作：與網站互動、點擊頁面、填寫表單、登入、收集結構化資料、處理有機器人保護的頁面。

預設使用最輕量的工具來回答：

  • 沒有 URL 且使用者需要網路資訊：search，若需要更多細節再 fetch 最佳結果。
  • 有提供 URL 且只需要內容：fetch。
  • 需要頁面互動或動態提取：agent。
  • 需要原始 CDP/Playwright 風格控制：browser。

選擇正確的工具

TinyFish 有四種工具。從最輕量且能完成工作的工具開始，只在需要時升級。

search  →  fetch  →  agent  →  browser
最輕量                          最重量
工具 使用時機 速度 成本
search 需要尋找 URL、目前事實、文件、價格、產品詳細資訊或快速的有來源佐證答案 最快 最低
fetch 有 URL 且需要乾淨的頁面內容、摘要、文章文字、文件、產品頁面、連結或中繼資料 快 低
agent 需要與頁面互動——點擊、填寫表單、導覽、從動態網站提取結構化資料 較慢 較高
browser agent 不夠用——需要透過 CDP 進行原始程式化瀏覽器控制 最慢 最高

常見模式

研究：search → fetch
搜尋主題，然後擷取最佳結果以閱讀完整內容。

# 1. 尋找 URL
tinyfish search query "best React state management libraries 2026"

# 2. 閱讀頂部結果
tinyfish fetch content get --format markdown "https://result1.com" "https://result2.com"

深度提取：search → agent
搜尋以找到正確的網站，然後使用 agent 與其互動並提取結構化資料。

# 1. 找到網站
tinyfish search query "Nike running shoes official store"

# 2. 在該網站上自動化提取
tinyfish agent run --url "https://nike.com/running" \
  "Extract all running shoes as JSON: [{\"name\": str, \"price\": str, \"colors\": [str]}]"

升級：fetch → agent
先嘗試 fetch。如果頁面是動態/JS 密集且 fetch 回傳空或部分內容，則升級到 agent。

完全控制：agent → browser
如果 agent 無法處理複雜的多步驟工作流程，請啟動原始瀏覽器工作階段並透過 CDP 自行自動化。

指令

tinyfish search query

網路搜尋。回傳排名結果，包含標題、URL 和摘要。

tinyfish search query "<query>" [--location <hint>] [--language <hint>] [--pretty]
  • 預設回傳 10 筆結果
  • 使用 --location 和 --language 進行地理定位結果
  • 預設輸出為 JSON；--pretty 為人類可讀格式
tinyfish search query "best pho in Ho Chi Minh City" --location "Vietnam" --language "en"

tinyfish fetch content get

從一個或多個 URL 擷取乾淨、提取的內容。移除廣告、導覽列、樣板——只回傳內容。

tinyfish fetch content get <urls...> [--format markdown|html|json] [--links] [--image-links] [--pretty]
  • 接受多個 URL 在單一呼叫中——它們會在伺服器端並行擷取
  • --format markdown（預設）——乾淨可讀的文字
  • --format json——結構化文件樹
  • --links——包含頁面中所有提取的連結
  • --image-links——包含提取的圖片 URL
  • 回應包含：url、final_url、title、language、author、published_date、text、latency_ms
# 以 markdown 擷取單一頁面
tinyfish fetch content get --format markdown "https://example.com/article"

# 擷取多個頁面並包含連結
tinyfish fetch content get --links "https://site-a.com" "https://site-b.com" "https://site-c.com"

tinyfish agent run

使用自然語言目標執行瀏覽器自動化。agent 會開啟真實瀏覽器、導覽、點擊、填寫表單並提取資料。

tinyfish agent run --url <url> "<goal>" [--sync] [--async] [--pretty]
旗標 用途
--url <url> 目標 URL（裸主機名稱會自動加上 https://）
--sync 等待完整結果而不串流步驟
--async 提交並立即回傳
--pretty 人類可讀輸出

輸出： 預設串流 data: {...} SSE 行。最終結果是 type == "COMPLETE" 且 status == "COMPLETED" 的事件——提取的資料在 resultJson 欄位中。直接讀取原始輸出；不需要腳本端解析。

務必在目標中指定您想要的 JSON 結構：

tinyfish agent run --url "https://example.com/products" \
  "Extract all products as JSON array: [{\"name\": str, \"price\": str, \"url\": str}]"

tinyfish agent run --url "https://example.com/search" \
  "Search for 'wireless headphones', filter under $50, extract top 5 as JSON: [{\"name\": str, \"price\": str, \"rating\": str}]"

平行提取——當存取多個獨立網站時，請分別呼叫。不要合併成單一目標。

良好——平行呼叫（同時執行）：

tinyfish agent run --url "https://pizzahut.com" \
  "Extract pizza prices as JSON: [{\"name\": str, \"price\": str}]"

tinyfish agent run --url "https://dominos.com" \
  "Extract pizza prices as JSON: [{\"name\": str, \"price\": str}]"

不良——單一合併呼叫：

# 不要這樣做——較不可靠且較慢
tinyfish agent run --url "https://pizzahut.com" \
  "Extract prices from Pizza Hut and also go to Dominos..."

管理工作：

tinyfish agent run list [--status PENDING|RUNNING|COMPLETED|FAILED|CANCELLED] [--limit N]
tinyfish agent run get <run_id>
tinyfish agent run cancel <run_id>

批次操作——從 CSV 檔案提交多個執行（url,goal 欄位）：

tinyfish agent batch run --input runs.csv
tinyfish agent batch list
tinyfish agent batch get <batch_id>
tinyfish agent batch cancel <batch_id>

tinyfish browser session create

啟動遠端瀏覽器實例。回傳 CDP WebSocket URL 以供程式化控制。

tinyfish browser session create [--url <url>] [--pretty]
  • --url 可選擇在建立後導覽至頁面
  • 回傳 session_id、cdp_url（WebSocket）和 base_url
  • 使用 cdp_url 搭配 Playwright、Puppeteer 或任何 CDP 用戶端
tinyfish browser session create --url "https://example.com"
# 回傳：{ session_id, cdp_url: "wss://...", base_url: "https://..." }

一般注意事項

  • 配合使用者的語言：以使用者使用的語言回覆。
  • 所有指令都支援 --pretty 以輸出人類可讀格式。預設為 JSON。
  • 在根指令使用 --debug 或設定 TINYFISH_DEBUG=1 以將 HTTP 請求記錄到 stderr。