SurfSense/README.pt-BR.md
DESKTOP-RTLN3BA\$punk 64f2b4a6eb feat: updated readmes
2026-07-06 16:57:04 -07:00

20 KiB

SurfSense, a plataforma open source de inteligência competitiva para agentes de IA

MODSetter%2FSurfSense | Trendshift

SurfSense: Dê Inteligência Competitiva aos Seus Agentes de IA

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.

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.

Sumário

Por que os agentes precisam do SurfSense

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:

  • 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 (surfsense_reddit_scrape, surfsense_google_search 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.

O que você pode fazer com o SurfSense?

Cada caso de uso abaixo é uma tarefa real que o agente do SurfSense executa de ponta a ponta hoje, em um único prompt ou de forma agendada.

Fluxos de trabalho multi-conector

Encadeie vários conectores em uma única execução do agente e receba um único relatório com citações.

  • Impacto de um lançamento, em todas as plataformas — "Nosso concorrente lançou a v2 ontem. Meça a reação nas buscas, no Reddit e no YouTube." O agente raspa SERPs, threads do Reddit e comentários do YouTube, e depois funde os três sinais em um único relatório de impacto do lançamento.
  • Análise de concorrentes locais — o Google Maps encontra os players, o rastreador web lê suas páginas de preços e o Google Search mostra quem vence a busca, tudo em uma única execução.
  • Concorrente 360, de forma agendada — uma automação encadeia quatro conectores toda semana: mudanças no site, movimentos de ranking, sentimento no Reddit e reação no YouTube.

Monitoramento de concorrentes

  • Vigilância de preços — extraia cada plano, preço e limite das páginas de preços dos concorrentes em uma única tabela, depois verifique novamente todo dia e receba alertas sobre qualquer mudança.
  • Acompanhamento de produto e changelog — rastreie as páginas de changelog, produto e vagas dos rivais toda segunda-feira e receba um relatório do que eles lançaram.
  • Monitoramento de rankings e anúncios — acompanhe os rankings do Google, os anúncios pagos e as citações em AI Overviews que o seu mercado realmente vê, e sinalize os movimentos dia a dia.

Geração de leads B2B

  • Leads de negócios locais — transforme uma categoria e um território ("hamburguerias em San Jose") em uma lista de leads com telefones, sites, avaliações e contatos de decisores extraídos dos sites deles.
  • Equipes e contatos — rastreie o site de qualquer empresa e extraia a equipe completa com e-mails, redes sociais e a origem de cada dado, exportado para CSV.
  • Mapeamento de portfólios e mercados — mapeie o portfólio de um investidor ou uma categoria inteira, e depois enriqueça cada empresa com preços e contatos.

Escuta de marca e mercado

  • Monitoramento de marca no Reddit — ouça o que o seu mercado diz sobre você, seus concorrentes e sua categoria nas threads onde os compradores falam com franqueza.
  • Sentimento da audiência no YouTube — colete vídeos, transcrições e comentários em escala, e depois agrupe o que as audiências elogiam e criticam.
  • Mineração de intenção e de quem quer trocar — encontre as pessoas que estão ativamente buscando uma alternativa a um concorrente, ordenadas por quão prontas estão para migrar.

Pesquisa de mercado

  • Pesquisa profunda na web ao vivo — o agente rastreia dezenas de fontes ao vivo sobre uma pergunta e sintetiza uma resposta com citações, não um índice desatualizado.
  • Acompanhamento de AI Overviews e GEO — capture quando os AI Overviews do Google respondem às buscas do seu mercado, e exatamente quais fontes eles citam.
  • Relatórios e alertas com citações — tudo o que os agentes coletam chega ao seu workspace como relatórios e alertas com fontes que você pode verificar.

Automatize qualquer uma dessas tarefas, sem código

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. Experimente prompts como:

  • "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."

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
YouTube Vídeos, transcrições e threads de comentários para monitoramento de marca e produto YouTube Scraper API
Google Maps Estabelecimentos, avaliações e reviews para pesquisa local de concorrentes e leads Google Maps Scraper API
Google Search SERPs ao vivo para acompanhamento de rankings e monitoramento de mercado Google Search API
Web Crawl (rastreamento web) Qualquer página da web aberta como conteúdo limpo e estruturado Web Crawling API
Conectores MCP externos Traga qualquer servidor MCP para seus agentes, com OAuth em um clique para Notion, Slack, Jira e outros External MCP Connectors

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.

Início rápido

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:

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"
  }'

Cada página de conector tem exemplos prontos para copiar e colar em Python, JavaScript, Go, PHP, Ruby, Java e C#.

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:

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

Seu agente agora pode chamar cada conector como uma ferramenta nativa. Veja a página do servidor MCP do SurfSense para a lista completa de ferramentas, ou execute o servidor localmente a partir de surfsense_mcp.

Use a nuvem

Acesse 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.

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.

Pré-requisitos: o Docker Desktop precisa estar instalado e em execução.

Para Linux/macOS:

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

Para Windows:

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

O script de instalação configura o 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.

Tudo o mais que vem na caixa

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.

Base de conhecimento

  • 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.

Converse com seus PDFs e documentos

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.

Gerador de Relatórios com IA

Colaboração em equipe

  • Chats de IA colaborativos em tempo real, com comentários e menções.
  • RBAC com os papéis de Owner, Admin, Editor e Viewer.

Chat de IA colaborativo

Aplicativo desktop

Assistência de IA nativa em todos os aplicativos do seu computador. Baixe na versão mais recente.

  • 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.

Quick Assist

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.

    Convidar membros

  2. Um colega entra e aquele workspace passa a ser compartilhado.

    Fluxo de entrada por convite

  3. Torne um chat compartilhado e trabalhem nele juntos em tempo real, com comentários para marcar colegas.

    Comentários em tempo real

SurfSense vs Google NotebookLM

Ainda nos comparando como alternativa ao NotebookLM? Aqui está o comparativo honesto.

Recurso Google NotebookLM SurfSense
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, 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.

Entre no Discord do SurfSense e ajude a moldar o futuro do SurfSense!

Roadmap

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

Quadro Kanban: SurfSense Project Board

Contribua

Todas as contribuições são bem-vindas, de estrelas e relatos de bugs a melhorias no backend. Veja o CONTRIBUTING.md para começar.

Obrigado a todos os nossos Surfers:

Histórico de estrelas

Gráfico do histórico de estrelas

Catalyst Project