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
| nome | tipo | obrigatório | descrição |
|---|---|---|---|
| query | string | [obrig] | Consulta de busca em linguagem natural |
| limit | number | [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
| nome | tipo | obrigatório | descrição |
|---|---|---|---|
| query | string | [obrig] | Consulta de busca |
| limit | number | [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
| nome | tipo | obrigatório | descrição |
|---|---|---|---|
| page | number | [opc] | Número da página (padrão: 1) |
| limit | number | [opc] | Resultados por página (padrão: 20, máx: 100) |
| search | string | [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
| nome | tipo | obrigatório | descrição |
|---|---|---|---|
| subreddit | string | [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
| nome | tipo | obrigatório | descrição |
|---|---|---|---|
| page | number | [opc] | Número da página (padrão: 1) |
| limit | number | [opc] | Resultados por página (padrão: 12, máx: 50) |
| filter | string | [opc] | "today" = dia mais recente calculado, "latest" / "week" = últimos 7 dias, "month" = últimos 30 dias |
| category | string | [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
| nome | tipo | obrigatório | descrição |
|---|---|---|---|
| query | string | [obrig] | Consulta em linguagem natural para encontrar leads (ex.: "pessoas procurando ferramentas de gerenciamento de projetos") |
| limit | number | [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étodo | finalidade |
|---|---|
| POST | lida com solicitações json-rpc do cliente |
| GET | abre fluxo sse para mensagens do servidor |
| DELETE | encerra 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