reddapi.dev MCP

Servidor MCP remoto para busca semântica no Reddit, tópicos em alta e descoberta de leads. Requer uma chave de API do reddapi.dev; plano gratuito limitado disponível.

Documentação

[ model_context_protocol ]

Servidor MCP

› conecte seu assistente de IA diretamente à API de busca do Reddit · pesquise milhões de conversas por meio de linguagem natural

// O_QUE_É_MCP [ visão geral ]

› o Model Context Protocol (MCP) é um padrão aberto que permite que assistentes de IA se conectem com segurança a fontes de dados e ferramentas externas. em vez de copiar e colar dados, sua IA pode acessar e analisar informações diretamente em tempo real.

› com nosso servidor MCP, qualquer cliente de IA compatível ganha a capacidade de pesquisar o vasto banco de dados de conversas do Reddit por meio de conversa natural.

// CONFIGURAÇÃO_RÁPIDA [ 3 etapas ]

01

› obtenha_sua_chave_de_api

cadastre-se (grátis - sem cartão de crédito), depois gere uma chave de API no seu painel da conta. contas gratuitas recebem 3 chamadas de ferramenta a cada 7 dias · planos pagos aumentam o limite.

02

› adicione_a_configuração_do_servidor

› adicione a seguinte configuração de servidor MCP ao seu cliente de IA · funciona com claude desktop, cursor, windsurf e outros

{
  "mcpServers": {
    "reddit-search-api": {
      "transport": {
        "type": "http",
        "url": "https://reddapi.dev/api/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_API_KEY"
        }
      }
    }
  }
}

› substitua YOUR_API_KEY pela sua chave real

03

› reinicie_o_cliente

› após salvar o arquivo de configuração, reinicie seu cliente de IA. as ferramentas da API de busca do Reddit estarão disponíveis em suas conversas.

// OK · CLIENTES_COMPATÍVEIS

› funciona com claude desktop, cursor, windsurf, cline e outros. consulte modelcontextprotocol.io para a lista completa.

// AUTENTICAÇÃO [ obrigatória ]

› o servidor MCP exige uma chave de API para executar ferramentas · sem uma chave válida, a execução das ferramentas falhará.

// COMO_OBTER_CHAVE_DE_API

02

› nenhuma assinatura necessária - contas gratuitas podem gerar uma chave (3 chamadas de ferramenta / 7 dias); faça upgrade apenas para um limite maior · [planos]

03

› vá ao painel da sua conta · [conta]

04

› encontre a seção de chave de API e clique em "gerar chave de API"

05

› copie a chave e substitua YOUR_API_KEY na sua configuração MCP

// AVISO · MANTENHA_A_CHAVE_EM_SEGREDO

› nunca compartilhe sua chave de API publicamente nem a envie para o controle de versão. se for comprometida, regenere-a pelo painel da sua conta.

// ERRO_SEM_AUTENTICAÇÃO

› se você tentar usar ferramentas MCP sem uma chave de API válida, verá este erro:

{
  "error": {
    "code": -32001,
    "message": "Authentication required. Please provide a valid API key..."
  }
}

// FERRAMENTAS_DISPONÍVEIS

Ferramentas MCP

› 6 ferramentas disponíveis para assistentes de IA

FERRAMENTA reddit_semantic_search [ Exige chave de API ]

› Busca semântica com IA. Extrai palavras-chave via LLM, realiza busca vetorial e gera um resumo com IA. Mais lenta, porém mais abrangente.

// PARÂMETROS

nometipoobrigatóriodescrição
querystring[obrig]Consulta de busca em linguagem natural
limitnumber[opc]Número de resultados (padrão: 20, máx: 100)

// EXEMPLO_DE_PROMPT

› "O que os desenvolvedores acham de Rust vs Go para serviços de backend?"

FERRAMENTA reddit_vector_search [ Exige chave de API ]

› Busca rápida por similaridade vetorial. Converte diretamente a consulta em embeddings e encontra postagens semelhantes. Sem processamento LLM, muito mais rápida.

// PARÂMETROS

nometipoobrigatóriodescrição
querystring[obrig]Consulta de busca
limitnumber[opc]Número de resultados (padrão: 30, máx: 30)

// EXEMPLO_DE_PROMPT

› "Encontre postagens sobre teclados mecânicos para programação"

FERRAMENTA reddit_list_subreddits [ Exige chave de API ]

› Obtenha uma lista paginada de subreddits disponíveis com metadados.

// PARÂMETROS

nometipoobrigatóriodescrição
pagenumber[opc]Número da página (padrão: 1)
limitnumber[opc]Resultados por página (padrão: 20, máx: 100)
searchstring[opc]Filtro de busca por nome/título/descrição do subreddit

FERRAMENTA reddit_get_subreddit [ Exige chave de API ]

› Obtenha informações detalhadas sobre um subreddit específico.

// PARÂMETROS

nometipoobrigatóriodescrição
subredditstring[obrig]Nome do subreddit (sem o prefixo r/)

// EXEMPLO_DE_PROMPT

› "Obtenha detalhes sobre o subreddit typescript"

FERRAMENTA reddit_get_trends [ Exige chave de API ]

› O que o Reddit está comentando: entidades nomeadas (produtos, pessoas, jogos, programas, eventos) extraídas diariamente das principais postagens, classificadas por engajamento, com a variação de menções em relação ao período anterior.

// PARÂMETROS

nometipoobrigatóriodescrição
pagenumber[opc]Número da página (padrão: 1)
limitnumber[opc]Resultados por página (padrão: 12, máx: 50)
filterstring[opc]"today" = dia mais recente calculado, "latest" / "week" = últimos 7 dias, "month" = últimos 30 dias
categorystring[opc]Tecnologia, Saúde, Mercados e Investimentos, Política e Ativismo, Entretenimento, Esportes, Games, Ciência, Notícias Mundiais, Estilo de Vida, Outros

// EXEMPLO_DE_PROMPT

› "O que está em alta em tecnologia no Reddit esta semana?"

FERRAMENTA reddit_find_leads [ Exige chave de API ]

› Encontre leads e oportunidades de negócios em discussões do Reddit com pontuação de leads por IA

// PARÂMETROS

nometipoobrigatóriodescrição
querystring[obrig]Consulta em linguagem natural para encontrar leads (ex.: "pessoas procurando ferramentas de gerenciamento de projetos")
limitnumber[opc]Número de leads a retornar (padrão: 5, máx: 20)

// EXEMPLO_DE_PROMPT

› "Encontre pessoas procurando ativamente por uma ferramenta melhor de gerenciamento de projetos"

// EXEMPLOS_DE_USO [ 3 cenários ]

› pesquisar_um_tópico

You: What are developers saying about React Server Components?

AI: Let me search Reddit for discussions about React Server Components.

[Uses reddit_semantic_search tool]

Found 45 results for "React Server Components developer opinions"

Keywords: react, server components, next.js, performance, ssr

AI Summary:
Developers generally praise RSC for performance benefits in large applications...
Some express concerns about the learning curve and tooling complexity...

Top Results:

1. React Server Components: A year in production
   r/webdev | 1247 upvotes | 89 comments
   Relevance: 94.3%

› explorar_um_subreddit

You: Tell me about the r/typescript community

AI: [Uses reddit_get_subreddit tool]

r/typescript - TypeScript
Subscribers: 285,432
Created: 2012-10-01

Description: A community for discussing TypeScript, a typed superset...

Recent Posts:

1. TypeScript 5.4 released with new features
   567 upvotes | 45 comments

2. Help: How to type this complex nested object?
   234 upvotes | 12 comments

› encontrar_tópicos_em_alta

You: What's trending in tech on Reddit this week?

AI: [Uses reddit_get_trends tool with filter "week", category "Technology"]

Reddit trends, last 7 days, Technology (page 1 of 4, 41 entities)

1. Claude Code (product) - 23 top posts, +188% vs the previous 7 days
   r/ClaudeAI, r/programming, r/LocalLLaMA - first seen 2026-08-19
2. GPT-5 (product) - 17 top posts, -32% vs the previous 7 days
   r/OpenAI, r/singularity - active 6 of 7 days
3. Framework Laptop 16 (product) - 6 top posts, new this window
   r/framework, r/linux

// DETALHES_TÉCNICOS [ especificações ]

// PROTOCOLO

› Transporte HTTP Streamable do MCP (2025-11-25)

// ENDPOINT

https://reddapi.dev/api/mcp

// MÉTODOS_HTTP

métodofinalidade
POSTlida com solicitações json-rpc do cliente
GETabre fluxo sse para mensagens do servidor
DELETEencerra sessões

// SOLUÇÃO_DE_PROBLEMAS [ 5 problemas ]

› ferramentas_não_aparecendo

› verifique se o arquivo de configuração tem sintaxe json válida · tente copiar exatamente · reinicie o cliente completamente

› erros_de_conexão

› verifique se a url é exatamente https://reddapi.dev/api/mcp · verifique a internet e o firewall

› limite_de_taxa_excedido

› erro -32002 (http 429) · o plano gratuito permite 3 chamadas de ferramenta / 7 dias e 3 req/min; lite e superiores começam em 50 req/min · a mensagem de erro traz o tempo de redefinição — aguarde ou faça upgrade. não tente novamente imediatamente: novas tentativas durante um 429 são reembolsadas, mas um loop de tentativas ainda não traz nada até que a janela seja redefinida.

› códigos_de_erro

-32001 (401) chave de API ausente / inválida · -32003 (403) a chave é válida, mas seu plano não tem acesso à API — esperar não vai ajudar · -32002 (429) cota esgotada, tente novamente após o tempo de redefinição na mensagem

› contabilização_de_cota

› apenas tools/call conta · initialize / tools/list / resources/list / prompts/list são gratuitos · o MCP compartilha um único pool com a interface web e a API REST, não recebe uma cota separada · uma chamada de ferramenta com falha reembolsa sua cota diária e de ciclo, mas não o limite por minuto

// RECURSOS [ 6 links ]

[

› documentação_mcp

especificação oficial do protocolo

](https://modelcontextprotocol.io/)[

› docs_anthropic

documentação do cliente claude e mcp

](https://docs.anthropic.com/)[

› api_rest

integração direta com a API

](https://reddapi.dev/developers)[

› llms.txt

documentação amigável para LLM

](https://reddapi.dev/llms.txt)[

› habilidade_de_agente

definição completa da habilidade de API e MCP

](https://reddapi.dev/.well-known/skills/reddit-search-api/SKILL.md)[

› marketplace_openclaw

instale via openclaw

](https://clawhub.ai/dowands/reddapi)

// CTA · COMEÇAR

Pronto para conectar sua IA?

› conecte seu assistente de IA à API de busca do Reddit e comece a explorar