diff --git a/README.es.md b/README.es.md
index ea7623617..7689cb9bd 100644
--- a/README.es.md
+++ b/README.es.md
@@ -1,4 +1,4 @@
-
+
@@ -20,289 +20,226 @@
-# SurfSense
+# SurfSense: Dale inteligencia competitiva a tus agentes de IA
-NotebookLM es una de las mejores y más útiles plataformas de IA que existen, pero una vez que comienzas a usarla regularmente también sientes sus limitaciones dejando algo que desear.
+SurfSense es la **plataforma de inteligencia competitiva de código abierto para agentes de IA**. Tus agentes monitorean a la competencia, siguen los rankings y escuchan a tu mercado con datos en vivo de **Reddit, YouTube, Google Maps, Google Search y la web abierta**, a través de una única **API REST** o un **servidor MCP**. Agentes programados y activados por eventos convierten lo que encuentran en informes y alertas, y una base de conocimiento integrada mantiene cada hallazgo disponible para búsqueda con citas.
-1. Hay límites en la cantidad de fuentes que puedes agregar en un notebook.
-2. Hay límites en la cantidad de notebooks que puedes tener.
-3. No puedes tener fuentes que excedan 500,000 palabras y más de 200MB.
-4. Estás bloqueado con los servicios de Google (LLMs, modelos de uso, etc.) sin opción de configurarlos.
-5. Fuentes de datos externas e integraciones de servicios limitadas.
-6. El agente de NotebookLM está específicamente optimizado solo para estudiar e investigar, pero puedes hacer mucho más con los datos de origen.
-7. Falta de soporte multijugador.
+> [!NOTE]
+> **📢 Una nota para nuestros usuarios de la alternativa a NotebookLM**
+>
+> Durante los últimos meses construimos SurfSense como el mejor agente de investigación general para tu propio conocimiento, y ese capítulo nos dio una comunidad de la que estamos genuinamente orgullosos. Herramientas agénticas como Claude, OpenCode, Hermes y OpenClaw ya han demostrado que los agentes son el futuro, y la investigación general se está convirtiendo en algo que todo agente capaz hace de fábrica. Lo que a los agentes todavía les falta son **datos de mercado en vivo y los flujos de trabajo a su alrededor**, así que ahí es donde estamos dirigiendo toda nuestra energía: convertirnos en la plataforma definitiva de agentes de inteligencia competitiva de código abierto.
+>
+> **Nada de lo que dependes va a desaparecer.** Tu base de conocimiento, el chat con citas, los informes, los podcasts, las presentaciones, las automatizaciones y los chats colaborativos siguen funcionando, y el autoalojamiento sigue siendo gratuito y de código abierto. Lee el anuncio completo en [nuestro changelog](https://www.surfsense.com/changelog).
-...y más.
+## Por qué los agentes necesitan SurfSense
-**SurfSense está específicamente hecho para resolver estos problemas.** SurfSense te permite:
+Pregúntale a cualquier agente capaz "¿cuánto están cobrando los competidores esta semana?" o "¿qué está diciendo Reddit sobre nosotros desde el lanzamiento?" y no tiene ningún lugar confiable donde buscar. Las APIs oficiales de las plataformas tienen límites de tasa, precios pensados para empresas grandes o directamente no existen, y la infraestructura de scraping es frágil. SurfSense cierra esa brecha:
-- **Controla Tu Flujo de Datos** - Mantén tus datos privados y seguros.
-- **Sin Límites de Datos** - Agrega una cantidad ilimitada de fuentes y notebooks.
-- **Sin Dependencia de Proveedores** - Configura cualquier modelo LLM, de imagen, TTS y STT.
-- **25+ Fuentes de Datos Externas** - Agrega tus fuentes desde Google Drive, OneDrive, Dropbox, Notion y muchos otros servicios externos.
-- **Soporte Multijugador en Tiempo Real** - Trabaja fácilmente con los miembros de tu equipo en un notebook compartido.
-- **Automatizaciones y Agentes de IA** - Ejecuta agentes de IA según una programación o actívalos en el momento en que un documento llega a una carpeta, y luego escribe los resultados de vuelta en Notion, Slack, Linear y Drive. Crea automatizaciones sin código solo describiéndolas en el chat.
-- **Aplicación de Escritorio** - Obtén asistencia de IA en cualquier aplicación con Quick Assist, General Assist, Screenshot Assist y sincronización de carpetas locales.
+- **Conectores nativos por plataforma**, cada uno un endpoint REST tipado que devuelve JSON estructurado. Sin ruleta de límites de tasa, sin parsear HTML.
+- **Un servidor MCP** que expone cada conector como una herramienta nativa (`reddit.scrape`, `google_search.scrape` y más) para Claude, Cursor o cualquier framework de agentes.
+- **Un arnés de agentes**, no solo datos en bruto: reintentos, salida estructurada y medición de créditos vienen integrados, así que los agentes pasan de una pregunta a un informe sin que tú construyas la infraestructura.
+- **Código abierto y autoalojable**, para que tu investigación competitiva se quede en tu propia infraestructura.
-...y más por venir.
+## Conectores de datos en vivo
+| Conector | Qué obtienen tus agentes | Más información |
+|---|---|---|
+| **Reddit** | Publicaciones, comentarios y flujos de subreddits sin los límites de tasa de la API oficial | [Reddit Scraper API](https://www.surfsense.com/reddit) |
+| **YouTube** | Videos, transcripciones e hilos de comentarios para escuchar a tu marca y productos | [YouTube Scraper API](https://www.surfsense.com/youtube) |
+| **Google Maps** | Lugares, calificaciones y reseñas para investigar competidores locales y prospectos | [Google Maps Scraper API](https://www.surfsense.com/google-maps) |
+| **Google Search** | SERPs en vivo para seguimiento de posiciones y monitoreo de mercado | [Google Search API](https://www.surfsense.com/google-search) |
+| **Web Crawl** (rastreo web) | Cualquier página de la web abierta como contenido limpio y estructurado | [Web Crawling API](https://www.surfsense.com/web-crawl) |
+| **MCP Connector** | Conecta cualquier servidor MCP a tus agentes, con OAuth de un clic para Notion, Slack, Jira y más | [MCP Connector](https://www.surfsense.com/mcp-connector) |
+La facturación es de pago por uso: los conectores facturan por elemento realmente devuelto, los rastreos por página obtenida con éxito, y las llamadas fallidas nunca se facturan. Las instalaciones autoalojadas funcionan con la facturación desactivada. Consulta los [precios](https://www.surfsense.com/pricing).
-## Ejemplo de Agente de Video
+## Inicio rápido
-https://github.com/user-attachments/assets/012a7ffa-6f76-4f06-9dda-7632b470057a
+### Llama a un conector desde código
+Cada conector es un endpoint REST que puedes llamar desde cualquier lenguaje con tu clave de API de SurfSense:
+```bash
+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"
+ }'
+```
-## Ejemplo de Agente de Podcast
+Cada [página de conector](https://www.surfsense.com/connectors) tiene ejemplos listos para copiar y pegar en Python, JavaScript, Go, PHP, Ruby, Java y C#.
-https://github.com/user-attachments/assets/a0a16566-6967-4374-ac51-9b3e07fbecd7
+### Dale las herramientas a tus agentes vía MCP
+Agrega el servidor MCP de SurfSense a Claude, Cursor o tu propio framework de agentes:
-## Cómo usar SurfSense
+```json
+{
+ "mcpServers": {
+ "surfsense": {
+ "url": "https://mcp.surfsense.com",
+ "headers": { "Authorization": "Bearer ${SURFSENSE_API_KEY}" }
+ }
+ }
+}
+```
-### Cloud
+Tu agente ahora puede llamar a cada conector como una herramienta nativa.
-1. Ve a [surfsense.com](https://www.surfsense.com) e inicia sesión.
+### Usa la nube
-
+Ve a [surfsense.com](https://www.surfsense.com), inicia sesión y pídele al agente datos de mercado en vivo en lenguaje natural. Las cuentas nuevas comienzan con $5 de crédito gratuito y sin suscripción.
-2. Conecta tus conectores y sincroniza. Activa la sincronización periódica para mantenerlos actualizados.
+
-
+### Autoalójalo gratis
-3. Mientras se indexan los datos de los conectores, sube documentos.
-
-
-
-4. Una vez que todo esté indexado, pregunta lo que quieras (Casos de uso):
-
- **Aplicación de Escritorio** (extras nativos, además de todo lo de abajo, no un conjunto aparte)
-
- - General Assist: abre SurfSense al instante desde cualquier aplicación con un atajo global.
-
-
-
- - Quick Assist: selecciona texto en cualquier lugar y pide a la IA que lo explique, reescriba o actúe sobre él.
-
-
-
- - Screenshot Assist: captura cualquier región de tu pantalla y pregunta a la IA sobre lo que contiene.
-
-
-
- - Watch Local Folder: sincroniza automáticamente una carpeta local con tu base de conocimiento. Ideal para bóvedas de Obsidian.
-
-
-
- **Estudio de Entregables**
-
- - AI Report Generator: genera informes de investigación con citas y expórtalos a PDF, DOCX, HTML, LaTeX, EPUB, ODT o texto plano.
-
-
-
- - AI Podcast Generator: convierte cualquier documento o carpeta en un pódcast de IA con dos presentadores en menos de 20 segundos.
-
-
-
- - AI Presentation & Video Maker: crea presentaciones editables y videos narrados a partir de tus fuentes.
-
-
-
- - AI Image Generator: genera imágenes de alta calidad directamente desde tus chats y documentos.
-
-
-
- - AI Resume Builder: adapta tu currículum existente a cualquier descripción de empleo y supera el ATS.
- Prueba indicaciones como estas:
-
- - "Adapta mi currículum a esta descripción de empleo para superar el ATS y conseguir una entrevista."
- - "Optimiza mi currículum para ATS haciendo coincidir las palabras clave de esta oferta."
- - "Reescribe los puntos de mi currículum para resaltar las habilidades que pide este puesto."
- - "Compara mi currículum con esta descripción de empleo y enumera las carencias a corregir."
- - "Escribe una carta de presentación a juego con mi currículum y esta descripción de empleo."
-
- **Búsqueda y Chat**
-
- - Chat With Your PDFs & Docs: haz preguntas sobre todos tus archivos y obtén respuestas con citas en línea.
-
-
-
- - AI Search With Citations: búsqueda híbrida semántica y por palabras clave en toda tu base de conocimiento.
-
-
-
- - Collaborative AI Chat: trabaja en conversaciones de IA con tu equipo en tiempo real.
-
-
-
- - Comments & Mentions: comenta y menciona a tus compañeros en cualquier mensaje de IA.
-
-
-
- **Conectores e Integraciones**
-
- - Connect & Sync Your Tools: sincroniza Notion, Slack, Google Drive, Gmail, GitHub, Linear y más de 25 fuentes en un único corpus consultable.
-
-
-
- - Chat With Uploaded Files: sube PDFs, documentos de Office, imágenes y audio. Consultables al instante.
-
-
-
- - Connector Write-Back: deja que el agente publique los resultados de vuelta en Notion, Slack, Linear y Drive.
- Prueba indicaciones como estas:
-
- - "Publica este resumen de investigación en mi espacio de Notion."
- - "Envía estos elementos de acción de la reunión a nuestro canal de Slack."
- - "Crea un ticket de Jira a partir de este informe de error."
- - "Abre una incidencia en Linear a partir de esta solicitud de función."
- - "Guarda este informe generado en Google Drive como un documento."
-
- - Obsidian & Knowledge Base Sync: mantén tu bóveda de Obsidian y tu base de conocimiento personal sincronizadas.
-
- **Automatizaciones**
-
- - Scheduled AI Workflows: ejecuta un agente según una programación: resúmenes diarios, boletines semanales, informes recurrentes.
- Prueba indicaciones como estas:
-
- - "Envíame cada mañana un resumen diario de los nuevos documentos en mi base de conocimiento."
- - "Genera un informe de estado semanal a partir de mi Slack y Gmail cada viernes."
- - "Ejecuta un informe mensual de análisis de la competencia y guárdalo en mi espacio de trabajo."
- - "Resume mi actividad de GitHub y Linear en una actualización diaria de standup."
- - "Crea un informe de investigación semanal recurrente sobre los temas que sigo."
-
- - Event-Triggered Automations: lanza un agente en el momento en que un documento llega a una carpeta y publica el resultado en tus herramientas.
- Prueba indicaciones como estas:
-
- - "Cuando llegue un PDF a mi carpeta de Investigación, genera un resumen de IA con citas."
- - "Cuando se añadan nuevas notas de reunión, conviértelas en actas con elementos de acción."
- - "Cuando se suba una factura, extrae el proveedor, el total y la fecha de vencimiento en una tabla."
- - "Cuando entre un contrato en mi carpeta Legal, señala los términos clave y las fechas de renovación."
- - "Cuando se añada un currículum a Candidatos, evalúalo frente a la descripción del empleo."
-
- - Chat-Built Automations: describe una automatización en lenguaje sencillo y SurfSense la crea por ti.
- Prueba indicaciones como estas:
-
- - "Crea un agente de IA que me envíe cada mañana un resumen de las nuevas páginas de Notion."
- - "Crea una automatización sin código que publique un resumen de investigación semanal en Slack."
- - "Configura un tomador de notas con IA que convierta las nuevas notas de reunión en actas."
- - "Crea un flujo que extraiga los elementos de acción de las notas de reunión y asigne responsables."
- - "Automatiza un resumen diario por correo a partir de mi Gmail y Google Drive."
-
-
-### Auto-Hospedado
-
-Ejecuta SurfSense en tu propia infraestructura para control total de datos y privacidad.
+Ejecuta toda la plataforma, los conectores, los agentes, las automatizaciones y el servidor MCP en tu propia infraestructura. Las instalaciones autoalojadas vienen con la facturación desactivada, así que el scraping, el rastreo y las ejecuciones de agentes solo están limitados por tu hardware y las claves de modelos que aportes.
**Requisitos previos:** [Docker Desktop](https://www.docker.com/products/docker-desktop/) debe estar instalado y en ejecución.
-#### Para usuarios de Linux/MacOS:
+Para Linux/macOS:
```bash
curl -fsSL https://raw.githubusercontent.com/MODSetter/SurfSense/main/docker/scripts/install.sh | bash
```
-#### Para usuarios de Windows:
+Para Windows:
-```powershell
+```bash
irm https://raw.githubusercontent.com/MODSetter/SurfSense/main/docker/scripts/install.ps1 | iex
```
-El script de instalación configura [Watchtower](https://github.com/nicholas-fedor/watchtower) automáticamente para actualizaciones diarias. Para omitirlo, agrega la bandera `--no-watchtower`.
+El script de instalación configura [Watchtower](https://github.com/nicholas-fedor/watchtower) automáticamente para actualizaciones automáticas diarias. Para omitirlo, agrega la opción `--no-watchtower`. Para Docker Compose, instalación manual y otras opciones de despliegue, consulta la [documentación](https://www.surfsense.com/docs/).
-Para Docker Compose, instalación manual y otras opciones de despliegue, consulta la [documentación](https://www.surfsense.com/docs/).
+## Flujos de trabajo de inteligencia competitiva
-### Aplicación de Escritorio
+Las automatizaciones ejecutan turnos completos de agente según un horario o en respuesta a eventos, y luego escriben los resultados en Notion, Slack, Linear y Jira. Describe el flujo de trabajo en lenguaje natural y SurfSense lo construye, sin necesidad de código. Prueba con instrucciones como:
-SurfSense también ofrece una aplicación de escritorio que lleva la asistencia de IA a cada aplicación en tu computadora. Descárgala desde la [última versión](https://github.com/MODSetter/SurfSense/releases/latest).
+- "Vigila las páginas de precios de nuestros 3 principales competidores y avísame en Slack cuando cambie un plan o un precio."
+- "Rastrea cada mención de nuestra marca en Reddit y YouTube y envíame un resumen diario."
+- "Monitorea nuestro ranking en Google para nuestras 10 palabras clave principales y señala las caídas semana a semana."
+- "Extrae las nuevas reseñas de Google Maps de nuestras ubicaciones y las de nuestros competidores cada lunes."
+- "Ejecuta un informe mensual de análisis de la competencia y guárdalo en mi espacio de trabajo."
-La aplicación de escritorio incluye estas potentes funciones:
+
-- **General Assist** — Lanza SurfSense al instante desde cualquier aplicación con un atajo global.
-- **Quick Assist** — Selecciona texto en cualquier lugar, luego pide a la IA que lo explique, reescriba o actúe sobre él.
-- **Screenshot Assist** — Selecciona una región de tu pantalla y adjúntala al chat para que las respuestas se basen en tu base de conocimiento.
-- **Watch Local Folder** — Vigila una carpeta local y sincroniza automáticamente los cambios de archivos con tu base de conocimiento. **Pro tip:** Apúntalo a tu bóveda de Obsidian para mantener tus notas buscables en SurfSense.
+## Todo lo demás que viene incluido
-Todas las funciones operan contra tu espacio de búsqueda elegido, por lo que tus respuestas siempre están basadas en tus propios datos.
+El espacio de trabajo de investigación que convirtió a SurfSense en la alternativa de código abierto líder a NotebookLM sigue aquí, y todo lo que tus agentes recopilan aterriza en él.
-### Cómo Colaborar en Tiempo Real (Beta)
+**Base de conocimiento**
-1. Ve a la página de Gestión de Miembros y crea una invitación.
+- Sube PDFs, documentos de Office, imágenes y audio, o sincroniza **Google Drive, OneDrive y Dropbox**. Más de 50 formatos de archivo compatibles.
+- Búsqueda híbrida semántica y de texto completo con respuestas citadas al estilo Perplexity.
+- La organización de archivos con IA clasifica los documentos automáticamente por fuente, fecha y tema.
-
+
-2. El compañero de equipo se une y ese SearchSpace se comparte.
+**Estudio de entregables**
-
+- Generador de informes con IA con exportación a PDF, DOCX, HTML, LaTeX, EPUB, ODT o texto plano.
+- Podcasts de IA con dos presentadores a partir de cualquier documento o carpeta en menos de 20 segundos.
+- Presentaciones de diapositivas editables, resúmenes en video narrados y generación de imágenes con IA.
-3. Haz el chat compartido.
+
-
+**Colaboración en equipo**
-4. Tu equipo ahora puede chatear en tiempo real.
+- Chats de IA colaborativos en tiempo real con comentarios y menciones.
+- RBAC con roles de Propietario, Administrador, Editor y Visualizador.
-
+
-5. Agrega comentarios para etiquetar a compañeros de equipo.
+**Aplicación de escritorio**
-
+Asistencia de IA nativa en todas las aplicaciones de tu computadora. Descárgala desde la [última versión](https://github.com/MODSetter/SurfSense/releases/latest).
+
+- **General Assist**: abre SurfSense desde cualquier aplicación con un atajo global.
+- **Quick Assist**: selecciona texto en cualquier lugar y pídele a la IA que lo explique, lo reescriba o actúe sobre él.
+- **Screenshot Assist**: captura cualquier región de tu pantalla y pregúntale a la IA sobre ella.
+- **Watch Local Folder** (vigilar carpeta local): sincroniza automáticamente una carpeta local con tu base de conocimiento. Apúntala a tu bóveda de Obsidian para mantener tus notas disponibles para búsqueda.
+
+
+
+**Sin dependencia de un proveedor**
+
+- Más de 100 LLMs vía la especificación de OpenAI y LiteLLM, incluidos GPT-5.5, Claude Sonnet 5 y Gemini 3.1 Pro.
+- Más de 6,000 modelos de embeddings y todos los rerankers principales.
+- Soporte completo para LLMs locales y privados (vLLM, Ollama), para que tus datos sigan siendo tuyos.
+
+## Muestra del agente de video
+
+https://github.com/user-attachments/assets/012a7ffa-6f76-4f06-9dda-7632b470057a
+
+## Muestra del agente de podcast
+
+https://github.com/user-attachments/assets/a0a16566-6967-4374-ac51-9b3e07fbecd7
+
+## Cómo colaborar en tiempo real (Beta)
+
+1. Ve a la página de administración de miembros y crea una invitación.
+
+
+
+2. Un compañero de equipo se une y ese espacio de trabajo se vuelve compartido.
+
+
+
+3. Haz que un chat sea compartido y trabajen en él juntos en tiempo real, con comentarios para etiquetar a compañeros.
+
+
## SurfSense vs Google NotebookLM
+¿Todavía nos comparas como una alternativa a NotebookLM? Aquí tienes el desglose honesto.
+
| Característica | Google NotebookLM | SurfSense |
|---------|-------------------|-----------|
-| **Fuentes por Notebook** | 50 (Gratis) a 600 (Ultra, $249.99/mes) | Ilimitadas |
-| **Número de Notebooks** | 100 (Gratis) a 500 (planes de pago) | Ilimitados |
-| **Límite de Tamaño de Fuente** | 500,000 palabras / 200MB por fuente | Sin límite |
-| **Precios** | Nivel gratuito disponible; Pro $19.99/mes, Ultra $249.99/mes | Gratuito y de código abierto, auto-hospedable en tu propia infra |
-| **Soporte de LLM** | Solo Google Gemini | 100+ LLMs vía OpenAI spec y LiteLLM |
-| **Modelos de Embeddings** | Solo Google | 6,000+ modelos de embeddings, todos los principales rerankers |
-| **LLMs Locales / Privados** | No disponible | Soporte completo (vLLM, Ollama) - tus datos son tuyos |
-| **Auto-Hospedable** | No | Sí - Docker en un solo comando o Docker Compose completo |
-| **Código Abierto** | No | Sí |
-| **Conectores Externos** | Google Drive, YouTube, sitios web | 27+ conectores - Motores de búsqueda, Google Drive, OneDrive, Dropbox, Slack, Teams, Jira, Notion, GitHub, Discord y [más](#fuentes-externas) |
-| **Soporte de Formatos de Archivo** | PDFs, Docs, Slides, Sheets, CSV, Word, EPUB, imágenes, URLs web, YouTube | 50+ formatos - documentos, imágenes, videos vía LlamaCloud, Unstructured o Docling (local) |
-| **Búsqueda** | Búsqueda semántica | Búsqueda Híbrida - Semántica + Texto completo con Índices Jerárquicos y Reciprocal Rank Fusion |
-| **Respuestas con Citas** | Sí | Sí - Respuestas citadas al estilo Perplexity |
-| **Arquitectura de Agentes** | No | Sí - impulsado por [LangChain Deep Agents](https://docs.langchain.com/oss/python/deepagents/overview) con planificación, subagentes y acceso al sistema de archivos |
-| **Multijugador en Tiempo Real** | Notebooks compartidos con roles de Visor/Editor (sin chat en tiempo real) | RBAC con roles de Propietario / Admin / Editor / Visor, chat en tiempo real e hilos de comentarios |
-| **Generación de Videos** | Resúmenes en video cinemáticos vía Veo 3 (solo Ultra) | Disponible (NotebookLM es mejor aquí, mejorando activamente) |
-| **Generación de Presentaciones** | Diapositivas más atractivas pero no editables | Crea presentaciones editables basadas en diapositivas |
-| **Generación de Podcasts** | Resúmenes de audio con hosts e idiomas personalizables | Disponible con múltiples proveedores TTS (NotebookLM es mejor aquí, mejorando activamente) |
-| **Automatizaciones y Agentes de IA** | No | Flujos de trabajo de IA programados, disparadores por eventos en documentos nuevos y automatizaciones sin código creadas por chat con escritura de vuelta a Notion, Slack, Linear y Jira |
-| **Aplicación de Escritorio** | No | Aplicación nativa con General Assist, Quick Assist, Screenshot Assist y sincronización de carpetas locales |
-| **Extensión de Navegador** | No | Extensión multi-navegador para guardar cualquier página web, incluyendo páginas protegidas por autenticación |
+| **Datos de mercado en vivo para agentes** | No | Conectores de Reddit, YouTube, Google Maps, Google Search y rastreo web vía API REST y MCP |
+| **Servidor MCP** | No | Cada conector expuesto como herramienta nativa de agente, más servidores MCP propios con aplicaciones OAuth de un clic |
+| **Fuentes por Notebook** | 50 (gratis) a 600 (Ultra, $249.99/mes) | Ilimitadas |
+| **Número de Notebooks** | 100 (gratis) a 500 (niveles de pago) | Ilimitado |
+| **Límite de tamaño por fuente** | 500,000 palabras / 200MB por fuente | Sin límite |
+| **Precios** | Nivel gratuito; Pro $19.99/mes, Ultra $249.99/mes | Gratuito y de código abierto para autoalojar; la nube es de pago por uso con $5 de crédito gratuito |
+| **Soporte de LLM** | Solo Google Gemini | Más de 100 LLMs vía la especificación de OpenAI y LiteLLM |
+| **Modelos de embeddings** | Solo Google | Más de 6,000 modelos de embeddings, todos los rerankers principales |
+| **LLMs locales / privados** | No disponible | Soporte completo (vLLM, Ollama), tus datos siguen siendo tuyos |
+| **Autoalojable** | No | Sí, con un solo comando de Docker o Docker Compose completo |
+| **Código abierto** | No | Sí |
+| **Fuentes de la base de conocimiento** | Google Drive, YouTube, sitios web | Subida de archivos, Google Drive, OneDrive, Dropbox, sincronización de carpetas locales y páginas rastreadas |
+| **Formatos de archivo compatibles** | PDFs, Docs, Slides, Sheets, CSV, Word, EPUB, imágenes, URLs web, YouTube | Más de 50 formatos: documentos, imágenes, videos vía LlamaCloud, Unstructured o Docling (local) |
+| **Búsqueda** | Búsqueda semántica | Híbrida semántica + texto completo con índices jerárquicos y fusión de rangos recíprocos |
+| **Respuestas con citas** | Sí | Sí, respuestas citadas al estilo Perplexity |
+| **Arquitectura agéntica** | No | Sí, impulsada por [LangChain Deep Agents](https://docs.langchain.com/oss/python/deepagents/overview) con planificación, subagentes y acceso al sistema de archivos |
+| **Automatizaciones y agentes de IA** | No | Flujos de trabajo programados, activadores por eventos y automatizaciones sin código creadas por chat con escritura en Notion, Slack, Linear y Jira |
+| **Multijugador en tiempo real** | Notebooks compartidos con roles de Visualizador/Editor (sin chat en tiempo real) | RBAC con roles de Propietario / Administrador / Editor / Visualizador, chat en tiempo real e hilos de comentarios |
+| **Generación de video** | Resúmenes de video cinematográficos vía Veo 3 (solo Ultra) | Disponible (NotebookLM es mejor aquí, en mejora activa) |
+| **Generación de presentaciones** | Diapositivas más atractivas pero no editables | Presentaciones editables basadas en diapositivas |
+| **Generación de podcasts** | Resúmenes de audio con presentadores e idiomas personalizables | Disponible con múltiples proveedores de TTS (NotebookLM es mejor aquí, en mejora activa) |
+| **Aplicación de escritorio** | No | Aplicación nativa con General Assist, Quick Assist, Screenshot Assist y sincronización de carpetas locales |
-
-Lista completa de Fuentes Externas
-
+## Solicitudes de funciones y futuro
-Motores de Búsqueda (SearXNG, Tavily, LinkUp, Baidu Search) · Google Drive · OneDrive · Dropbox · Slack · Microsoft Teams · Linear · Jira · ClickUp · Confluence · BookStack · Notion · Gmail · Videos de YouTube · GitHub · Discord · Airtable · Google Calendar · Luma · Circleback · Elasticsearch · Obsidian, y más por venir.
-
-
-
-
-## SOLICITUDES DE FUNCIONES Y FUTURO
-
-
-**SurfSense está en desarrollo activo.** Aunque aún no está listo para producción, puedes ayudarnos a acelerar el proceso.
+**SurfSense está en desarrollo activo.** Aunque todavía no está listo para producción, puedes ayudarnos a acelerar el proceso.
¡Únete al [Discord de SurfSense](https://discord.gg/ejRNvftDp9) y ayuda a dar forma al futuro de SurfSense!
-## Hoja de Ruta
+## Hoja de ruta
-¡Mantente al día con nuestro progreso de desarrollo y próximas funcionalidades!
-Consulta nuestra hoja de ruta pública y contribuye con tus ideas o comentarios:
+Mantente al día con nuestro progreso de desarrollo y las próximas funciones. Consulta nuestra hoja de ruta pública y aporta tus ideas o comentarios:
-**Discusión de la Hoja de Ruta:** [SurfSense 2026 Roadmap](https://github.com/MODSetter/SurfSense/discussions/565)
+**Discusión de la hoja de ruta:** [SurfSense 2026 Roadmap](https://github.com/MODSetter/SurfSense/discussions/565)
**Tablero Kanban:** [SurfSense Project Board](https://github.com/users/MODSetter/projects/3)
+## Contribuye
-## Contribuir
-
-Todas las contribuciones son bienvenidas, desde estrellas y reportes de bugs hasta mejoras del backend. Consulta [CONTRIBUTING.md](CONTRIBUTING.md) para comenzar.
+Todas las contribuciones son bienvenidas, desde estrellas y reportes de errores hasta mejoras del backend. Consulta [CONTRIBUTING.md](CONTRIBUTING.md) para comenzar.
Gracias a todos nuestros Surfers:
@@ -310,7 +247,7 @@ Gracias a todos nuestros Surfers:
-## Historial de Stars
+## Historial de estrellas
diff --git a/README.hi.md b/README.hi.md
index 10b246385..62e81697d 100644
--- a/README.hi.md
+++ b/README.hi.md
@@ -1,4 +1,4 @@
-
+
@@ -20,297 +20,234 @@
-# SurfSense
+# SurfSense: अपने AI एजेंट्स को दें कॉम्पिटिटिव इंटेलिजेंस
-NotebookLM वहाँ उपलब्ध सबसे अच्छे और सबसे उपयोगी AI प्लेटफ़ॉर्म में से एक है, लेकिन जब आप इसे नियमित रूप से उपयोग करना शुरू करते हैं तो आप इसकी सीमाओं को भी महसूस करते हैं जो कुछ और की चाह छोड़ती हैं।
+SurfSense **AI एजेंट्स के लिए ओपन सोर्स कॉम्पिटिटिव इंटेलिजेंस प्लेटफ़ॉर्म** है। आपके एजेंट प्रतिस्पर्धियों पर नज़र रखते हैं, रैंकिंग ट्रैक करते हैं, और **Reddit, YouTube, Google Maps, Google Search और ओपन वेब** से लाइव डेटा के साथ आपके बाज़ार की बात सुनते हैं, वह भी एक ही **REST API** या **MCP सर्वर** के ज़रिए। शेड्यूल्ड और इवेंट-ट्रिगर्ड एजेंट अपनी खोजों को ब्रीफ़ और अलर्ट में बदलते हैं, और एक बिल्ट-इन नॉलेज बेस हर खोज को साइटेशन के साथ खोजने योग्य बनाए रखता है।
-1. एक notebook में जोड़े जा सकने वाले स्रोतों की मात्रा पर सीमाएं हैं।
-2. आपके पास कितने notebooks हो सकते हैं इस पर सीमाएं हैं।
-3. आपके पास ऐसे स्रोत नहीं हो सकते जो 500,000 शब्दों और 200MB से अधिक हों।
-4. आप Google सेवाओं (LLMs, उपयोग मॉडल, आदि) में बंद हैं और उन्हें कॉन्फ़िगर करने का कोई विकल्प नहीं है।
-5. सीमित बाहरी डेटा स्रोत और सेवा एकीकरण।
-6. NotebookLM एजेंट विशेष रूप से केवल अध्ययन और शोध के लिए अनुकूलित है, लेकिन आप स्रोत डेटा के साथ और भी बहुत कुछ कर सकते हैं।
-7. मल्टीप्लेयर सपोर्ट की कमी।
+> [!NOTE]
+> **📢 हमारे NotebookLM-विकल्प उपयोगकर्ताओं के लिए एक सूचना**
+>
+> पिछले कुछ महीनों में हमने SurfSense को आपके अपने ज्ञान के लिए सबसे बेहतरीन जनरल रिसर्च एजेंट के रूप में बनाया, और उस अध्याय ने हमें एक ऐसा समुदाय दिया जिस पर हमें सचमुच गर्व है। Claude, OpenCode, Hermes और OpenClaw जैसे एजेंटिक टूल्स ने अब साबित कर दिया है कि एजेंट ही भविष्य हैं, और जनरल रिसर्च अब हर सक्षम एजेंट की एक बुनियादी क्षमता बनती जा रही है। एजेंट्स के पास अब भी जिस चीज़ की कमी है वह है **लाइव मार्केट डेटा और उसके इर्द-गिर्द के वर्कफ़्लो**, इसलिए हम अपनी पूरी ऊर्जा वहीं लगा रहे हैं: निश्चित रूप से सबसे बेहतरीन ओपन सोर्स कॉम्पिटिटिव इंटेलिजेंस एजेंट प्लेटफ़ॉर्म बनना।
+>
+> **आप जिस भी चीज़ पर निर्भर हैं, वह कहीं नहीं जा रही।** आपका नॉलेज बेस, साइटेशन वाली चैट, रिपोर्ट, पॉडकास्ट, प्रेज़ेंटेशन, ऑटोमेशन और सहयोगी चैट, सब पहले की तरह काम करते रहेंगे, और सेल्फ-होस्टिंग मुफ़्त और ओपन सोर्स बनी रहेगी। पूरी घोषणा [हमारे changelog](https://www.surfsense.com/changelog) पर पढ़ें।
-...और भी बहुत कुछ।
+## एजेंट्स को SurfSense की ज़रूरत क्यों है
-**SurfSense विशेष रूप से इन समस्याओं को हल करने के लिए बनाया गया है।** SurfSense आपको सक्षम बनाता है:
+किसी भी सक्षम एजेंट से पूछिए "इस हफ़्ते प्रतिस्पर्धी क्या दाम ले रहे हैं?" या "लॉन्च के बाद से Reddit पर हमारे बारे में क्या कहा जा रहा है?" और उसके पास देखने के लिए कोई भरोसेमंद जगह नहीं होती। आधिकारिक प्लेटफ़ॉर्म API या तो रेट-लिमिटेड हैं, एंटरप्राइज़ के हिसाब से महंगे हैं, या हैं ही नहीं, और स्क्रैपिंग का ढांचा नाज़ुक होता है। SurfSense इसी कमी को पूरा करता है:
-- **अपने डेटा प्रवाह को नियंत्रित करें** - अपने डेटा को निजी और सुरक्षित रखें।
-- **कोई डेटा सीमा नहीं** - असीमित मात्रा में स्रोत और notebooks जोड़ें।
-- **कोई विक्रेता लॉक-इन नहीं** - किसी भी LLM, इमेज, TTS और STT मॉडल को कॉन्फ़िगर करें।
-- **25+ बाहरी डेटा स्रोत** - Google Drive, OneDrive, Dropbox, Notion और कई अन्य बाहरी सेवाओं से अपने स्रोत जोड़ें।
-- **रीयल-टाइम मल्टीप्लेयर सपोर्ट** - एक साझा notebook में अपनी टीम के सदस्यों के साथ आसानी से काम करें।
-- **AI ऑटोमेशन और एजेंट** - AI एजेंट को शेड्यूल पर चलाएं या जैसे ही कोई दस्तावेज़ किसी फ़ोल्डर में आए उसे ट्रिगर करें, फिर परिणाम वापस Notion, Slack, Linear और Drive में लिखें। चैट में बस वर्णन करके बिना-कोड ऑटोमेशन बनाएं।
-- **डेस्कटॉप ऐप** - Quick Assist, General Assist, Screenshot Assist और लोकल फ़ोल्डर सिंक के साथ किसी भी एप्लिकेशन में AI सहायता प्राप्त करें।
+- **प्लेटफ़ॉर्म-नेटिव कनेक्टर**, हर एक टाइप्ड REST एंडपॉइंट है जो स्ट्रक्चर्ड JSON लौटाता है। न रेट-लिमिट का जुआ, न HTML पार्सिंग।
+- **एक MCP सर्वर** जो हर कनेक्टर को नेटिव टूल के रूप में (`reddit.scrape`, `google_search.scrape` और अन्य) Claude, Cursor या किसी भी एजेंट फ़्रेमवर्क को उपलब्ध कराता है।
+- **एक एजेंट हार्नेस**, सिर्फ़ कच्चा डेटा नहीं: रीट्राई, स्ट्रक्चर्ड आउटपुट और क्रेडिट मीटरिंग बिल्ट-इन हैं, ताकि एजेंट सवाल से सीधे ब्रीफ़ तक पहुंच सकें और आपको ढांचा खुद न बनाना पड़े।
+- **ओपन सोर्स और सेल्फ-होस्ट करने योग्य**, ताकि आपकी प्रतिस्पर्धी रिसर्च आपके अपने इन्फ्रास्ट्रक्चर पर ही रहे।
-...और भी बहुत कुछ आने वाला है।
+## लाइव डेटा कनेक्टर
+| कनेक्टर | आपके एजेंट्स को क्या मिलता है | और जानें |
+|---|---|---|
+| **Reddit** | आधिकारिक API की रेट लिमिट के बिना पोस्ट, कमेंट और सबरेडिट स्ट्रीम | [Reddit Scraper API](https://www.surfsense.com/reddit) |
+| **YouTube** | ब्रांड और प्रोडक्ट लिसनिंग के लिए वीडियो, ट्रांसक्रिप्ट और कमेंट थ्रेड | [YouTube Scraper API](https://www.surfsense.com/youtube) |
+| **Google Maps** | स्थानीय प्रतिस्पर्धी और लीड रिसर्च के लिए स्थान, रेटिंग और रिव्यू | [Google Maps Scraper API](https://www.surfsense.com/google-maps) |
+| **Google Search** | रैंक ट्रैकिंग और मार्केट मॉनिटरिंग के लिए लाइव SERP | [Google Search API](https://www.surfsense.com/google-search) |
+| **Web Crawl** | ओपन वेब का कोई भी पेज साफ़-सुथरे, स्ट्रक्चर्ड कंटेंट के रूप में | [Web Crawling API](https://www.surfsense.com/web-crawl) |
+| **MCP Connector** | कोई भी MCP सर्वर अपने एजेंट्स से जोड़ें, Notion, Slack, Jira और अन्य के लिए वन-क्लिक OAuth के साथ | [MCP Connector](https://www.surfsense.com/mcp-connector) |
+बिलिंग पे-एज़-यू-गो है: कनेक्टर सिर्फ़ वास्तव में लौटाए गए हर आइटम पर बिल करते हैं, क्रॉल सफलतापूर्वक फ़ेच किए गए हर पेज पर, और असफल कॉल कभी बिल नहीं होतीं। सेल्फ-होस्टेड इंस्टॉल बिलिंग बंद रखकर चलते हैं। देखें [pricing](https://www.surfsense.com/pricing)।
-## वीडियो एजेंट नमूना
+## क्विक स्टार्ट
-https://github.com/user-attachments/assets/012a7ffa-6f76-4f06-9dda-7632b470057a
+### कोड से कनेक्टर कॉल करें
+हर कनेक्टर एक REST एंडपॉइंट है जिसे आप अपनी SurfSense API कुंजी के साथ किसी भी भाषा से कॉल कर सकते हैं:
+```bash
+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"
+ }'
+```
-## पॉडकास्ट एजेंट नमूना
+हर [कनेक्टर पेज](https://www.surfsense.com/connectors) पर Python, JavaScript, Go, PHP, Ruby, Java और C# में कॉपी-पेस्ट उदाहरण मौजूद हैं।
-https://github.com/user-attachments/assets/a0a16566-6967-4374-ac51-9b3e07fbecd7
+### MCP के ज़रिए ये टूल्स अपने एजेंट्स को दें
+SurfSense MCP सर्वर को Claude, Cursor या अपने एजेंट फ़्रेमवर्क में जोड़ें:
-## SurfSense का उपयोग कैसे करें
+```json
+{
+ "mcpServers": {
+ "surfsense": {
+ "url": "https://mcp.surfsense.com",
+ "headers": { "Authorization": "Bearer ${SURFSENSE_API_KEY}" }
+ }
+ }
+}
+```
-### Cloud
+अब आपका एजेंट हर कनेक्टर को नेटिव टूल के रूप में कॉल कर सकता है।
-1. [surfsense.com](https://www.surfsense.com) पर जाएं और लॉगिन करें।
+### क्लाउड इस्तेमाल करें
-
+[surfsense.com](https://www.surfsense.com) पर जाएं, लॉग इन करें, और एजेंट से सीधी-सादी भाषा में लाइव मार्केट डेटा मांगें। नए अकाउंट $5 के मुफ़्त क्रेडिट के साथ शुरू होते हैं, बिना किसी सब्सक्रिप्शन के।
-2. अपने कनेक्टर जोड़ें और सिंक करें। कनेक्टर्स को अपडेट रखने के लिए आवधिक सिंकिंग सक्षम करें।
+
-
+### मुफ़्त में सेल्फ-होस्ट करें
-3. जब तक कनेक्टर्स का डेटा इंडेक्स हो रहा है, दस्तावेज़ अपलोड करें।
+पूरा प्लेटफ़ॉर्म, कनेक्टर, एजेंट, ऑटोमेशन और MCP सर्वर अपने इन्फ्रास्ट्रक्चर पर चलाएं। सेल्फ-होस्टेड इंस्टॉल बिलिंग बंद के साथ आते हैं, इसलिए स्क्रैपिंग, क्रॉलिंग और एजेंट रन की सीमा सिर्फ़ आपके हार्डवेयर और आपके द्वारा लाई गई मॉडल कुंजियों पर निर्भर करती है।
-
+**आवश्यकताएं:** [Docker Desktop](https://www.docker.com/products/docker-desktop/) इंस्टॉल होना और चल रहा होना चाहिए।
-4. सब कुछ इंडेक्स हो जाने के बाद, कुछ भी पूछें (उपयोग के मामले):
-
- **डेस्कटॉप ऐप** (नीचे दी गई सभी सुविधाओं के अलावा नेटिव एक्स्ट्रा, कोई अलग सेट नहीं)
-
- - General Assist: किसी भी ऐप्लिकेशन से ग्लोबल शॉर्टकट के ज़रिए SurfSense तुरंत खोलें।
-
-
-
- - Quick Assist: कहीं भी टेक्स्ट चुनें और AI से उसे समझाने, दोबारा लिखने या उस पर कार्रवाई करने को कहें।
-
-
-
- - Screenshot Assist: अपनी स्क्रीन का कोई भी हिस्सा कैप्चर करें और AI से उसमें मौजूद चीज़ों के बारे में पूछें।
-
-
-
- - Watch Local Folder: किसी लोकल फ़ोल्डर को अपने नॉलेज बेस के साथ अपने-आप सिंक करें। Obsidian vaults के लिए बढ़िया।
-
-
-
- **डिलीवरेबल स्टूडियो**
-
- - AI Report Generator: उद्धरण सहित रिसर्च रिपोर्ट बनाएं और PDF, DOCX, HTML, LaTeX, EPUB, ODT या सादे टेक्स्ट में एक्सपोर्ट करें।
-
-
-
- - AI Podcast Generator: किसी भी दस्तावेज़ या फ़ोल्डर को 20 सेकंड से भी कम में दो-होस्ट वाले AI पॉडकास्ट में बदलें।
-
-
-
- - AI Presentation & Video Maker: अपने स्रोतों से एडिट करने योग्य स्लाइड डेक और नैरेटेड वीडियो बनाएं।
-
-
-
- - AI Image Generator: अपनी चैट और दस्तावेज़ों से सीधे उच्च-गुणवत्ता वाली इमेज बनाएं।
-
-
-
- - AI Resume Builder: अपने मौजूदा रिज़्यूमे को किसी भी जॉब डिस्क्रिप्शन के अनुसार ढालें और ATS को पार करें।
- इस तरह के प्रॉम्प्ट आज़माएं:
-
- - "मेरे रिज़्यूमे को इस जॉब डिस्क्रिप्शन के अनुसार ढालें ताकि वह ATS पार करे और इंटरव्यू दिलाए।"
- - "इस जॉब पोस्टिंग के कीवर्ड्स से मिलान करके मेरे रिज़्यूमे को ATS के लिए ऑप्टिमाइज़ करें।"
- - "इस भूमिका के लिए ज़रूरी स्किल्स को उभारने के लिए मेरे रिज़्यूमे के बुलेट पॉइंट फिर से लिखें।"
- - "मेरे रिज़्यूमे की तुलना इस जॉब डिस्क्रिप्शन से करें और सुधारने योग्य कमियों की सूची दें।"
- - "मेरे रिज़्यूमे और इस जॉब डिस्क्रिप्शन से मेल खाता एक कवर लेटर लिखें।"
-
- **सर्च और चैट**
-
- - Chat With Your PDFs & Docs: अपनी सभी फ़ाइलों पर सवाल पूछें और इनलाइन उद्धरणों के साथ जवाब पाएं।
-
-
-
- - AI Search With Citations: अपने पूरे नॉलेज बेस में हाइब्रिड सेमांटिक और कीवर्ड सर्च।
-
-
-
- - Collaborative AI Chat: अपनी टीम के साथ रियल टाइम में AI बातचीत पर काम करें।
-
-
-
- - Comments & Mentions: किसी भी AI संदेश पर टिप्पणी करें और टीम के साथियों को टैग करें।
-
-
-
- **कनेक्टर्स और इंटीग्रेशन**
-
- - Connect & Sync Your Tools: Notion, Slack, Google Drive, Gmail, GitHub, Linear और 25+ स्रोतों को एक खोजने योग्य कॉर्पस में सिंक करें।
-
-
-
- - Chat With Uploaded Files: PDF, Office दस्तावेज़, इमेज और ऑडियो अपलोड करें। तुरंत खोजने योग्य।
-
-
-
- - Connector Write-Back: एजेंट को परिणाम वापस Notion, Slack, Linear और Drive में पोस्ट करने दें।
- इस तरह के प्रॉम्प्ट आज़माएं:
-
- - "इस रिसर्च सारांश को मेरे Notion वर्कस्पेस में पोस्ट करें।"
- - "इन मीटिंग एक्शन आइटम्स को हमारे टीम Slack चैनल पर भेजें।"
- - "इस बग रिपोर्ट से एक Jira टिकट बनाएं।"
- - "इस फ़ीचर अनुरोध से Linear में एक इश्यू खोलें।"
- - "इस जनरेट की गई रिपोर्ट को Google Drive में एक डॉक के रूप में सेव करें।"
-
- - Obsidian & Knowledge Base Sync: अपने Obsidian vault और व्यक्तिगत नॉलेज बेस को सिंक रखें।
-
- **ऑटोमेशन**
-
- - Scheduled AI Workflows: किसी एजेंट को शेड्यूल पर चलाएं: रोज़ाना ब्रीफ़, साप्ताहिक डाइजेस्ट, आवर्ती रिपोर्ट।
- इस तरह के प्रॉम्प्ट आज़माएं:
-
- - "हर सुबह मेरे नॉलेज बेस में जुड़े नए दस्तावेज़ों का रोज़ाना ब्रीफ़ मुझे ईमेल करें।"
- - "हर शुक्रवार मेरे Slack और Gmail से एक साप्ताहिक स्टेटस रिपोर्ट बनाएं।"
- - "एक मासिक प्रतिस्पर्धी विश्लेषण रिपोर्ट चलाएं और उसे मेरे वर्कस्पेस में सेव करें।"
- - "मेरी GitHub और Linear गतिविधि को एक रोज़ाना standup अपडेट में सारांशित करें।"
- - "मैं जिन विषयों को ट्रैक करता हूं उन पर एक आवर्ती साप्ताहिक रिसर्च रिपोर्ट बनाएं।"
-
- - Event-Triggered Automations: जैसे ही कोई दस्तावेज़ किसी फ़ोल्डर में आता है, एजेंट को चलाएं और परिणाम अपने टूल में पोस्ट करें।
- इस तरह के प्रॉम्प्ट आज़माएं:
-
- - "जब मेरे Research फ़ोल्डर में कोई PDF आए, तो उद्धरण सहित एक AI सारांश बनाएं।"
- - "जब नई मीटिंग नोट्स जुड़ें, तो उन्हें एक्शन आइटम्स के साथ मीटिंग मिनट्स में बदलें।"
- - "जब कोई इनवॉइस अपलोड हो, तो विक्रेता, कुल राशि और देय तिथि को एक तालिका में निकालें।"
- - "जब मेरे Legal फ़ोल्डर में कोई अनुबंध आए, तो मुख्य शर्तों और नवीनीकरण तिथियों को चिह्नित करें।"
- - "जब Candidates में कोई रिज़्यूमे जुड़े, तो उसे जॉब डिस्क्रिप्शन के विरुद्ध स्क्रीन करें।"
-
- - Chat-Built Automations: सरल भाषा में किसी ऑटोमेशन का वर्णन करें और SurfSense उसे आपके लिए बना देगा।
- इस तरह के प्रॉम्प्ट आज़माएं:
-
- - "एक AI एजेंट बनाएं जो हर सुबह नई Notion पेजों का सारांश मुझे ईमेल करे।"
- - "एक नो-कोड ऑटोमेशन बनाएं जो हर सप्ताह एक रिसर्च डाइजेस्ट Slack पर पोस्ट करे।"
- - "एक AI नोट-टेकर सेट करें जो नई मीटिंग नोट्स को मिनट्स में बदल दे।"
- - "एक वर्कफ़्लो बनाएं जो मीटिंग नोट्स से एक्शन आइटम्स निकाले और ज़िम्मेदार सौंपे।"
- - "मेरे Gmail और Google Drive से एक रोज़ाना ईमेल ब्रीफ़ को ऑटोमेट करें।"
-
-
-### सेल्फ-होस्टेड
-
-पूर्ण डेटा नियंत्रण और गोपनीयता के लिए SurfSense को अपने स्वयं के बुनियादी ढांचे पर चलाएं।
-
-**आवश्यकताएँ:** [Docker Desktop](https://www.docker.com/products/docker-desktop/) इंस्टॉल और चालू होना चाहिए।
-
-#### Linux/MacOS उपयोगकर्ताओं के लिए:
+Linux/macOS के लिए:
```bash
curl -fsSL https://raw.githubusercontent.com/MODSetter/SurfSense/main/docker/scripts/install.sh | bash
```
-#### Windows उपयोगकर्ताओं के लिए:
+Windows के लिए:
-```powershell
+```bash
irm https://raw.githubusercontent.com/MODSetter/SurfSense/main/docker/scripts/install.ps1 | iex
```
-इंस्टॉल स्क्रिप्ट दैनिक ऑटो-अपडेट के लिए स्वचालित रूप से [Watchtower](https://github.com/nicholas-fedor/watchtower) सेटअप करती है। इसे छोड़ने के लिए, `--no-watchtower` फ्लैग जोड़ें।
+इंस्टॉल स्क्रिप्ट दैनिक ऑटो-अपडेट के लिए [Watchtower](https://github.com/nicholas-fedor/watchtower) अपने आप सेट कर देती है। इसे छोड़ने के लिए `--no-watchtower` फ़्लैग जोड़ें। Docker Compose, मैनुअल इंस्टॉलेशन और अन्य डिप्लॉयमेंट विकल्पों के लिए [docs](https://www.surfsense.com/docs/) देखें।
-Docker Compose, मैनुअल इंस्टॉलेशन और अन्य डिप्लॉयमेंट विकल्पों के लिए, [डॉक्स](https://www.surfsense.com/docs/) देखें।
+## कॉम्पिटिटिव इंटेलिजेंस वर्कफ़्लो
-### डेस्कटॉप ऐप
+ऑटोमेशन शेड्यूल पर या इवेंट के जवाब में पूरे एजेंट टर्न चलाते हैं, फिर नतीजे Notion, Slack, Linear और Jira में वापस लिख देते हैं। वर्कफ़्लो को सीधी-सादी भाषा में बताइए और SurfSense उसे बना देगा, कोई कोड नहीं चाहिए। ये प्रॉम्प्ट आज़माएं:
-SurfSense एक डेस्कटॉप ऐप भी प्रदान करता है जो आपके कंप्यूटर पर हर एप्लिकेशन में AI सहायता लाता है। इसे [नवीनतम रिलीज़](https://github.com/MODSetter/SurfSense/releases/latest) से डाउनलोड करें।
+- "हमारे टॉप 3 प्रतिस्पर्धियों के प्राइसिंग पेज पर नज़र रखो और जब कोई प्लान या कीमत बदले तो मुझे Slack में अलर्ट करो।"
+- "Reddit और YouTube पर हमारे ब्रांड के हर उल्लेख को ट्रैक करो और मुझे रोज़ाना डाइजेस्ट भेजो।"
+- "हमारे टॉप 10 कीवर्ड के लिए हमारी Google रैंकिंग मॉनिटर करो और हफ़्ते-दर-हफ़्ते गिरावट को फ़्लैग करो।"
+- "हर सोमवार हमारी लोकेशनों और हमारे प्रतिस्पर्धियों की नई Google Maps रिव्यू खींचो।"
+- "हर महीने एक प्रतिस्पर्धी विश्लेषण रिपोर्ट चलाओ और उसे मेरे वर्कस्पेस में सेव करो।"
-डेस्कटॉप ऐप में ये शक्तिशाली सुविधाएं शामिल हैं:
+
-- **General Assist** — एक ग्लोबल शॉर्टकट से किसी भी एप्लिकेशन से तुरंत SurfSense लॉन्च करें।
-- **Quick Assist** — कहीं भी टेक्स्ट चुनें, फिर AI से समझाने, फिर से लिखने या उस पर कार्रवाई करने को कहें।
-- **Screenshot Assist** — स्क्रीन पर एक क्षेत्र चुनें और उसे चैट में जोड़ें, ताकि उत्तर आपकी नॉलेज बेस पर आधारित रहें।
-- **Watch Local Folder** — एक लोकल फ़ोल्डर को वॉच करें और फ़ाइल परिवर्तनों को स्वचालित रूप से अपनी नॉलेज बेस में सिंक करें। **Pro tip:** इसे अपने Obsidian vault पर पॉइंट करें ताकि आपके नोट्स SurfSense में सर्च करने योग्य रहें।
+## बॉक्स में बाकी सब कुछ
-सभी सुविधाएं आपके चुने हुए सर्च स्पेस पर काम करती हैं, ताकि आपके उत्तर हमेशा आपके अपने डेटा पर आधारित हों।
+जिस रिसर्च वर्कस्पेस ने SurfSense को अग्रणी ओपन सोर्स NotebookLM विकल्प बनाया, वह अब भी यहीं है, और आपके एजेंट जो कुछ भी इकट्ठा करते हैं वह सब इसी में पहुंचता है।
-### रीयल-टाइम सहयोग कैसे करें (बीटा)
+**नॉलेज बेस**
-1. सदस्य प्रबंधन पेज पर जाएं और एक आमंत्रण बनाएं।
+- PDF, Office दस्तावेज़, इमेज और ऑडियो अपलोड करें, या **Google Drive, OneDrive और Dropbox** सिंक करें। 50+ फ़ाइल फ़ॉर्मैट समर्थित हैं।
+- हाइब्रिड सिमेंटिक और फ़ुल-टेक्स्ट सर्च, Perplexity-शैली के साइटेड जवाबों के साथ।
+- AI फ़ाइल सॉर्टिंग दस्तावेज़ों को स्रोत, तारीख़ और विषय के अनुसार अपने आप व्यवस्थित करती है।
+
+
+
+**डिलीवरेबल स्टूडियो**
+
+- AI रिपोर्ट जनरेटर, PDF, DOCX, HTML, LaTeX, EPUB, ODT या सादे टेक्स्ट में एक्सपोर्ट के साथ।
+- किसी भी दस्तावेज़ या फ़ोल्डर से 20 सेकंड से कम में दो-होस्ट वाले AI पॉडकास्ट।
+- संपादन योग्य स्लाइड डेक, नैरेटेड वीडियो ओवरव्यू और AI इमेज जनरेशन।
+
+
+
+**टीम सहयोग**
+
+- कमेंट और मेंशन के साथ रीयल-टाइम सहयोगी AI चैट।
+- Owner, Admin, Editor और Viewer भूमिकाओं के साथ RBAC।
+
+
+
+**डेस्कटॉप ऐप**
+
+आपके कंप्यूटर के हर एप्लिकेशन में नेटिव AI सहायता। [latest release](https://github.com/MODSetter/SurfSense/releases/latest) से डाउनलोड करें।
+
+- **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
+
+## रीयल टाइम में सहयोग कैसे करें (बीटा)
+
+1. Manage Members पेज पर जाएं और एक इनवाइट बनाएं।
-2. टीममेट जुड़ता है और वह SearchSpace साझा हो जाता है।
+2. कोई साथी जुड़ता है और वह वर्कस्पेस साझा हो जाता है।
-
+
-3. चैट को साझा करें।
+3. किसी चैट को साझा करें और उसमें रीयल टाइम में साथ काम करें, साथियों को टैग करने के लिए कमेंट के साथ।
-
+
-4. आपकी टीम अब रीयल-टाइम में चैट कर सकती है।
+## SurfSense बनाम Google NotebookLM
-
+अब भी हमें NotebookLM विकल्प के तौर पर तौल रहे हैं? यह रहा ईमानदार तुलनात्मक ब्यौरा।
-5. टीममेट्स को टैग करने के लिए कमेंट जोड़ें।
-
-
-
-## SurfSense vs Google NotebookLM
-
-| विशेषता | Google NotebookLM | SurfSense |
+| फ़ीचर | Google NotebookLM | SurfSense |
|---------|-------------------|-----------|
-| **प्रति Notebook स्रोत** | 50 (मुफ़्त) से 600 (Ultra, $249.99/माह) | असीमित |
-| **Notebooks की संख्या** | 100 (मुफ़्त) से 500 (सशुल्क योजनाएं) | असीमित |
+| **एजेंट्स के लिए लाइव मार्केट डेटा** | नहीं | REST API और MCP के ज़रिए Reddit, YouTube, Google Maps, Google Search और वेब क्रॉल कनेक्टर |
+| **MCP सर्वर** | नहीं | हर कनेक्टर नेटिव एजेंट टूल के रूप में उपलब्ध, साथ ही वन-क्लिक OAuth ऐप्स के साथ अपने MCP सर्वर लाने की सुविधा |
+| **प्रति नोटबुक स्रोत** | 50 (Free) से 600 (Ultra, $249.99/माह) | असीमित |
+| **नोटबुक की संख्या** | 100 (Free) से 500 (सशुल्क टियर) | असीमित |
| **स्रोत आकार सीमा** | 500,000 शब्द / 200MB प्रति स्रोत | कोई सीमा नहीं |
-| **मूल्य निर्धारण** | मुफ़्त स्तर उपलब्ध; Pro $19.99/माह, Ultra $249.99/माह | मुफ़्त और ओपन सोर्स, अपनी इंफ्रा पर सेल्फ-होस्ट करें |
-| **LLM सपोर्ट** | केवल Google Gemini | 100+ LLMs OpenAI spec और LiteLLM के माध्यम से |
-| **एम्बेडिंग मॉडल** | केवल Google | 6,000+ एम्बेडिंग मॉडल, सभी प्रमुख रीरैंकर्स |
-| **लोकल / प्राइवेट LLMs** | उपलब्ध नहीं | पूर्ण सपोर्ट (vLLM, Ollama) - आपका डेटा आपका रहता है |
-| **सेल्फ-होस्ट करने योग्य** | नहीं | हाँ - Docker एक कमांड या पूर्ण Docker Compose |
-| **ओपन सोर्स** | नहीं | हाँ |
-| **बाहरी कनेक्टर्स** | Google Drive, YouTube, वेबसाइटें | 27+ कनेक्टर्स - सर्च इंजन, Google Drive, OneDrive, Dropbox, Slack, Teams, Jira, Notion, GitHub, Discord और [अधिक](#बाहरी-स्रोत) |
-| **फ़ाइल फ़ॉर्मेट सपोर्ट** | PDFs, Docs, Slides, Sheets, CSV, Word, EPUB, इमेज, वेब URLs, YouTube | 50+ फ़ॉर्मेट - दस्तावेज़, इमेज, वीडियो LlamaCloud, Unstructured या Docling (लोकल) के माध्यम से |
-| **सर्च** | सिमैंटिक सर्च | हाइब्रिड सर्च - हायरार्किकल इंडाइसेस और Reciprocal Rank Fusion के साथ सिमैंटिक + फुल टेक्स्ट |
-| **उद्धृत उत्तर** | हाँ | हाँ - Perplexity शैली के उद्धृत उत्तर |
-| **एजेंट आर्किटेक्चर** | नहीं | हाँ - [LangChain Deep Agents](https://docs.langchain.com/oss/python/deepagents/overview) द्वारा संचालित, योजना, सब-एजेंट और फ़ाइल सिस्टम एक्सेस |
-| **रीयल-टाइम मल्टीप्लेयर** | दर्शक/संपादक भूमिकाओं के साथ साझा notebooks (कोई रीयल-टाइम चैट नहीं) | मालिक / एडमिन / संपादक / दर्शक भूमिकाओं के साथ RBAC, रीयल-टाइम चैट और कमेंट थ्रेड |
-| **वीडियो जनरेशन** | Veo 3 के माध्यम से सिनेमैटिक वीडियो ओवरव्यू (केवल Ultra) | उपलब्ध (NotebookLM यहाँ बेहतर है, सक्रिय रूप से सुधार हो रहा है) |
-| **प्रेजेंटेशन जनरेशन** | बेहतर दिखने वाली स्लाइड्स लेकिन संपादन योग्य नहीं | संपादन योग्य, स्लाइड आधारित प्रेजेंटेशन बनाएं |
-| **पॉडकास्ट जनरेशन** | कस्टमाइज़ेबल होस्ट और भाषाओं के साथ ऑडियो ओवरव्यू | कई TTS प्रदाताओं के साथ उपलब्ध (NotebookLM यहाँ बेहतर है, सक्रिय रूप से सुधार हो रहा है) |
-| **AI ऑटोमेशन और एजेंट** | नहीं | शेड्यूल किए गए AI वर्कफ़्लो, नए दस्तावेज़ों पर इवेंट ट्रिगर, और चैट से बने बिना-कोड ऑटोमेशन, Notion, Slack, Linear और Jira में कनेक्टर राइट-बैक के साथ |
+| **मूल्य निर्धारण** | Free टियर; 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](https://docs.langchain.com/oss/python/deepagents/overview) द्वारा संचालित, प्लानिंग, सबएजेंट और फ़ाइल सिस्टम एक्सेस के साथ |
+| **AI ऑटोमेशन और एजेंट** | नहीं | शेड्यूल्ड वर्कफ़्लो, इवेंट ट्रिगर और चैट से बने नो-कोड ऑटोमेशन, Notion, Slack, Linear और Jira में राइट-बैक के साथ |
+| **रीयल-टाइम मल्टीप्लेयर** | Viewer/Editor भूमिकाओं के साथ साझा नोटबुक (रीयल-टाइम चैट नहीं) | Owner / Admin / Editor / Viewer भूमिकाओं के साथ RBAC, रीयल-टाइम चैट और कमेंट थ्रेड |
+| **वीडियो जनरेशन** | Veo 3 के ज़रिए सिनेमैटिक वीडियो ओवरव्यू (केवल Ultra) | उपलब्ध (यहां NotebookLM बेहतर है, सक्रिय रूप से सुधार जारी) |
+| **प्रेज़ेंटेशन जनरेशन** | दिखने में बेहतर स्लाइड, लेकिन संपादन योग्य नहीं | संपादन योग्य, स्लाइड-आधारित प्रेज़ेंटेशन |
+| **पॉडकास्ट जनरेशन** | कस्टमाइज़ करने योग्य होस्ट और भाषाओं के साथ ऑडियो ओवरव्यू | कई TTS प्रोवाइडर के साथ उपलब्ध (यहां NotebookLM बेहतर है, सक्रिय रूप से सुधार जारी) |
| **डेस्कटॉप ऐप** | नहीं | General Assist, Quick Assist, Screenshot Assist और लोकल फ़ोल्डर सिंक के साथ नेटिव ऐप |
-| **ब्राउज़र एक्सटेंशन** | नहीं | किसी भी वेबपेज को सहेजने के लिए क्रॉस-ब्राउज़र एक्सटेंशन, प्रमाणीकरण सुरक्षित पेज सहित |
-
-
-बाहरी स्रोतों की पूरी सूची
-
-
-सर्च इंजन (SearXNG, Tavily, LinkUp, Baidu Search) · Google Drive · OneDrive · Dropbox · Slack · Microsoft Teams · Linear · Jira · ClickUp · Confluence · BookStack · Notion · Gmail · YouTube वीडियो · GitHub · Discord · Airtable · Google Calendar · Luma · Circleback · Elasticsearch · Obsidian, और भी बहुत कुछ आने वाला है।
-
-
-
## फ़ीचर अनुरोध और भविष्य
+**SurfSense सक्रिय रूप से विकसित किया जा रहा है।** हालांकि यह अभी प्रोडक्शन-रेडी नहीं है, आप इस प्रक्रिया को तेज़ करने में हमारी मदद कर सकते हैं।
-**SurfSense सक्रिय रूप से विकसित किया जा रहा है।** हालांकि यह अभी प्रोडक्शन-रेडी नहीं है, आप प्रक्रिया को तेज़ करने में हमारी मदद कर सकते हैं।
-
-[SurfSense Discord](https://discord.gg/ejRNvftDp9) में शामिल हों और SurfSense के भविष्य को आकार देने में मदद करें!
+[SurfSense Discord](https://discord.gg/ejRNvftDp9) से जुड़ें और SurfSense का भविष्य गढ़ने में मदद करें!
## रोडमैप
-हमारे विकास की प्रगति और आने वाली सुविधाओं से अपडेट रहें!
-हमारा सार्वजनिक रोडमैप देखें और अपने विचार या फ़ीडबैक दें:
+हमारी विकास प्रगति और आने वाले फ़ीचर्स से अपडेट रहें। हमारा सार्वजनिक रोडमैप देखें और अपने विचार या फ़ीडबैक साझा करें:
**रोडमैप चर्चा:** [SurfSense 2026 Roadmap](https://github.com/MODSetter/SurfSense/discussions/565)
-**कानबन बोर्ड:** [SurfSense Project Board](https://github.com/users/MODSetter/projects/3)
-
+**कानबान बोर्ड:** [SurfSense Project Board](https://github.com/users/MODSetter/projects/3)
## योगदान करें
-सभी योगदान स्वागत योग्य हैं, स्टार और बग रिपोर्ट से लेकर बैकएंड सुधार तक। शुरू करने के लिए [CONTRIBUTING.md](CONTRIBUTING.md) देखें।
+हर तरह का योगदान स्वागत योग्य है, स्टार और बग रिपोर्ट से लेकर बैकएंड सुधार तक। शुरू करने के लिए [CONTRIBUTING.md](CONTRIBUTING.md) देखें।
-हमारे सभी Surfers को धन्यवाद:
+हमारे सभी Surfers का धन्यवाद:
-## Star इतिहास
+## स्टार हिस्ट्री
diff --git a/README.md b/README.md
index a75122892..9cb5d9ce1 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-
+
@@ -20,273 +20,210 @@
-# SurfSense
+# SurfSense: Give Your AI Agents Competitive Intelligence
-NotebookLM is one of the best and most useful AI platforms out there, but once you start using it regularly you also feel its limitations leaving something to be desired more.
+SurfSense is the **open-source competitive intelligence platform for AI agents**. Your agents monitor competitors, track rankings, and listen to your market with live data from **Reddit, YouTube, Google Maps, Google Search, and the open web**, through one **REST API** or **MCP server**. Scheduled and event-triggered agents turn what they find into briefs and alerts, and a built-in knowledge base keeps every finding searchable with citations.
-1. There are limits on the amount of sources you can add in a notebook.
-2. There are limits on the number of notebooks you can have.
-3. You cannot have sources that exceed 500,000 words and are more than 200MB.
-4. You are vendor locked in to Google services (LLMs, usage models, etc.) with no option to configure them.
-5. Limited external data sources and service integrations.
-6. NotebookLM Agent is specifically optimised for just studying and researching, but you can do so much more with the source data.
-7. Lack of multiplayer support.
+> [!NOTE]
+> **📢 A note for our NotebookLM-alternative users**
+>
+> For the past couple of months we built SurfSense as the best general research agent for your own knowledge, and that chapter earned us a community we are genuinely proud of. Agentic tools like Claude, OpenCode, Hermes, and OpenClaw have now proven that agents are the future, and general research is becoming something every capable agent does out of the box. What agents still lack is **live market data and the workflows around it**, so that is where we are pointing all of our energy: becoming the definitive open-source competitive intelligence agent platform.
+>
+> **Nothing you rely on is going away.** Your knowledge base, chat with citations, reports, podcasts, presentations, automations, and collaborative chats all keep working, and self-hosting stays free and open source. Read the full announcement on [our changelog](https://www.surfsense.com/changelog).
-...and more.
+## Why agents need SurfSense
-**SurfSense is specifically made to solve these problems.** SurfSense empowers you to:
+Ask any capable agent "what are competitors charging this week?" or "what is Reddit saying about us since the launch?" and it has nowhere trustworthy to look. Official platform APIs are rate-limited, priced for enterprises, or missing entirely, and scraping plumbing is brittle. SurfSense closes that gap:
-- **Control Your Data Flow** - Keep your data private and secure.
-- **No Data Limits** - Add an unlimited amount of sources and notebooks.
-- **No Vendor Lock-in** - Configure any LLM, image, TTS, and STT models to use.
-- **25+ External Data Sources** - Add your sources from Google Drive, OneDrive, Dropbox, Notion, and many other external services.
-- **Real-Time Multiplayer Support** - Work easily with your team members in a shared notebook.
-- **AI File Sorting** - Automatically organize your documents into a smart folder hierarchy using AI-powered categorization by source, date, and topic.
-- **AI Automations & Agents** - Run AI agents on a schedule or trigger them the moment a document lands in a folder, then write results back to Notion, Slack, Linear, and Drive. Build no-code automations just by describing them in chat.
-- **Desktop App** - Get AI assistance in any application with Quick Assist, General Assist, Screenshot Assist, and local folder sync.
+- **Platform-native connectors**, each a typed REST endpoint returning structured JSON. No rate-limit roulette, no HTML parsing.
+- **An MCP server** that exposes every connector as a native tool (`reddit.scrape`, `google_search.scrape`, and more) to Claude, Cursor, or any agent framework.
+- **An agent harness**, not just raw data: retries, structured output, and credit metering are built in, so agents go from a question to a brief without you building the plumbing.
+- **Open source and self-hostable**, so your competitive research stays on your own infrastructure.
-...and more to come.
+## Live data connectors
+| Connector | What your agents get | Learn more |
+|---|---|---|
+| **Reddit** | Posts, comments, and subreddit streams without the official API's rate limits | [Reddit Scraper API](https://www.surfsense.com/reddit) |
+| **YouTube** | Videos, transcripts, and comment threads for brand and product listening | [YouTube Scraper API](https://www.surfsense.com/youtube) |
+| **Google Maps** | Places, ratings, and reviews for local competitor and lead research | [Google Maps Scraper API](https://www.surfsense.com/google-maps) |
+| **Google Search** | Live SERPs for rank tracking and market monitoring | [Google Search API](https://www.surfsense.com/google-search) |
+| **Web Crawl** | Any page on the open web as clean, structured content | [Web Crawling API](https://www.surfsense.com/web-crawl) |
+| **MCP Connector** | Bring any MCP server to your agents, with one-click OAuth for Notion, Slack, Jira, and more | [MCP Connector](https://www.surfsense.com/mcp-connector) |
+Billing is pay as you go: connectors bill per item actually returned, crawls per page successfully fetched, and failed calls are never billed. Self-hosted installs run with billing off. See [pricing](https://www.surfsense.com/pricing).
-## Video Agent Sample
+## Quick start
-https://github.com/user-attachments/assets/012a7ffa-6f76-4f06-9dda-7632b470057a
+### Call a connector from code
+Every connector is a REST endpoint you can call from any language with your SurfSense API key:
+```bash
+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"
+ }'
+```
-## Podcast Agent Sample
+Each [connector page](https://www.surfsense.com/connectors) has copy-paste examples in Python, JavaScript, Go, PHP, Ruby, Java, and C#.
-https://github.com/user-attachments/assets/a0a16566-6967-4374-ac51-9b3e07fbecd7
+### Give the tools to your agents over MCP
+Add the SurfSense MCP server to Claude, Cursor, or your own agent framework:
-## How to Use SurfSense
+```json
+{
+ "mcpServers": {
+ "surfsense": {
+ "url": "https://mcp.surfsense.com",
+ "headers": { "Authorization": "Bearer ${SURFSENSE_API_KEY}" }
+ }
+ }
+}
+```
-### Cloud
+Your agent can now call every connector as a native tool.
-1. Go to [surfsense.com](https://www.surfsense.com) and login.
+### Use the cloud
+
+Go to [surfsense.com](https://www.surfsense.com), log in, and ask the agent for live market data in plain English. New accounts start with $5 of free credit and no subscription.
-2. Connect your connectors and sync. Enable periodic syncing to keep connectors synced.
+### Self-host for free
-
-
-3. Till connectors data index, upload Documents.
-
-
-
-4. Once everything is indexed, Ask Away (Use Cases):
-
- **Desktop App** (native extras on top of everything below, not a separate feature set)
-
- - General Assist: launch SurfSense instantly from any application with a global shortcut.
-
-
-
- - Quick Assist: select text anywhere, then ask AI to explain, rewrite, or act on it.
-
-
-
- - Screenshot Assist: capture any region of your screen and ask AI about what's in it.
-
-
-
- - Watch Local Folder: auto-sync a local folder to your knowledge base. Great for Obsidian vaults.
-
-
-
- **Deliverable Studio**
-
- - AI Report Generator: generate cited research reports and export to PDF, DOCX, HTML, LaTeX, EPUB, ODT, or plain text.
-
-
-
- - AI Podcast Generator: turn any document or folder into a two-host AI podcast in under 20 seconds.
-
-
-
- - AI Presentation & Video Maker: create editable slide decks and narrated video overviews from your sources.
-
-
-
- - AI Image Generator: generate high-quality images straight from your chats and documents.
-
-
-
- - AI Resume Builder: tailor your existing resume to any job description and beat the ATS.
- Try prompts like these:
-
- - "Tailor my resume to this job description so it gets past ATS and lands an interview."
- - "Optimize my resume for ATS by matching the keywords in this job posting."
- - "Rewrite my resume bullet points to highlight the skills this role is asking for."
- - "Compare my resume against this job description and list the gaps to fix."
- - "Write a matching cover letter from my resume and this job description."
-
- **Search & Chat**
-
- - Chat With Your PDFs & Docs: ask questions across all your files and get answers with inline citations.
-
-
-
- - AI Search With Citations: hybrid semantic and keyword search across your entire knowledge base.
-
-
-
- - Collaborative AI Chat: work on AI conversations with your team in real time.
-
-
-
- - Comments & Mentions: comment and tag teammates on any AI message.
-
-
-
- **Connectors & Integrations**
-
- - Connect & Sync Your Tools: sync Notion, Slack, Google Drive, Gmail, GitHub, Linear and 25+ sources into one searchable corpus.
-
-
-
- - Chat With Uploaded Files: drop in PDFs, Office docs, images and audio. Instantly searchable.
-
-
-
- - Connector Write-Back: let the agent post results back to Notion, Slack, Linear and Drive.
- Try prompts like these:
-
- - "Post this research summary to my Notion workspace."
- - "Send these meeting action items to our team Slack channel."
- - "Create a Jira ticket from this bug report."
- - "Open a Linear issue from this feature request."
- - "Save this generated report to Google Drive as a doc."
-
- - Obsidian & Knowledge Base Sync: keep your Obsidian vault and personal knowledge base in sync.
-
- **Automations**
-
- - Scheduled AI Workflows: run an agent on a schedule: daily briefs, weekly digests, recurring reports.
- Try prompts like these:
-
- - "Email me a daily brief of new documents in my knowledge base every morning."
- - "Generate a weekly status report from my Slack and Gmail every Friday."
- - "Run a monthly competitor analysis report and save it to my workspace."
- - "Summarize my GitHub and Linear activity into a daily standup update."
- - "Create a recurring weekly research report on the topics I track."
-
- - Event-Triggered Automations: fire an agent the moment a document lands in a folder, then post the result to your tools.
- Try prompts like these:
-
- - "When a PDF lands in my Research folder, generate a cited AI summary."
- - "When new meeting notes are added, turn them into meeting minutes with action items."
- - "When an invoice is uploaded, extract the vendor, total, and due date into a table."
- - "When a contract enters my Legal folder, flag key terms and renewal dates."
- - "When a resume is added to Candidates, screen it against the job description."
-
- - Chat-Built Automations: describe an automation in plain English and SurfSense builds it for you.
- Try prompts like these:
-
- - "Build an AI agent that emails me a summary of new Notion pages each morning."
- - "Create a no-code automation that posts a weekly research digest to Slack."
- - "Set up an AI note taker that turns new meeting notes into minutes."
- - "Make a workflow that extracts action items from meeting notes and assigns owners."
- - "Automate a daily email brief from my Gmail and Google Drive."
-
-
-### Self Hosted
-
-Run SurfSense on your own infrastructure for full data control and privacy.
+Run the entire platform, connectors, agents, automations, and the MCP server on your own infrastructure. Self-hosted installs ship with billing off, so scraping, crawling, and agent runs are limited only by your hardware and the model keys you bring.
**Prerequisites:** [Docker Desktop](https://www.docker.com/products/docker-desktop/) must be installed and running.
-#### For Linux/MacOS users:
+For Linux/macOS:
```bash
curl -fsSL https://raw.githubusercontent.com/MODSetter/SurfSense/main/docker/scripts/install.sh | bash
```
-#### For Windows users:
+For Windows:
```bash
irm https://raw.githubusercontent.com/MODSetter/SurfSense/main/docker/scripts/install.ps1 | iex
```
-The install script sets up [Watchtower](https://github.com/nicholas-fedor/watchtower) automatically for daily auto-updates. To skip it, add the `--no-watchtower` flag.
+The install script sets up [Watchtower](https://github.com/nicholas-fedor/watchtower) automatically for daily auto-updates. To skip it, add the `--no-watchtower` flag. For Docker Compose, manual installation, and other deployment options, see the [docs](https://www.surfsense.com/docs/).
-For Docker Compose, manual installation, and other deployment options, see the [docs](https://www.surfsense.com/docs/).
+## Competitive intelligence workflows
-### Desktop App
+Automations run full agent turns on a schedule or in response to events, then write results back to Notion, Slack, Linear, and Jira. Describe the workflow in plain English and SurfSense builds it, no code needed. Try prompts like:
-SurfSense also ships a desktop app that brings AI assistance to every application on your computer. Download it from the [latest release](https://github.com/MODSetter/SurfSense/releases/latest).
+- "Watch our top 3 competitors' pricing pages and alert me in Slack when a plan or price changes."
+- "Track every mention of our brand on Reddit and YouTube and send me a daily digest."
+- "Monitor our Google ranking for our top 10 keywords and flag drops week over week."
+- "Pull new Google Maps reviews for our locations and our competitors' every Monday."
+- "Run a monthly competitor analysis report and save it to my workspace."
-The desktop app includes these powerful features:
+
-- **General Assist** — Launch SurfSense instantly from any application with a global shortcut.
-- **Quick Assist** — Select text anywhere, then ask AI to explain, rewrite, or act on it.
-- **Screenshot Assist** — Select a region on your screen and attach it to chat so answers stay grounded in your knowledge base.
-- **Watch Local Folder** — Watch a local folder and automatically sync file changes to your knowledge base. **Pro tip:** Point it at your Obsidian vault to keep your notes searchable in SurfSense.
+## Everything else in the box
-All features operate against your chosen search space, so your answers are always grounded in your own data.
+The research workspace that made SurfSense the leading open-source NotebookLM alternative is still here, and everything your agents gather lands in it.
-### How to Realtime Collaborate (Beta)
+**Knowledge base**
-1. Go to Manage Members page and create an invite.
+- Upload PDFs, Office docs, images, and audio, or sync **Google Drive, OneDrive, and Dropbox**. 50+ file formats supported.
+- Hybrid semantic and full-text search with cited, Perplexity-style answers.
+- AI file sorting auto-organizes documents by source, date, and topic.
+
+
+
+**Deliverable studio**
+
+- AI report generator with export to PDF, DOCX, HTML, LaTeX, EPUB, ODT, or plain text.
+- Two-host AI podcasts from any document or folder in under 20 seconds.
+- Editable slide decks, narrated video overviews, and AI image generation.
+
+
+
+**Team collaboration**
+
+- Real-time collaborative AI chats with comments and mentions.
+- RBAC with Owner, Admin, Editor, and Viewer roles.
+
+
+
+**Desktop app**
+
+Native AI assistance in every application on your computer. Download from the [latest release](https://github.com/MODSetter/SurfSense/releases/latest).
+
+- **General Assist**: launch SurfSense from any app with a global shortcut.
+- **Quick Assist**: select text anywhere, then ask AI to explain, rewrite, or act on it.
+- **Screenshot Assist**: capture any region of your screen and ask AI about it.
+- **Watch Local Folder**: auto-sync a local folder to your knowledge base. Point it at your Obsidian vault to keep your notes searchable.
+
+
+
+**No vendor lock-in**
+
+- 100+ LLMs via the OpenAI spec and LiteLLM, including GPT-5.5, Claude Sonnet 5, and Gemini 3.1 Pro.
+- 6,000+ embedding models and all major rerankers.
+- Full local and private LLM support (vLLM, Ollama), so your data stays yours.
+
+## Video Agent Sample
+
+https://github.com/user-attachments/assets/012a7ffa-6f76-4f06-9dda-7632b470057a
+
+## Podcast Agent Sample
+
+https://github.com/user-attachments/assets/a0a16566-6967-4374-ac51-9b3e07fbecd7
+
+## How to collaborate in real time (Beta)
+
+1. Go to the Manage Members page and create an invite.
-2. Teammate joins and that SearchSpace becomes shared.
+2. A teammate joins and that workspace becomes shared.
-3. Make chat shared.
-
-
-
-4. Your team can now chat in realtime.
-
-
-
-5. Add comment to tag teammates.
+3. Make a chat shared and work in it together in real time, with comments to tag teammates.
## SurfSense vs Google NotebookLM
+Still comparing us as a NotebookLM alternative? Here is the honest breakdown.
+
| Feature | Google NotebookLM | SurfSense |
|---------|-------------------|-----------|
+| **Live market data for agents** | No | Reddit, YouTube, Google Maps, Google Search, and web crawl connectors via REST API and MCP |
+| **MCP server** | No | Every connector exposed as a native agent tool, plus bring-your-own MCP servers with one-click OAuth apps |
| **Sources per Notebook** | 50 (Free) to 600 (Ultra, $249.99/mo) | Unlimited |
| **Number of Notebooks** | 100 (Free) to 500 (paid tiers) | Unlimited |
| **Source Size Limit** | 500,000 words / 200MB per source | No limit |
-| **Pricing** | Free tier available; Pro $19.99/mo, Ultra $249.99/mo | Free and open source, self-host on your own infra |
+| **Pricing** | Free tier; Pro $19.99/mo, Ultra $249.99/mo | Free and open source to self-host; cloud is pay as you go with $5 free credit |
| **LLM Support** | Google Gemini only | 100+ LLMs via OpenAI spec & LiteLLM |
| **Embedding Models** | Google only | 6,000+ embedding models, all major rerankers |
-| **Local / Private LLMs** | Not available | Full support (vLLM, Ollama) - your data stays yours |
-| **Self Hostable** | No | Yes - Docker one-liner or full Docker Compose |
+| **Local / Private LLMs** | Not available | Full support (vLLM, Ollama), your data stays yours |
+| **Self Hostable** | No | Yes, Docker one-liner or full Docker Compose |
| **Open Source** | No | Yes |
-| **External Connectors** | Google Drive, YouTube, websites | 27+ connectors - Search Engines, Google Drive, OneDrive, Dropbox, Slack, Teams, Jira, Notion, GitHub, Discord & [more](#external-sources) |
-| **File Format Support** | PDFs, Docs, Slides, Sheets, CSV, Word, EPUB, images, web URLs, YouTube | 50+ formats - documents, images, videos via LlamaCloud, Unstructured, or Docling (local) |
-| **Search** | Semantic search | Hybrid Search - Semantic + Full Text with Hierarchical Indices & Reciprocal Rank Fusion |
-| **Cited Answers** | Yes | Yes - Perplexity-style cited responses |
-| **Agentic Architecture** | No | Yes - powered by [LangChain Deep Agents](https://docs.langchain.com/oss/python/deepagents/overview) with planning, subagents, and file system access |
+| **Knowledge Base Sources** | Google Drive, YouTube, websites | File uploads, Google Drive, OneDrive, Dropbox, local folder sync, and crawled pages |
+| **File Format Support** | PDFs, Docs, Slides, Sheets, CSV, Word, EPUB, images, web URLs, YouTube | 50+ formats: documents, images, videos via LlamaCloud, Unstructured, or Docling (local) |
+| **Search** | Semantic search | Hybrid semantic + full-text with hierarchical indices & reciprocal rank fusion |
+| **Cited Answers** | Yes | Yes, Perplexity-style cited responses |
+| **Agentic Architecture** | No | Yes, powered by [LangChain Deep Agents](https://docs.langchain.com/oss/python/deepagents/overview) with planning, subagents, and file system access |
+| **AI Automations & Agents** | No | Scheduled workflows, event triggers, and chat-built no-code automations with write-back to Notion, Slack, Linear & Jira |
| **Real-Time Multiplayer** | Shared notebooks with Viewer/Editor roles (no real-time chat) | RBAC with Owner / Admin / Editor / Viewer roles, real-time chat & comment threads |
| **Video Generation** | Cinematic Video Overviews via Veo 3 (Ultra only) | Available (NotebookLM is better here, actively improving) |
-| **Presentation Generation** | Better looking slides but not editable | Create editable, slide-based presentations |
+| **Presentation Generation** | Better looking slides but not editable | Editable, slide-based presentations |
| **Podcast Generation** | Audio Overviews with customizable hosts and languages | Available with multiple TTS providers (NotebookLM is better here, actively improving) |
-| **AI File Sorting** | No | LLM-powered auto-categorization into source, date, category, and subcategory folders |
-| **AI Automations & Agents** | No | Scheduled AI workflows, event triggers on new documents, and chat-built no-code automations with connector write-back to Notion, Slack, Linear & Jira |
| **Desktop App** | No | Native app with General Assist, Quick Assist, Screenshot Assist, and local folder sync |
-| **Browser Extension** | No | Cross-browser extension to save any webpage, including auth-protected pages |
-
-
-Full list of External Sources
-
-
-Search Engines (SearXNG, Tavily, LinkUp, Baidu Search) · Google Drive · OneDrive · Dropbox · Slack · Microsoft Teams · Linear · Jira · ClickUp · Confluence · BookStack · Notion · Gmail · YouTube Videos · GitHub · Discord · Airtable · Google Calendar · Luma · Circleback · Elasticsearch · Obsidian, and more to come.
-
-
-
-
-## FEATURE REQUESTS AND FUTURE
+## Feature requests and future
**SurfSense is actively being developed.** While it's not yet production-ready, you can help us speed up the process.
@@ -294,14 +231,12 @@ Join the [SurfSense Discord](https://discord.gg/ejRNvftDp9) and help shape the f
## Roadmap
-Stay up to date with our development progress and upcoming features!
-Check out our public roadmap and contribute your ideas or feedback:
+Stay up to date with our development progress and upcoming features. Check out our public roadmap and contribute your ideas or feedback:
**Roadmap Discussion:** [SurfSense 2026 Roadmap](https://github.com/MODSetter/SurfSense/discussions/565)
**Kanban Board:** [SurfSense Project Board](https://github.com/users/MODSetter/projects/3)
-
## Contribute
All contributions welcome, from stars and bug reports to backend improvements. See [CONTRIBUTING.md](CONTRIBUTING.md) to get started.
diff --git a/README.pt-BR.md b/README.pt-BR.md
index db77e5132..af2f1c7d0 100644
--- a/README.pt-BR.md
+++ b/README.pt-BR.md
@@ -1,4 +1,4 @@
-
+
@@ -20,289 +20,226 @@
-# SurfSense
+# SurfSense: Dê Inteligência Competitiva aos Seus Agentes de IA
-O NotebookLM é uma das melhores e mais úteis plataformas de IA disponíveis, mas quando você começa a usá-lo regularmente também sente suas limitações deixando algo a desejar.
+O SurfSense é a **plataforma open source de inteligência competitiva para agentes de IA**. Seus agentes monitoram concorrentes, acompanham rankings e escutam o seu mercado com dados ao vivo do **Reddit, YouTube, Google Maps, Google Search e da web aberta**, por meio de uma única **API REST** ou de um **servidor MCP**. Agentes agendados ou acionados por eventos transformam o que encontram em relatórios e alertas, e uma base de conhecimento integrada mantém cada descoberta pesquisável, com citações.
-1. Há limites na quantidade de fontes que você pode adicionar em um notebook.
-2. Há limites no número de notebooks que você pode ter.
-3. Você não pode ter fontes que excedam 500.000 palavras e mais de 200MB.
-4. Você fica preso aos serviços do Google (LLMs, modelos de uso, etc.) sem opção de configurá-los.
-5. Fontes de dados externas e integrações de serviços limitadas.
-6. O agente do NotebookLM é especificamente otimizado apenas para estudar e pesquisar, mas você pode fazer muito mais com os dados de origem.
-7. Falta de suporte multiplayer.
+> [!NOTE]
+> **📢 Um recado para nossos usuários que buscavam uma alternativa ao NotebookLM**
+>
+> Nos últimos meses, construímos o SurfSense como o melhor agente de pesquisa geral para o seu próprio conhecimento, e esse capítulo nos rendeu uma comunidade da qual temos muito orgulho. Ferramentas agênticas como Claude, OpenCode, Hermes e OpenClaw já provaram que os agentes são o futuro, e a pesquisa geral está se tornando algo que todo agente capaz faz nativamente. O que ainda falta aos agentes são **dados de mercado ao vivo e os fluxos de trabalho em torno deles**, então é para lá que estamos direcionando toda a nossa energia: nos tornar a plataforma open source definitiva de agentes de inteligência competitiva.
+>
+> **Nada do que você usa vai deixar de existir.** Sua base de conhecimento, o chat com citações, os relatórios, os podcasts, as apresentações, as automações e os chats colaborativos continuam funcionando, e a auto-hospedagem segue gratuita e open source. Leia o anúncio completo no [nosso changelog](https://www.surfsense.com/changelog).
-...e mais.
+## Por que os agentes precisam do SurfSense
-**O SurfSense foi feito especificamente para resolver esses problemas.** O SurfSense permite que você:
+Pergunte a qualquer agente capaz "quanto os concorrentes estão cobrando esta semana?" ou "o que o Reddit está dizendo sobre nós desde o lançamento?" e ele não terá nenhum lugar confiável para procurar. As APIs oficiais das plataformas têm limites de requisições, preços voltados para empresas ou simplesmente não existem, e a infraestrutura de scraping é frágil. O SurfSense fecha essa lacuna:
-- **Controle Seu Fluxo de Dados** - Mantenha seus dados privados e seguros.
-- **Sem Limites de Dados** - Adicione uma quantidade ilimitada de fontes e notebooks.
-- **Sem Dependência de Fornecedor** - Configure qualquer modelo LLM, de imagem, TTS e STT.
-- **25+ Fontes de Dados Externas** - Adicione suas fontes do Google Drive, OneDrive, Dropbox, Notion e muitos outros serviços externos.
-- **Suporte Multiplayer em Tempo Real** - Trabalhe facilmente com os membros da sua equipe em um notebook compartilhado.
-- **Automações e Agentes de IA** - Execute agentes de IA em uma programação ou dispare-os no momento em que um documento chega a uma pasta, e escreva os resultados de volta no Notion, Slack, Linear e Drive. Crie automações sem código apenas descrevendo-as no chat.
-- **Aplicativo Desktop** - Obtenha assistência de IA em qualquer aplicativo com Quick Assist, General Assist, Screenshot Assist e sincronização de pastas locais.
+- **Conectores nativos de cada plataforma**, cada um sendo um endpoint REST tipado que retorna JSON estruturado. Sem roleta de limites de requisição, sem parsing de HTML.
+- **Um servidor MCP** que expõe cada conector como uma ferramenta nativa (`reddit.scrape`, `google_search.scrape` e outras) para o Claude, o Cursor ou qualquer framework de agentes.
+- **Um harness de agentes**, não apenas dados brutos: novas tentativas, saída estruturada e medição de créditos já vêm prontos, então os agentes vão de uma pergunta a um relatório sem que você precise construir a infraestrutura.
+- **Open source e auto-hospedável**, para que sua pesquisa competitiva permaneça na sua própria infraestrutura.
-...e mais por vir.
+## Conectores de dados ao vivo
+| Conector | O que seus agentes recebem | Saiba mais |
+|---|---|---|
+| **Reddit** | Posts, comentários e fluxos de subreddits sem os limites de requisição da API oficial | [Reddit Scraper API](https://www.surfsense.com/reddit) |
+| **YouTube** | Vídeos, transcrições e threads de comentários para monitoramento de marca e produto | [YouTube Scraper API](https://www.surfsense.com/youtube) |
+| **Google Maps** | Estabelecimentos, avaliações e reviews para pesquisa local de concorrentes e leads | [Google Maps Scraper API](https://www.surfsense.com/google-maps) |
+| **Google Search** | SERPs ao vivo para acompanhamento de rankings e monitoramento de mercado | [Google Search API](https://www.surfsense.com/google-search) |
+| **Web Crawl** (rastreamento web) | Qualquer página da web aberta como conteúdo limpo e estruturado | [Web Crawling API](https://www.surfsense.com/web-crawl) |
+| **Conector MCP** | Traga qualquer servidor MCP para seus agentes, com OAuth em um clique para Notion, Slack, Jira e outros | [MCP Connector](https://www.surfsense.com/mcp-connector) |
+A cobrança é por uso: os conectores cobram por item efetivamente retornado, os rastreamentos por página obtida com sucesso, e chamadas com falha nunca são cobradas. Instalações auto-hospedadas rodam com a cobrança desativada. Veja os [preços](https://www.surfsense.com/pricing).
-## Exemplo de Agente de Vídeo
+## Início rápido
-https://github.com/user-attachments/assets/012a7ffa-6f76-4f06-9dda-7632b470057a
+### Chame um conector a partir do código
+Cada conector é um endpoint REST que você pode chamar de qualquer linguagem com a sua chave de API do SurfSense:
+```bash
+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"
+ }'
+```
-## Exemplo de Agente de Podcast
+Cada [página de conector](https://www.surfsense.com/connectors) tem exemplos prontos para copiar e colar em Python, JavaScript, Go, PHP, Ruby, Java e C#.
-https://github.com/user-attachments/assets/a0a16566-6967-4374-ac51-9b3e07fbecd7
+### Entregue as ferramentas aos seus agentes via MCP
+Adicione o servidor MCP do SurfSense ao Claude, ao Cursor ou ao seu próprio framework de agentes:
-## Como Usar o SurfSense
+```json
+{
+ "mcpServers": {
+ "surfsense": {
+ "url": "https://mcp.surfsense.com",
+ "headers": { "Authorization": "Bearer ${SURFSENSE_API_KEY}" }
+ }
+ }
+}
+```
-### Cloud
+Seu agente agora pode chamar cada conector como uma ferramenta nativa.
-1. Acesse [surfsense.com](https://www.surfsense.com) e faça login.
+### Use a nuvem
+
+Acesse [surfsense.com](https://www.surfsense.com), faça login e peça ao agente dados de mercado ao vivo em linguagem natural. Contas novas começam com US$ 5 de crédito gratuito e sem assinatura.
-2. Conecte seus conectores e sincronize. Ative a sincronização periódica para manter os conectores atualizados.
+### Auto-hospede gratuitamente
-
+Rode a plataforma inteira, conectores, agentes, automações e o servidor MCP na sua própria infraestrutura. Instalações auto-hospedadas vêm com a cobrança desativada, então scraping, rastreamento e execuções de agentes são limitados apenas pelo seu hardware e pelas chaves de modelo que você trouxer.
-3. Enquanto os dados dos conectores são indexados, faça upload de documentos.
+**Pré-requisitos:** o [Docker Desktop](https://www.docker.com/products/docker-desktop/) precisa estar instalado e em execução.
-
-
-4. Quando tudo estiver indexado, pergunte o que quiser (Casos de uso):
-
- **Aplicativo Desktop** (extras nativos, além de tudo o que está abaixo, não um conjunto separado)
-
- - General Assist: abra o SurfSense instantaneamente de qualquer aplicativo com um atalho global.
-
-
-
- - Quick Assist: selecione um texto em qualquer lugar e peça à IA para explicar, reescrever ou agir sobre ele.
-
-
-
- - Screenshot Assist: capture qualquer região da tela e pergunte à IA sobre o que está nela.
-
-
-
- - Watch Local Folder: sincronize automaticamente uma pasta local com sua base de conhecimento. Ótimo para cofres do Obsidian.
-
-
-
- **Estúdio de Entregáveis**
-
- - AI Report Generator: gere relatórios de pesquisa com citações e exporte para PDF, DOCX, HTML, LaTeX, EPUB, ODT ou texto simples.
-
-
-
- - AI Podcast Generator: transforme qualquer documento ou pasta em um podcast de IA com dois apresentadores em menos de 20 segundos.
-
-
-
- - AI Presentation & Video Maker: crie apresentações editáveis e vídeos narrados a partir das suas fontes.
-
-
-
- - AI Image Generator: gere imagens de alta qualidade diretamente das suas conversas e documentos.
-
-
-
- - AI Resume Builder: adapte seu currículo atual a qualquer descrição de vaga e supere o ATS.
- Experimente prompts como estes:
-
- - "Adapte meu currículo a esta descrição de vaga para passar pelo ATS e conseguir uma entrevista."
- - "Otimize meu currículo para o ATS combinando as palavras-chave desta vaga."
- - "Reescreva os tópicos do meu currículo para destacar as habilidades que esta vaga exige."
- - "Compare meu currículo com esta descrição de vaga e liste as lacunas a corrigir."
- - "Escreva uma carta de apresentação combinando com meu currículo e esta descrição de vaga."
-
- **Busca e Chat**
-
- - Chat With Your PDFs & Docs: faça perguntas sobre todos os seus arquivos e receba respostas com citações inline.
-
-
-
- - AI Search With Citations: busca híbrida semântica e por palavra-chave em toda a sua base de conhecimento.
-
-
-
- - Collaborative AI Chat: trabalhe em conversas de IA com sua equipe em tempo real.
-
-
-
- - Comments & Mentions: comente e marque colegas em qualquer mensagem de IA.
-
-
-
- **Conectores e Integrações**
-
- - Connect & Sync Your Tools: sincronize Notion, Slack, Google Drive, Gmail, GitHub, Linear e mais de 25 fontes em um único acervo pesquisável.
-
-
-
- - Chat With Uploaded Files: envie PDFs, documentos do Office, imagens e áudio. Pesquisáveis instantaneamente.
-
-
-
- - Connector Write-Back: deixe o agente publicar os resultados de volta no Notion, Slack, Linear e Drive.
- Experimente prompts como estes:
-
- - "Publique este resumo de pesquisa no meu espaço do Notion."
- - "Envie estes itens de ação da reunião para o nosso canal do Slack."
- - "Crie um ticket no Jira a partir deste relatório de bug."
- - "Abra uma issue no Linear a partir desta solicitação de funcionalidade."
- - "Salve este relatório gerado no Google Drive como um documento."
-
- - Obsidian & Knowledge Base Sync: mantenha seu cofre do Obsidian e sua base de conhecimento pessoal sincronizados.
-
- **Automações**
-
- - Scheduled AI Workflows: execute um agente em uma programação: resumos diários, boletins semanais, relatórios recorrentes.
- Experimente prompts como estes:
-
- - "Envie-me todas as manhãs um resumo diário dos novos documentos na minha base de conhecimento."
- - "Gere um relatório de status semanal a partir do meu Slack e Gmail toda sexta-feira."
- - "Execute um relatório mensal de análise da concorrência e salve-o no meu espaço de trabalho."
- - "Resuma minha atividade no GitHub e Linear em uma atualização diária de standup."
- - "Crie um relatório de pesquisa semanal recorrente sobre os temas que acompanho."
-
- - Event-Triggered Automations: dispare um agente no momento em que um documento chega a uma pasta e publique o resultado nas suas ferramentas.
- Experimente prompts como estes:
-
- - "Quando um PDF chegar à minha pasta de Pesquisa, gere um resumo com IA e citações."
- - "Quando novas notas de reunião forem adicionadas, transforme-as em atas com itens de ação."
- - "Quando uma fatura for enviada, extraia o fornecedor, o total e a data de vencimento em uma tabela."
- - "Quando um contrato entrar na minha pasta Jurídica, sinalize os termos-chave e as datas de renovação."
- - "Quando um currículo for adicionado a Candidatos, avalie-o em relação à descrição da vaga."
-
- - Chat-Built Automations: descreva uma automação em linguagem simples e o SurfSense a cria para você.
- Experimente prompts como estes:
-
- - "Crie um agente de IA que me envie todas as manhãs um resumo das novas páginas do Notion."
- - "Crie uma automação sem código que publique um resumo de pesquisa semanal no Slack."
- - "Configure um anotador com IA que transforme as novas notas de reunião em atas."
- - "Crie um fluxo que extraia os itens de ação das notas de reunião e atribua responsáveis."
- - "Automatize um resumo diário por e-mail a partir do meu Gmail e Google Drive."
-
-
-### Auto-Hospedado
-
-Execute o SurfSense na sua própria infraestrutura para controle total de dados e privacidade.
-
-**Pré-requisitos:** [Docker Desktop](https://www.docker.com/products/docker-desktop/) deve estar instalado e em execução.
-
-#### Para usuários de Linux/MacOS:
+Para Linux/macOS:
```bash
curl -fsSL https://raw.githubusercontent.com/MODSetter/SurfSense/main/docker/scripts/install.sh | bash
```
-#### Para usuários do Windows:
+Para Windows:
-```powershell
+```bash
irm https://raw.githubusercontent.com/MODSetter/SurfSense/main/docker/scripts/install.ps1 | iex
```
-O script de instalação configura o [Watchtower](https://github.com/nicholas-fedor/watchtower) automaticamente para atualizações diárias. Para pular, adicione a flag `--no-watchtower`.
+O script de instalação configura o [Watchtower](https://github.com/nicholas-fedor/watchtower) automaticamente para atualizações automáticas diárias. Para pular essa etapa, adicione a flag `--no-watchtower`. Para Docker Compose, instalação manual e outras opções de implantação, consulte a [documentação](https://www.surfsense.com/docs/).
-Para Docker Compose, instalação manual e outras opções de implantação, consulte a [documentação](https://www.surfsense.com/docs/).
+## Fluxos de trabalho de inteligência competitiva
-### Aplicativo Desktop
+As automações executam turnos completos de agente de forma agendada ou em resposta a eventos, e depois gravam os resultados no Notion, Slack, Linear e Jira. Descreva o fluxo de trabalho em linguagem natural e o SurfSense o constrói, sem precisar de código. Experimente prompts como:
-O SurfSense também oferece um aplicativo desktop que traz assistência de IA para cada aplicativo no seu computador. Baixe-o na [última versão](https://github.com/MODSetter/SurfSense/releases/latest).
+- "Monitore as páginas de preços dos nossos 3 principais concorrentes e me avise no Slack quando um plano ou preço mudar."
+- "Acompanhe cada menção à nossa marca no Reddit e no YouTube e me envie um resumo diário."
+- "Monitore nosso ranking no Google para nossas 10 principais palavras-chave e sinalize quedas semana a semana."
+- "Colete os novos reviews do Google Maps das nossas unidades e das dos concorrentes toda segunda-feira."
+- "Execute um relatório mensal de análise de concorrentes e salve no meu workspace."
-O aplicativo desktop inclui estes recursos poderosos:
+
-- **General Assist** — Abra o SurfSense instantaneamente de qualquer aplicativo com um atalho global.
-- **Quick Assist** — Selecione texto em qualquer lugar, depois peça à IA para explicar, reescrever ou agir sobre ele.
-- **Screenshot Assist** — Selecione uma região da tela e anexe ao chat para respostas fundamentadas na sua base de conhecimento.
-- **Watch Local Folder** — Monitore uma pasta local e sincronize automaticamente as alterações de arquivos com sua base de conhecimento. **Pro tip:** Aponte para seu cofre do Obsidian para manter suas notas pesquisáveis no SurfSense.
+## Tudo o mais que vem na caixa
-Todos os recursos operam no espaço de busca escolhido, para que suas respostas sejam sempre baseadas nos seus próprios dados.
+O workspace de pesquisa que fez do SurfSense a principal alternativa open source ao NotebookLM continua aqui, e tudo o que seus agentes coletam chega até ele.
-### Como Colaborar em Tempo Real (Beta)
+**Base de conhecimento**
-1. Acesse a página de Gerenciar Membros e crie um convite.
+- Envie PDFs, documentos do Office, imagens e áudio, ou sincronize **Google Drive, OneDrive e Dropbox**. Mais de 50 formatos de arquivo suportados.
+- Busca híbrida semântica e de texto completo, com respostas citadas no estilo Perplexity.
+- Organização de arquivos por IA que classifica automaticamente os documentos por origem, data e tópico.
-
+
-2. O colega aceita e aquele SearchSpace se torna compartilhado.
+**Estúdio de entregáveis**
-
+- Gerador de relatórios com IA, com exportação para PDF, DOCX, HTML, LaTeX, EPUB, ODT ou texto simples.
+- Podcasts de IA com dois apresentadores a partir de qualquer documento ou pasta em menos de 20 segundos.
+- Apresentações de slides editáveis, resumos em vídeo narrados e geração de imagens por IA.
-3. Torne o chat compartilhado.
+
-
+**Colaboração em equipe**
-4. Sua equipe agora pode conversar em tempo real.
+- Chats de IA colaborativos em tempo real, com comentários e menções.
+- RBAC com os papéis de Owner, Admin, Editor e Viewer.
-
+
-5. Adicione comentários para marcar colegas de equipe.
+**Aplicativo desktop**
-
+Assistência de IA nativa em todos os aplicativos do seu computador. Baixe na [versão mais recente](https://github.com/MODSetter/SurfSense/releases/latest).
+
+- **General Assist**: abra o SurfSense a partir de qualquer aplicativo com um atalho global.
+- **Quick Assist**: selecione texto em qualquer lugar e peça à IA para explicar, reescrever ou agir sobre ele.
+- **Screenshot Assist**: capture qualquer região da tela e faça perguntas à IA sobre ela.
+- **Watch Local Folder** (monitorar pasta local): sincronize automaticamente uma pasta local com a sua base de conhecimento. Aponte para o seu cofre do Obsidian para manter suas notas pesquisáveis.
+
+
+
+**Sem dependência de fornecedor**
+
+- Mais de 100 LLMs via especificação da OpenAI e LiteLLM, incluindo GPT-5.5, Claude Sonnet 5 e Gemini 3.1 Pro.
+- Mais de 6.000 modelos de embedding e todos os principais rerankers.
+- Suporte completo a LLMs locais e privados (vLLM, Ollama), para que seus dados continuem sendo seus.
+
+## Exemplo do Agente de Vídeo
+
+https://github.com/user-attachments/assets/012a7ffa-6f76-4f06-9dda-7632b470057a
+
+## Exemplo do Agente de Podcast
+
+https://github.com/user-attachments/assets/a0a16566-6967-4374-ac51-9b3e07fbecd7
+
+## Como colaborar em tempo real (Beta)
+
+1. Vá até a página Manage Members e crie um convite.
+
+
+
+2. Um colega entra e aquele workspace passa a ser compartilhado.
+
+
+
+3. Torne um chat compartilhado e trabalhem nele juntos em tempo real, com comentários para marcar colegas.
+
+
## SurfSense vs Google NotebookLM
+Ainda nos comparando como alternativa ao NotebookLM? Aqui está o comparativo honesto.
+
| Recurso | Google NotebookLM | SurfSense |
|---------|-------------------|-----------|
-| **Fontes por Notebook** | 50 (Grátis) a 600 (Ultra, $249.99/mês) | Ilimitadas |
-| **Número de Notebooks** | 100 (Grátis) a 500 (planos pagos) | Ilimitados |
-| **Limite de Tamanho da Fonte** | 500.000 palavras / 200MB por fonte | Sem limite |
-| **Preços** | Nível gratuito disponível; Pro $19.99/mês, Ultra $249.99/mês | Gratuito e de código aberto, auto-hospedável na sua própria infra |
-| **Suporte a LLM** | Apenas Google Gemini | 100+ LLMs via OpenAI spec e LiteLLM |
-| **Modelos de Embeddings** | Apenas Google | 6.000+ modelos de embeddings, todos os principais rerankers |
-| **LLMs Locais / Privados** | Não disponível | Suporte completo (vLLM, Ollama) - seus dados ficam com você |
-| **Auto-Hospedável** | Não | Sim - Docker em um único comando ou Docker Compose completo |
-| **Código Aberto** | Não | Sim |
-| **Conectores Externos** | Google Drive, YouTube, sites | 27+ conectores - Mecanismos de busca, Google Drive, OneDrive, Dropbox, Slack, Teams, Jira, Notion, GitHub, Discord e [mais](#fontes-externas) |
-| **Suporte a Formatos de Arquivo** | PDFs, Docs, Slides, Sheets, CSV, Word, EPUB, imagens, URLs web, YouTube | 50+ formatos - documentos, imagens, vídeos via LlamaCloud, Unstructured ou Docling (local) |
-| **Busca** | Busca semântica | Busca Híbrida - Semântica + Texto completo com Índices Hierárquicos e Reciprocal Rank Fusion |
-| **Respostas com Citações** | Sim | Sim - Respostas citadas no estilo Perplexity |
-| **Arquitetura de Agentes** | Não | Sim - alimentado por [LangChain Deep Agents](https://docs.langchain.com/oss/python/deepagents/overview) com planejamento, subagentes e acesso ao sistema de arquivos |
-| **Multiplayer em Tempo Real** | Notebooks compartilhados com papéis de Visualizador/Editor (sem chat em tempo real) | RBAC com papéis de Proprietário / Admin / Editor / Visualizador, chat em tempo real e threads de comentários |
-| **Geração de Vídeos** | Visões gerais cinemáticas via Veo 3 (apenas Ultra) | Disponível (NotebookLM é melhor aqui, melhorando ativamente) |
-| **Geração de Apresentações** | Slides mais bonitos mas não editáveis | Cria apresentações editáveis baseadas em slides |
-| **Geração de Podcasts** | Visões gerais em áudio com hosts e idiomas personalizáveis | Disponível com múltiplos provedores TTS (NotebookLM é melhor aqui, melhorando ativamente) |
-| **Automações e Agentes de IA** | Não | Fluxos de trabalho de IA agendados, gatilhos por eventos em novos documentos e automações sem código criadas por chat com escrita de volta no Notion, Slack, Linear e Jira |
-| **Aplicativo Desktop** | Não | Aplicativo nativo com General Assist, Quick Assist, Screenshot Assist e sincronização de pastas locais |
-| **Extensão de Navegador** | Não | Extensão multi-navegador para salvar qualquer página web, incluindo páginas protegidas por autenticação |
-
-
-Lista completa de Fontes Externas
-
-
-Mecanismos de Busca (SearXNG, Tavily, LinkUp, Baidu Search) · Google Drive · OneDrive · Dropbox · Slack · Microsoft Teams · Linear · Jira · ClickUp · Confluence · BookStack · Notion · Gmail · Vídeos do YouTube · GitHub · Discord · Airtable · Google Calendar · Luma · Circleback · Elasticsearch · Obsidian, e mais por vir.
-
-
-
-
-## SOLICITAÇÕES DE FUNCIONALIDADES E FUTURO
+| **Dados de mercado ao vivo para agentes** | Não | Conectores de Reddit, YouTube, Google Maps, Google Search e rastreamento web via API REST e MCP |
+| **Servidor MCP** | Não | Cada conector exposto como ferramenta nativa de agente, além de servidores MCP próprios com apps OAuth em um clique |
+| **Fontes por Notebook** | 50 (gratuito) a 600 (Ultra, US$ 249,99/mês) | Ilimitadas |
+| **Número de Notebooks** | 100 (gratuito) a 500 (planos pagos) | Ilimitado |
+| **Limite de tamanho por fonte** | 500.000 palavras / 200 MB por fonte | Sem limite |
+| **Preços** | Plano gratuito; Pro US$ 19,99/mês, Ultra US$ 249,99/mês | Gratuito e open source para auto-hospedar; a nuvem é paga por uso, com US$ 5 de crédito gratuito |
+| **Suporte a LLMs** | Apenas Google Gemini | Mais de 100 LLMs via especificação da OpenAI e LiteLLM |
+| **Modelos de embedding** | Apenas Google | Mais de 6.000 modelos de embedding, todos os principais rerankers |
+| **LLMs locais / privados** | Não disponível | Suporte completo (vLLM, Ollama), seus dados continuam sendo seus |
+| **Auto-hospedável** | Não | Sim, com uma linha de Docker ou Docker Compose completo |
+| **Open source** | Não | Sim |
+| **Fontes da base de conhecimento** | Google Drive, YouTube, sites | Upload de arquivos, Google Drive, OneDrive, Dropbox, sincronização de pasta local e páginas rastreadas |
+| **Formatos de arquivo suportados** | PDFs, Docs, Slides, Sheets, CSV, Word, EPUB, imagens, URLs, YouTube | Mais de 50 formatos: documentos, imagens, vídeos via LlamaCloud, Unstructured ou Docling (local) |
+| **Busca** | Busca semântica | Híbrida semântica + texto completo, com índices hierárquicos e fusão de rankings recíprocos |
+| **Respostas com citações** | Sim | Sim, respostas citadas no estilo Perplexity |
+| **Arquitetura agêntica** | Não | Sim, com [LangChain Deep Agents](https://docs.langchain.com/oss/python/deepagents/overview), incluindo planejamento, subagentes e acesso ao sistema de arquivos |
+| **Automações e agentes de IA** | Não | Fluxos agendados, gatilhos por eventos e automações sem código criadas via chat, com gravação no Notion, Slack, Linear e Jira |
+| **Multiplayer em tempo real** | Notebooks compartilhados com papéis Viewer/Editor (sem chat em tempo real) | RBAC com papéis Owner / Admin / Editor / Viewer, chat em tempo real e threads de comentários |
+| **Geração de vídeo** | Video Overviews cinematográficos via Veo 3 (apenas Ultra) | Disponível (o NotebookLM é melhor aqui, em melhoria contínua) |
+| **Geração de apresentações** | Slides mais bonitos, porém não editáveis | Apresentações editáveis baseadas em slides |
+| **Geração de podcasts** | Audio Overviews com apresentadores e idiomas personalizáveis | Disponível com vários provedores de TTS (o NotebookLM é melhor aqui, em melhoria contínua) |
+| **Aplicativo desktop** | Não | App nativo com General Assist, Quick Assist, Screenshot Assist e sincronização de pasta local |
+## Pedidos de recursos e futuro
**O SurfSense está em desenvolvimento ativo.** Embora ainda não esteja pronto para produção, você pode nos ajudar a acelerar o processo.
-Junte-se ao [Discord do SurfSense](https://discord.gg/ejRNvftDp9) e ajude a moldar o futuro do SurfSense!
+Entre no [Discord do SurfSense](https://discord.gg/ejRNvftDp9) e ajude a moldar o futuro do SurfSense!
## Roadmap
-Fique atualizado com nosso progresso de desenvolvimento e próximas funcionalidades!
-Confira nosso roadmap público e contribua com suas ideias ou feedback:
+Fique por dentro do nosso progresso de desenvolvimento e dos próximos recursos. Confira nosso roadmap público e contribua com suas ideias ou feedback:
-**Discussão do Roadmap:** [SurfSense 2026 Roadmap](https://github.com/MODSetter/SurfSense/discussions/565)
+**Discussão do roadmap:** [SurfSense 2026 Roadmap](https://github.com/MODSetter/SurfSense/discussions/565)
**Quadro Kanban:** [SurfSense Project Board](https://github.com/users/MODSetter/projects/3)
+## Contribua
-## Contribuir
-
-Todas as contribuições são bem-vindas, desde estrelas e relatórios de bugs até melhorias no backend. Consulte [CONTRIBUTING.md](CONTRIBUTING.md) para começar.
+Todas as contribuições são bem-vindas, de estrelas e relatos de bugs a melhorias no backend. Veja o [CONTRIBUTING.md](CONTRIBUTING.md) para começar.
Obrigado a todos os nossos Surfers:
@@ -310,13 +247,13 @@ Obrigado a todos os nossos Surfers:
-## Histórico de Stars
+## Histórico de estrelas
-
+
diff --git a/README.zh-CN.md b/README.zh-CN.md
index d3d5330f6..76df2536a 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -1,4 +1,4 @@
-
+
@@ -20,291 +20,228 @@
-# SurfSense
+# SurfSense：为你的 AI 智能体注入竞争情报能力
-NotebookLM 是目前最好、最实用的 AI 平台之一，但当你开始经常使用它时，你也会感受到它的局限性，总觉得还有不足之处。
+SurfSense 是**面向 AI 智能体的开源竞争情报平台**。你的智能体可以通过一个 **REST API** 或 **MCP 服务器**，利用来自 **Reddit、YouTube、Google Maps、Google Search 和开放网络**的实时数据，监控竞争对手、追踪排名、倾听市场动态。定时和事件触发的智能体会把发现的内容转化为简报和预警，内置的知识库则让每一条发现都可搜索、可引用。
-1. 一个笔记本中可以添加的来源数量有限制。
-2. 可以拥有的笔记本数量有限制。
-3. 来源不能超过 500,000 个单词和 200MB。
-4. 你被锁定在 Google 服务中（LLM、使用模型等），没有配置选项。
-5. 有限的外部数据源和服务集成。
-6. NotebookLM 代理专门针对学习和研究进行了优化，但你可以用源数据做更多事情。
-7. 缺乏多人协作支持。
+> [!NOTE]
+> **📢 致我们的 NotebookLM 替代品用户**
+>
+> 在过去几个月里，我们把 SurfSense 打造成了针对个人知识的最佳通用研究智能体，这段旅程为我们赢得了一个令我们由衷自豪的社区。如今，Claude、OpenCode、Hermes、OpenClaw 等智能体工具已经证明智能体就是未来，通用研究正在成为每个有能力的智能体开箱即用的功能。而智能体仍然缺少的是**实时市场数据以及围绕它的工作流**，所以这正是我们全力投入的方向：成为标杆级的开源竞争情报智能体平台。
+>
+> **你所依赖的一切功能都不会消失。**你的知识库、带引用的对话、报告、播客、演示文稿、自动化以及协作聊天都会继续可用，自托管也依然免费且开源。完整公告请阅读[我们的更新日志](https://www.surfsense.com/changelog)。
-...还有更多。
+## 为什么智能体需要 SurfSense
-**SurfSense 正是为了解决这些问题而生。** SurfSense 赋予你：
+问任何一个有能力的智能体"竞争对手这周的定价是多少？"或者"自发布以来 Reddit 上对我们的评价如何？"，它都找不到可信赖的数据来源。官方平台 API 要么有速率限制，要么按企业级定价，要么根本不存在，而自建抓取管线又非常脆弱。SurfSense 正是为填补这一空白而生：
-- **控制你的数据流** - 保持数据私密和安全。
-- **无数据限制** - 添加无限数量的来源和笔记本。
-- **无供应商锁定** - 配置任何 LLM、图像、TTS 和 STT 模型。
-- **25+ 外部数据源** - 从 Google Drive、OneDrive、Dropbox、Notion 和许多其他外部服务添加你的来源。
-- **实时多人协作支持** - 在共享笔记本中轻松与团队成员协作。
-- **AI 自动化与智能体** - 按计划运行 AI 智能体，或在文档进入文件夹的那一刻触发它们，然后将结果回写到 Notion、Slack、Linear 和 Drive。只需在聊天中描述即可创建无代码自动化。
-- **桌面应用** - 通过 Quick Assist、General Assist、Screenshot Assist 和本地文件夹同步在任何应用程序中获得 AI 助手。
+- **平台原生连接器**，每个都是返回结构化 JSON 的强类型 REST 端点。不用赌速率限制，也不用解析 HTML。
+- **一个 MCP 服务器**，把每个连接器都作为原生工具（`reddit.scrape`、`google_search.scrape` 等）暴露给 Claude、Cursor 或任何智能体框架。
+- **一套智能体运行框架**，而不只是原始数据：重试、结构化输出和额度计量都已内置，智能体可以从一个问题直达一份简报，无需你自己搭建管线。
+- **开源且可自托管**，你的竞争研究数据始终留在你自己的基础设施上。
-...更多功能即将推出。
+## 实时数据连接器
+| 连接器 | 你的智能体能获得什么 | 了解更多 |
+|---|---|---|
+| **Reddit** | 帖子、评论和子版块信息流，不受官方 API 速率限制 | [Reddit Scraper API](https://www.surfsense.com/reddit) |
+| **YouTube** | 视频、字幕转录和评论串，用于品牌和产品舆情监听 | [YouTube Scraper API](https://www.surfsense.com/youtube) |
+| **Google Maps** | 地点、评分和评论，用于本地竞争对手和潜在客户调研 | [Google Maps Scraper API](https://www.surfsense.com/google-maps) |
+| **Google Search** | 实时搜索结果页，用于排名追踪和市场监控 | [Google Search API](https://www.surfsense.com/google-search) |
+| **Web Crawl** | 把开放网络上的任意页面转为干净、结构化的内容 | [Web Crawling API](https://www.surfsense.com/web-crawl) |
+| **MCP Connector** | 将任意 MCP 服务器接入你的智能体，Notion、Slack、Jira 等支持一键 OAuth | [MCP Connector](https://www.surfsense.com/mcp-connector) |
+计费采用按量付费：连接器按实际返回的条目计费，爬取按成功抓取的页面计费，失败的调用永不计费。自托管部署默认关闭计费。详见[定价](https://www.surfsense.com/pricing)。
-## 视频代理示例
+## 快速开始
-https://github.com/user-attachments/assets/012a7ffa-6f76-4f06-9dda-7632b470057a
+### 在代码中调用连接器
+每个连接器都是一个 REST 端点，你可以用任何语言、凭借你的 SurfSense API 密钥来调用：
+```bash
+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"
+ }'
+```
-## 播客代理示例
+每个[连接器页面](https://www.surfsense.com/connectors)都提供 Python、JavaScript、Go、PHP、Ruby、Java 和 C# 的可直接复制粘贴的示例。
-https://github.com/user-attachments/assets/a0a16566-6967-4374-ac51-9b3e07fbecd7
+### 通过 MCP 把工具交给你的智能体
+把 SurfSense MCP 服务器添加到 Claude、Cursor 或你自己的智能体框架：
-## 如何使用 SurfSense
+```json
+{
+ "mcpServers": {
+ "surfsense": {
+ "url": "https://mcp.surfsense.com",
+ "headers": { "Authorization": "Bearer ${SURFSENSE_API_KEY}" }
+ }
+ }
+}
+```
-### Cloud
+现在，你的智能体就可以把每个连接器当作原生工具来调用。
-1. 访问 [surfsense.com](https://www.surfsense.com) 并登录。
+### 使用云端服务
+
+访问 [surfsense.com](https://www.surfsense.com)，登录后用自然语言向智能体索取实时市场数据。新账户自带 5 美元免费额度，无需订阅。
