用途：TinyFish CLI 通过命令行调用 TinyFish 浏览器自动化能力，覆盖搜索、抓取正文、执行自动化任务与批量操作。适合需要网络搜索结构化结果、抓取网页正文、对网页执行自动化操作、批量处理多网页任务或创建远程浏览器会话的场景；纯本地文件操作、已有 MCP 工具可满足需求、或不需要浏览器能力的简单 HTTP 请求则不建议使用。
主要能力与用法：搜索用 tinyfish search query "..."，支持 --location、--language；抓取正文用 tinyfish fetch content get <url> [url...]，支持多 URL 及 --format、--links；浏览器自动化用 tinyfish agent run "goal" --url <url>，支持 --sync、--async；批量任务用 tinyfish agent batch run --input <csv>；远程浏览器用 tinyfish browser session create，支持 --url。运行管理包括 agent run list、agent run get <id>、agent run cancel <id>、agent batch list、agent batch get <id>。
通用规则：所有命令默认输出 JSON 到 stdout，错误以 JSON 走 stderr，失败退出码为 1；支持 --pretty 获得可读输出；在 Bash 工具中调用 agent run 时始终使用 --sync；排障可加 --debug 或设 TINYFISH_DEBUG=1。
前置条件与限制：需先安装配置 CLI，并用 tinyfish auth status 确认认证状态，未认证时退出码为 1。常见错误包括 agent run 缺少必需的 --url、流式模式未按行解析 JSON、batch run 的 CSV 缺少 url 或 goal 列、未认证直接调用命令。更多细节需按需读取 references/search-and-fetch.md、references/agent-run.md、references/browser-session.md。