outcrawlai/scout

如果你想要一个能嵌进 TypeScript 代码、又不绑定某一家模型服务商的浏览器 Agent，Scout 值得花时间看看。前提是你愿意同时准备模型和浏览器，并把网站反自动化当成日常运维问题，而不是已经被解决的事。

解决什么问题

有些任务只存在于网页上：抓取 Hacker News 评论数最多的三条帖子，或者按某个下单表单把信息填完。现在的做法要么是针对页面写一堆容易失效的选择器，要么交给一个只能聊天、不能动手的助手。Scout 改变的是“动手”这一步：你用自然语言描述任务并传入结果结构，Agent 在真实浏览器里读页面、点击、输入、滚动，直到按你的格式返回数据；如果做不完，会返回已经找到的部分，并说明还差什么。

有什么不同

它的设计是把模型工作拆成几个角色，而不是一个模型包办。必需的 hands 模型负责每一步读页面并决定点击、输入、滚动或读取；可选的 brain 和 eyes 分别处理跨多页的规划和截图识别。每个角色都可以在任意支持标准 chat completions API 的服务上选模型，包括跑在本机的模型，而且刻意不提供内置默认值。好处是成本可控：高频的 hands 循环可以配快而便宜的模型，规划和看图再用更强的模型。代价是模型选型和提示词质量要你自己负责，hands 选得不好会在每一步都体现为错误操作。

每次运行都是有限制的对象：返回状态（completed、partial、capped 或 failed）、数据、错误说明、带耗时的步骤记录、已知的 costUsd，云端运行还有回放链接。可以设置步骤数、时长和预算上限，触到上限属于正常结束，会保留已找到的内容，这比全有或全无的脚本更适合采集类任务。浏览器的切换也只是一行配置：Outcrawl 云端、自动启动的本机 Chromium，或已有的 CDP 地址。

谁值得试

适合：需要自动化某个调研或表单填写任务、目标只有网页这一个入口，并且希望以库而不是聊天客户端形式使用的 TypeScript 开发者；仓库里的示例脚本可以直接跑起来作为起点。不适合：想要完全免配置、无人值守的生产流水线，或者任务集中在会拦截自动化的网站上，README 对这类情况指向 Outcrawl 的云端。如果你本来就有自己的 Chrome 和模型接口，自托管这条路是可行的，但建议先看接入说明和包参考文档。

使用条件与边界

需要 Node 22 或更高版本。项目本身不带模型、也没有默认模型，所以至少要先配好 hands 模型的地址和密钥才能运行；可选角色各自需要兼容的模型，eyes 还要求模型支持图片输入。用 Outcrawl 云端需要 Outcrawl 密钥，README 说每月有免费额度；自托管可以不用这个密钥，但网站反自动化要自己处理，README 也明确说很多站点会拦数据中心或行为像脚本的浏览器。日常维护主要是模型配置和这几个角色提示词的质量。

仓库按多个包组织，其中 packages/agenthands 用 MIT 许可，与主许可 Apache-2.0 不同，若要取用其中组件需要留意。README 还说明 GitHub 上的这份是自动从 Outcrawl 自有仓库镜像过来的，所以提 issue 和贡献的流程未必按 GitHub 的常规方式走。

HotRepo 点评

仓库创建于 2026-10-13，在 HotRepo 的 TypeScript 新项目榜（不是总榜）上以 937 总星数排第 9，观测于 2026-10-25。这是新项目榜的名次，不是日增数据，HotRepo 也没有可比的每日记录，所以无法从这些样本判断热度能否持续。真正值得在采用前确认的是：你打算用的 hands 模型是否够快，以及目标站点在不走云端浏览器时能否正常完成；这两点决定了单次运行的实际成本。