open-scouts

说一句话,AI 帮你盯网站,有结果就发邮件

开源 🏷️定价信息待确认 ⏳ 访问状态待核验 自动化工作流 🍴 复刻 186 🐛 待处理 7 👀 关注 8
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 1372
维护状态 较活跃
是否开源 开源
定价模式 🏷️定价信息待确认

项目预览

open-scouts 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类自动化工作流
开发团队firecrawl
定价模式🏷️定价信息待确认
价格说明定价信息待确认
访问状态⏳ 访问状态待核验
是否开源是
主要语言TypeScript
技术栈/模型ai-agents,alerts,automation,email-notifications,firecrawl,nextjs,open-source,openai,posthog,react,resend,supabase,tailwindcss,typescript,vercel,web-monitoring,web-scraping
GitHub 星标★ 1372
上线时间2025-11-28 00:00:00
代码更新2026-11-13
仓库体积34.0 MB
本站数据更新2026-11-21
维护状态较活跃
收录时间2026-11-21
浏览次数0

项目介绍

open-scouts 是一个基于 AI 的网页监控平台,用 TypeScript 构建,前端采用 Next.js 和 React,后端依赖 Supabase,抓取能力来自 Firecrawl,模型调用 OpenAI,邮件通知通过 Resend 发送。它要解决的问题是:用户不想每天手动刷新多个网站找信息,而是希望把「关注什么」描述成一条监控任务,由系统定期自动搜索网页,一旦发现符合条件的内容就发邮件提醒。核心能力包括:用自然语言创建 scout(监控任务),由 AI 理解检索意图并驱动网页抓取与内容判断,命中后触发邮件告警;内置 PostHog 做行为分析,Tailwind 负责界面。适合跟踪价格变动、招聘岗位、行业新闻、竞品动态、论坛新帖等场景。项目开源、可自部署,星标约 1.4k,处于成长期。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-11-21 · 当前星标 ★ 1372

使用教程

难度:进阶 约 30 分钟 部署方式:本地安装 8 步

环境要求

  • Node.js 18 及以上
  • bun(默认)、npm 或 pnpm 任一包管理器
  • Supabase 账号(数据库、认证、Edge Functions)
  • OpenAI API key、Resend API key(邮件通知)
  • Google Cloud Console 账号(仅在使用 Google OAuth 登录时需要,可选)

安装与启动步骤

  1. 1克隆并安装依赖

    把仓库拉到本地并安装依赖,npm 或 pnpm 也可替换 bun install。

    git clone https://github.com/firecrawl/open-scouts
    cd open-scouts
    bun install
  2. 2创建 Supabase 项目

    登录 supabase.com 控制台新建项目,等待初始化完成后进入项目页。

  3. 3填写环境变量

    复制示例文件为 .env,按其中注释填入各 API key 与 Supabase 配置。

    cp .env.example .env
  4. 4登录并关联项目

    CLI 登录只需一次;project-ref 可在 Supabase 控制台项目 URL 中找到。

    bunx supabase login
    bunx supabase link --project-ref abcdefghijklmnop
  5. 5初始化数据库

    执行脚本建表、开启 RLS 与实时订阅、配置调度与定时任务,并同步密钥。

    bun run setup:db
  6. 6部署边缘函数

    把执行代理与测试邮件两个 Edge Function 部署到 Supabase 云端。

    bunx supabase functions deploy scout-cron
    bunx supabase functions deploy send-test-email
  7. 7配置邮件通知

    在 Resend 获取 API key 写入密钥;未验证域名时只能发到账号邮箱。

    bunx supabase secrets set RESEND_API_KEY=re_xxxxxxxxxxxx
  8. 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···

★ 114 2026-08-09
browser-debugger-cli 开源

让 AI 代理用命令行直接调试 Chrome,不截图不 MCP

Let Claude Code and other coding agents drive and debug Chrome from the shell. DOM, ···

★ 186 2026-10-09
bhban_rpa 开源

零基础学Python,一天搞定半年重复工作

<6개월 치 업무를 하루 만에 끝내는 업무 자동화(생능출판사, 2020)>의 예제 코드입니다. ···

★ 1153 2026-08-27
trigger.dev 开源

用 TypeScript 快速构建和部署 AI 代理与自动化工作流

Trigger.dev – build and deploy durable AI agents and workflows

★ 16792 2026-08-09
vessel-browser 开源

为 AI 智能体打造的持久化、可编程控制的开源浏览器

Built from the ground-up for agents, Vessel Browser is an open source AI browser for···

★ 139 2026-08-09
ai-goofish-monitor 开源

闲鱼多任务监控+AI分析,自动帮你找到心仪好物

基于 Playwright 和AI实现的闲鱼多任务实时/定时监控与智能分析系统,配备了功能完善的后台···

★ 20298 2026-08-09
invisible_selenium 开源

改一行 import,Selenium 脚本秒变反检测 Firefox

invisible selenium: Selenium that anti-bots cannot see, so no captchas: same API, an···

★ 270 2026-10-03
openrpa 开源

拖拽搭建桌面自动化流程,多机器人统一调度

Free Open Source Enterprise Grade RPA

★ 3124 2026-11-20
JamTools 开源

一个软件搞定截屏、录屏、翻译、格式转换等日常杂活

JamTools是一个跨平台的小工具集类软件,支持Windows7/8/10/11、Macos、ubuntu系统(其他系···

★ 736 2026-08-09