项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-11-21 · 当前星标 ★ 1372
使用教程
环境要求
- Node.js 18 及以上
- bun(默认)、npm 或 pnpm 任一包管理器
- Supabase 账号(数据库、认证、Edge Functions)
- OpenAI API key、Resend API key(邮件通知)
- Google Cloud Console 账号(仅在使用 Google OAuth 登录时需要,可选)
安装与启动步骤
-
1克隆并安装依赖
把仓库拉到本地并安装依赖,npm 或 pnpm 也可替换 bun install。
git clone https://github.com/firecrawl/open-scouts cd open-scouts bun install -
2创建 Supabase 项目
登录 supabase.com 控制台新建项目,等待初始化完成后进入项目页。
-
3填写环境变量
复制示例文件为 .env,按其中注释填入各 API key 与 Supabase 配置。
cp .env.example .env -
4登录并关联项目
CLI 登录只需一次;project-ref 可在 Supabase 控制台项目 URL 中找到。
bunx supabase login bunx supabase link --project-ref abcdefghijklmnop -
5初始化数据库
执行脚本建表、开启 RLS 与实时订阅、配置调度与定时任务,并同步密钥。
bun run setup:db -
6部署边缘函数
把执行代理与测试邮件两个 Edge Function 部署到 Supabase 云端。
bunx supabase functions deploy scout-cron bunx supabase functions deploy send-test-email -
7配置邮件通知
在 Resend 获取 API key 写入密钥;未验证域名时只能发到账号邮箱。
bunx supabase secrets set RESEND_API_KEY=re_xxxxxxxxxxxx -
8启动开发服务器
运行开发服务器,浏览器打开本地 3000 端口即可进入应用。
bun run dev
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
OPENAI_API_KEY | 是 | AI Agent 与向量嵌入调用所需,setup:db 时会同步为函数密钥 | sk-proj-xxxxxxxxxxxxxxxx |
RESEND_API_KEY | 是 | 发送发现结果邮件通知所用,需在 Resend 控制台获取 | re_xxxxxxxxxxxx |
FIRECRAWL_API_KEY | 否 | 抓取与搜索能力;也可由每个用户在应用 Settings 页自行填写 | fc-xxxxxxxxxxxx |
如何确认成功
终端无报错后访问 http://localhost:3000 能打开首页,并在 Settings 点 Send Test Email 收到测试邮件。
常见问题
Q:setup:db 提示扩展未启用怎么办?
A:脚本会检查 vector、pg_cron、pg_net 三个扩展,按屏幕提示到 Supabase 控制台手动启用后,重新执行 bun run setup:db。
Q:测试邮件没收到?
A:确认 Resend key 已写入密钥;未验证自定义域名时,Resend 只能发送到注册账号的邮箱,需在 resend.com/domains 验证域名。
Q:如何更新已部署的密钥?
A:修改 .env 后重跑 setup:db 自动同步,或用 bunx supabase secrets set 手动设置单个密钥。
Q:必须配置 Firecrawl 环境变量吗?
A:不必须。README 建议用户在应用 Settings 页填写自己的 Firecrawl API key,这是推荐做法。
注意事项
- 数据库初始化会自动把 Supabase URL 和 service role key 存入 vault,并创建调度与清理定时任务。
- Resend 免费额度为每月 3000 封、每天 100 封,注意用量。
- setup:db 会把 .env 中的 OPENAI_API_KEY、FIRECRAWL_API_KEY、RESEND_API_KEY 同步到 Edge Function 密钥。
- 认证支持邮箱密码与 Google OAuth,Google 登录需要在 Google Cloud Console 额外配置。
核心亮点
- 用自然语言描述监控需求即可创建任务,无需写爬虫规则或选择器
- Firecrawl 负责抓取、OpenAI 负责判断内容相关性,抓取与语义筛选链路完整
- 邮件告警通过 Resend 开箱可用,Supabase 提供数据与鉴权,整体可自部署
不足之处
- 依赖 OpenAI 与 Firecrawl 等第三方付费服务,运行有持续成本
- 监控频率与判断准确性受模型能力影响,可能出现漏报或误报
- 项目较新,长期稳定性、抓取反爬处理与文档完善度待观察
适用场景
- 跟踪竞品官网和博客更新,有新品或改价时邮件提醒
- 监控招聘网站目标岗位,出现匹配职位立即通知
- 盯行业论坛、社区新帖或政策公告,第一时间获取相关信息
替代项目
changedetection.io、Huginn、n8n
同类项目推荐
frago
开源
让 AI 代理稳定操控浏览器,轻松编排复杂自动化流程。
Multi-runtime automation infrastructure for AI agents. Native CDP browser control, m···
browser-debugger-cli
开源
让 AI 代理用命令行直接调试 Chrome,不截图不 MCP
Let Claude Code and other coding agents drive and debug Chrome from the shell. DOM, ···
bhban_rpa
开源
零基础学Python,一天搞定半年重复工作
<6개월 치 업무를 하루 만에 끝내는 업무 자동화(생능출판사, 2020)>의 예제 코드입니다. ···
trigger.dev
开源
用 TypeScript 快速构建和部署 AI 代理与自动化工作流
Trigger.dev – build and deploy durable AI agents and workflows
vessel-browser
开源
为 AI 智能体打造的持久化、可编程控制的开源浏览器
Built from the ground-up for agents, Vessel Browser is an open source AI browser for···
ai-goofish-monitor
开源
闲鱼多任务监控+AI分析,自动帮你找到心仪好物
基于 Playwright 和AI实现的闲鱼多任务实时/定时监控与智能分析系统,配备了功能完善的后台···
invisible_selenium
开源
改一行 import,Selenium 脚本秒变反检测 Firefox
invisible selenium: Selenium that anti-bots cannot see, so no captchas: same API, an···
openrpa
开源
拖拽搭建桌面自动化流程,多机器人统一调度
Free Open Source Enterprise Grade RPA
JamTools
开源
一个软件搞定截屏、录屏、翻译、格式转换等日常杂活
JamTools是一个跨平台的小工具集类软件,支持Windows7/8/10/11、Macos、ubuntu系统(其他系···
