SurfSense 开放网络研究平台

这个 Agent 能做什么，适合哪些场景？

SurfSense 是一个可自托管的开放网络研究与知识工作区，也被定位为开源 NotebookLM 替代方案。它通过 REST API 和 MCP server 提供 Reddit、YouTube、Instagram、TikTok、Google Search、Google Maps、Indeed、Amazon、Walmart 及普通网页的数据连接器。研究结果可以进入内置知识库，供混合语义与全文检索、带引用问答、报告、播客、演示文稿和视频概览使用。平台还支持定时或事件触发的智能体流程，并可将结果写回 Notion、Slack、Linear 和 Jira。它既提供按量付费的云服务，也能通过 Docker 在自己的基础设施上运行；自托管版本关闭计费，但需要用户提供硬件和模型密钥。项目仍在积极开发，并明确表示尚未达到生产就绪状态。

用户或智能体先通过自然语言工作区、REST endpoint，或 MCP server 调用数据连接器；例如 Reddit 接口为 POST /workspaces/$WORKSPACE_ID/scrapers/reddit/scrape，MCP 则暴露 surfsense_reddit_scrape、surfsense_google_search 等原生工具。连接器读取公开帖子、评论、视频字幕、搜索结果、地点评价、职位和商品数据，Web Crawl 则把开放网页转换成结构化内容。智能体执行层提供重试、结构化输出和用量计量，并能把检索结果整理成带引用的简报或提醒。所得内容可进入知识库，与上传文件、Google Drive、OneDrive、Dropbox 或本地文件夹同步的数据一起接受混合检索和引用式问答。Deliverable studio 可生成并导出 PDF、DOCX、HTML、LaTeX、EPUB、ODT 或纯文本报告，还能制作播客、可编辑幻灯片、视频概览和 AI 图像。自动化可按时间表或事件运行完整智能体轮次，并把输出写回 Notion、Slack、Linear 或 Jira。

1. 品牌研究人员需要汇总产品发布后一周内 Reddit 帖子与评论，并生成带出处的舆情简报。
2. 本地商业分析师需要批量读取 Google Maps 地点、评分和评论，比较多家门店反复出现的投诉。
3. 招聘或市场团队需要检索 Indeed 公开职位、薪资和完整描述，并将持续监测结果写入协作工具。
4. 研究团队希望把 PDF、办公文档和云盘内容与实时网页资料放入同一知识库，进行带引用问答和报告导出。
5. 开发者希望通过 MCP 把 Reddit、YouTube、搜索和网页抓取能力直接提供给 Claude、Cursor 或自有智能体框架。
6. 有数据私有化要求的团队希望用 Docker 自托管研究平台，并通过 Ollama 或 vLLM 使用本地模型。

这个 Agent 有哪些优点和局限？

如何安装或部署这个 Agent？

自托管前需安装并运行 Docker Desktop。Linux/macOS 执行：

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

Windows PowerShell 执行：

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

安装脚本默认配置 Watchtower，每日自动更新；如不需要，可加 --no-watchtower。自托管实例关闭计费，但智能体运行仍需要自备模型密钥。来源还提到 Docker Compose 和手动部署选项，但未在所给材料中列出完整命令。

如何使用这个 Agent？

调用 REST connector 前，准备 SurfSense API key、workspace ID 和实例的 API URL。首次 Reddit 调用示例：

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":"SaaS","sort":"top","time_filter":"week"}'

若通过 MCP 使用，在 Claude、Cursor 或自有框架中配置：

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

完成后，智能体即可把各连接器作为原生工具调用。云端使用方式是登录 surfsense.com，以自然语言要求智能体获取实时网络数据；新账户提供 5 美元免费额度且无需订阅。

这个 Agent 与同类方案有什么区别？

常见问题