SurfSense/README.zh-CN.md

English | Español | Português | हिन्दी | 简体中文

SurfSense：为你的 AI 智能体注入竞争情报能力

SurfSense 是面向 AI 智能体的开源竞争情报平台。你的智能体可以通过一个 REST API 或 MCP 服务器，利用来自 Reddit、YouTube、Google Maps、Google Search 和开放网络的实时数据，监控竞争对手、追踪排名、倾听市场动态。定时和事件触发的智能体会把发现的内容转化为简报和预警，内置的知识库则让每一条发现都可搜索、可引用。

Note

📢 致我们的 NotebookLM 替代品用户

在过去几个月里，我们把 SurfSense 打造成了针对个人知识的最佳通用研究智能体，这段旅程为我们赢得了一个令我们由衷自豪的社区。如今，Claude、OpenCode、Hermes、OpenClaw 等智能体工具已经证明智能体就是未来，通用研究正在成为每个有能力的智能体开箱即用的功能。而智能体仍然缺少的是实时市场数据以及围绕它的工作流，所以这正是我们全力投入的方向：成为标杆级的开源竞争情报智能体平台。

**你所依赖的一切功能都不会消失。**你的知识库、带引用的对话、报告、播客、演示文稿、自动化以及协作聊天都会继续可用，自托管也依然免费且开源。完整公告请阅读我们的更新日志。

为什么智能体需要 SurfSense

问任何一个有能力的智能体"竞争对手这周的定价是多少？"或者"自发布以来 Reddit 上对我们的评价如何？"，它都找不到可信赖的数据来源。官方平台 API 要么有速率限制，要么按企业级定价，要么根本不存在，而自建抓取管线又非常脆弱。SurfSense 正是为填补这一空白而生：

• 平台原生连接器，每个都是返回结构化 JSON 的强类型 REST 端点。不用赌速率限制，也不用解析 HTML。
• 一个 MCP 服务器，把每个连接器都作为原生工具（reddit.scrape、google_search.scrape 等）暴露给 Claude、Cursor 或任何智能体框架。
• 一套智能体运行框架，而不只是原始数据：重试、结构化输出和额度计量都已内置，智能体可以从一个问题直达一份简报，无需你自己搭建管线。
• 开源且可自托管，你的竞争研究数据始终留在你自己的基础设施上。

实时数据连接器

连接器	你的智能体能获得什么	了解更多
Reddit	帖子、评论和子版块信息流，不受官方 API 速率限制	Reddit Scraper API
YouTube	视频、字幕转录和评论串，用于品牌和产品舆情监听	YouTube Scraper API
Google Maps	地点、评分和评论，用于本地竞争对手和潜在客户调研	Google Maps Scraper API
Google Search	实时搜索结果页，用于排名追踪和市场监控	Google Search API
Web Crawl	把开放网络上的任意页面转为干净、结构化的内容	Web Crawling API
MCP Connector	将任意 MCP 服务器接入你的智能体，Notion、Slack、Jira 等支持一键 OAuth	MCP Connector

计费采用按量付费：连接器按实际返回的条目计费，爬取按成功抓取的页面计费，失败的调用永不计费。自托管部署默认关闭计费。详见定价。

快速开始

在代码中调用连接器

每个连接器都是一个 REST 端点，你可以用任何语言、凭借你的 SurfSense API 密钥来调用：

curl -X POST "$SURFSENSE_API_URL/workspaces/$WORKSPACE_ID/scrapers/reddit/scrape" \
  -H "Authorization: Bearer $SURFSENSE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "search_queries": ["your brand"],
    "community": "webscraping",
    "sort": "top",
    "time_filter": "week"
  }'

每个连接器页面都提供 Python、JavaScript、Go、PHP、Ruby、Java 和 C# 的可直接复制粘贴的示例。

通过 MCP 把工具交给你的智能体

把 SurfSense MCP 服务器添加到 Claude、Cursor 或你自己的智能体框架：

{
  "mcpServers": {
    "surfsense": {
      "url": "https://mcp.surfsense.com",
      "headers": { "Authorization": "Bearer ${SURFSENSE_API_KEY}" }
    }
  }
}

现在，你的智能体就可以把每个连接器当作原生工具来调用。

使用云端服务

访问 surfsense.com，登录后用自然语言向智能体索取实时市场数据。新账户自带 5 美元免费额度，无需订阅。

免费自托管

在你自己的基础设施上运行整个平台，包括连接器、智能体、自动化和 MCP 服务器。自托管部署默认关闭计费，抓取、爬取和智能体运行只受你的硬件和你自带的模型密钥限制。

**前置条件：**必须已安装并运行 Docker Desktop。

Linux/macOS：

curl -fsSL https://raw.githubusercontent.com/MODSetter/SurfSense/main/docker/scripts/install.sh | bash

Windows：

irm https://raw.githubusercontent.com/MODSetter/SurfSense/main/docker/scripts/install.ps1 | iex

安装脚本会自动配置 Watchtower 以实现每日自动更新。如需跳过，请加上 --no-watchtower 参数。关于 Docker Compose、手动安装及其他部署方式，请参阅文档。

竞争情报工作流

自动化功能可以按计划或响应事件运行完整的智能体回合，然后把结果写回 Notion、Slack、Linear 和 Jira。用自然语言描述工作流，SurfSense 就会替你构建，无需写代码。可以试试这些提示语：

• "盯住我们前 3 名竞争对手的定价页面，一旦套餐或价格变动就在 Slack 上提醒我。"
• "追踪 Reddit 和 YouTube 上对我们品牌的每一次提及，每天给我发一份摘要。"
• "监控我们前 10 个关键词的 Google 排名，按周标记下滑情况。"
• "每周一拉取我们门店以及竞争对手门店的最新 Google Maps 评论。"
• "每月生成一份竞争对手分析报告并保存到我的工作区。"

开箱即用的其他能力

让 SurfSense 成为领先的开源 NotebookLM 替代品的那套研究工作区依然都在，而且你的智能体收集到的一切都会汇入其中。

知识库

• 上传 PDF、Office 文档、图片和音频，或同步 Google Drive、OneDrive 和 Dropbox。支持 50 多种文件格式。
• 混合语义与全文搜索，提供 Perplexity 风格的带引用回答。
• AI 文件整理功能按来源、日期和主题自动归类文档。

成果工作室

• AI 报告生成器，可导出为 PDF、DOCX、HTML、LaTeX、EPUB、ODT 或纯文本。
• 20 秒内基于任意文档或文件夹生成双主持人 AI 播客。
• 可编辑的幻灯片、带旁白的视频概览以及 AI 图像生成。

团队协作

• 支持评论和提及的实时协作 AI 聊天。
• 基于角色的访问控制（RBAC），提供所有者、管理员、编辑者和查看者角色。

桌面应用

在电脑上的每个应用中获得原生 AI 辅助。从最新版本下载。

• General Assist：通过全局快捷键在任意应用中唤起 SurfSense。
• Quick Assist：在任意位置选中文本，让 AI 解释、改写或据此执行操作。
• Screenshot Assist：截取屏幕上任意区域，向 AI 提问。
• Watch Local Folder：把本地文件夹自动同步到知识库。将它指向你的 Obsidian 仓库，让笔记随时可搜索。

无供应商锁定

• 通过 OpenAI 规范和 LiteLLM 支持 100 多种 LLM，包括 GPT-5.5、Claude Sonnet 5 和 Gemini 3.1 Pro。
• 支持 6,000 多种嵌入模型和所有主流重排序器。
• 完整支持本地和私有 LLM（vLLM、Ollama），你的数据始终属于你。

视频智能体示例

https://github.com/user-attachments/assets/012a7ffa-6f76-4f06-9dda-7632b470057a

播客智能体示例

https://github.com/user-attachments/assets/a0a16566-6967-4374-ac51-9b3e07fbecd7

如何进行实时协作（Beta）

1. 进入成员管理页面并创建邀请。

   

2. 队友加入后，该工作区即变为共享。

   

3. 将聊天设为共享，即可与团队实时协作，并通过评论标记队友。

   

SurfSense 对比 Google NotebookLM

还在把我们当作 NotebookLM 替代品来比较？这里是坦诚的对比。

功能	Google NotebookLM	SurfSense
面向智能体的实时市场数据	无	通过 REST API 和 MCP 提供 Reddit、YouTube、Google Maps、Google Search 和网页爬取连接器
MCP 服务器	无	每个连接器都作为原生智能体工具暴露，还可自带 MCP 服务器并使用一键 OAuth 应用
每个笔记本的来源数	50 个（免费版）至 600 个（Ultra 版，249.99 美元/月）	无限制
笔记本数量	100 个（免费版）至 500 个（付费档位）	无限制
来源大小限制	每个来源 50 万字 / 200MB	无限制
定价	免费档；Pro 19.99 美元/月，Ultra 249.99 美元/月	自托管免费且开源；云端按量付费，附赠 5 美元免费额度
LLM 支持	仅 Google Gemini	通过 OpenAI 规范和 LiteLLM 支持 100 多种 LLM
嵌入模型	仅 Google	6,000 多种嵌入模型，所有主流重排序器
本地 / 私有 LLM	不支持	完整支持（vLLM、Ollama），你的数据始终属于你
可自托管	否	是，Docker 一行命令或完整 Docker Compose
开源	否	是
知识库来源	Google Drive、YouTube、网站	文件上传、Google Drive、OneDrive、Dropbox、本地文件夹同步以及爬取的网页
文件格式支持	PDF、Docs、Slides、Sheets、CSV、Word、EPUB、图片、网页 URL、YouTube	50 多种格式：文档、图片、视频，通过 LlamaCloud、Unstructured 或 Docling（本地）解析
搜索	语义搜索	混合语义 + 全文搜索，带分层索引和倒数排名融合
带引用的回答	有	有，Perplexity 风格的引用回答
智能体架构	无	有，由 LangChain Deep Agents 驱动，具备规划、子智能体和文件系统访问能力
AI 自动化与智能体	无	定时工作流、事件触发以及通过聊天构建的无代码自动化，可写回 Notion、Slack、Linear 和 Jira
实时多人协作	共享笔记本，仅有查看者/编辑者角色（无实时聊天）	RBAC 提供所有者 / 管理员 / 编辑者 / 查看者角色，支持实时聊天和评论串
视频生成	通过 Veo 3 生成电影级视频概览（仅 Ultra 版）	已提供（此项 NotebookLM 更强，我们正在积极改进）
演示文稿生成	幻灯片更美观但不可编辑	可编辑的幻灯片式演示文稿
播客生成	音频概览，支持自定义主持人和语言	已提供，支持多种 TTS 服务商（此项 NotebookLM 更强，我们正在积极改进）
桌面应用	无	原生应用，包含 General Assist、Quick Assist、Screenshot Assist 和本地文件夹同步

功能请求与未来规划

**SurfSense 正在积极开发中。**虽然它尚未达到生产就绪状态，但你可以帮助我们加快进度。

加入 SurfSense Discord，一起塑造 SurfSense 的未来！

路线图

随时了解我们的开发进度和即将推出的功能。查看我们的公开路线图，贡献你的想法或反馈：

路线图讨论：SurfSense 2026 Roadmap

看板：SurfSense Project Board

参与贡献

欢迎一切形式的贡献，从点星标、报告缺陷到后端改进。请参阅 CONTRIBUTING.md 开始参与。

感谢所有 Surfer：

Star 历史

---

---

---

---