用途:TinyFish CLI(命令 tinyfish)提供终端可调用的网页工具,用于获取实时网页信息、页面内容与结构化数据。安装用 npm install -g @tiny-fish/cli;未认证可执行 tinyfish auth login --source openclaw 或设置 TINYFISH_API_KEY 环境变量。
主要能力与选择顺序:search → fetch → agent → browser,由最轻到最重。search 用于找 URL、当前事实、文档、价格与产品信息;fetch 用于已有 URL 时获取干净正文、摘要、链接与元数据;agent 用于点击、填表、导航等页面交互和动态站点结构化提取;browser 用于需要 CDP 原始浏览器控制的场景。
常用用法:搜索示例 tinyfish search query "best React state management libraries 2026",支持 --location、--language、--pretty,默认返回 10 条 JSON 结果。抓取示例 tinyfish fetch content get --format markdown "https://example.com/article",支持多 URL 并行、--format markdown|html|json、--links、--image-links,响应含 title、language、author、published_date、text 等字段。agent 示例 tinyfish agent run --url <url> "<goal>",可用 --sync、--async、--pretty;流式输出中 type == "COMPLETE" 且 status == "COMPLETED" 的事件,其 resultJson 为提取结果,应直接在目标里写明所需 JSON 结构。多个独立站点应分别发并行调用,不要合并成一个目标。可用 agent run list/get/cancel 管理运行,agent batch run --input runs.csv 批量提交。browser session create 返回 session_id 与 cdp_url(WebSocket),可配合 Playwright、Puppeteer 等 CDP 客户端;支持 --url、--proxy-country、--proxy-url、--proxy-username、--no-proxy,密码经 TINYFISH_PROXY_PASSWORD 环境变量传入,默认经美国代理出口并整会话保持同一 IP。
适用场景:研究、需要来源支撑的回答、核对事实是否变化、读取文档与产品/价格页、从动态站点提取结构化数据,以及代理与地域相关的访问。限制:未提供具体收费标准与配额;动态或 JS 较重页面若 fetch 内容为空或不完整,需升级到 agent;复杂多步流程可升级到 browser。所有命令默认 JSON,--pretty 输出更易读,--debug 或 TINYFISH_DEBUG=1 记录 HTTP 请求到 stderr。回答语言与用户一致。