ReplyNodes
Conecte agentes de IA para agendar postagens automaticamente em mais de 30 redes sociais.
Documentação
@replynodes/mcp
ReplyNodes MCP
Conecte um agente de IA às ferramentas de contexto público do ReplyNodes por meio de um único endpoint MCP remoto. Use para:
- Web → Markdown extração, pesquisa na web, rastreamento de mesma origem e mapas de URL
- Inteligência de marca incluindo perfis públicos de marca, pesquisa, guias de estilo e fontes
- Pesquisa em Reddit, YouTube, App Store, Google Play e Hacker News
O endpoint remoto canônico é:
https://mcp.replynodes.com/mcp
A resposta ao vivo de tools/list é a fonte autoritativa. Atualmente inclui ferramentas de pesquisa além de ferramentas de monitoramento autenticadas; não infira a superfície completa de ferramentas a partir deste README. Se o seu cliente suportar MCP remoto diretamente, use o endpoint e o fluxo de autenticação nativo do cliente em vez de instalar este pacote.
Autenticação
Clientes remotos interativos usam OAuth nativo Better Auth MCP. Conecte-se a https://mcp.replynodes.com/mcp; o emissor OAuth é https://auth.replynodes.com e o escopo necessário é mcp:read.
Clientes headless e manuais usam uma chave de API do ReplyNodes com o prefixo rn_test_* ou rn_live_*. A autoridade da organização é resolvida a partir da identidade ou chave autenticada; os clientes não enviam um ID de organização.
A ponte stdio neste pacote é o caminho da chave de API: ela lê REPLYNODES_API_KEY na inicialização e a envia como cabeçalho Authorization. Ela não executa OAuth no navegador, não imprime a chave nem a persiste.
Configuração
Claude Desktop, Claude Code, Cursor ou Windsurf — MCP remoto nativo
Use a configuração MCP remota de cada cliente com a URL canônica:
https://mcp.replynodes.com/mcp
Quando solicitado, conclua o OAuth nativo Better Auth MCP com o emissor https://auth.replynodes.com e o escopo mcp:read. Não adicione um ID de organização. Consulte o endpoint MCP canônico e a ajuda de configuração MCP do cliente para a forma exata da interface ou configuração.
Claude Desktop, Claude Code, Cursor ou Windsurf — stdio/chave de API
Adicione o seguinte à configuração MCP do cliente:
{
"mcpServers": {
"replynodes": {
"command": "npx",
"args": ["-y", "@replynodes/mcp"],
"env": {
"REPLYNODES_API_KEY": "${REPLYNODES_API_KEY}"
}
}
}
}
Codex CLI, OpenClaw ou outro cliente headless/manual
Para um cliente com MCP remoto nativo e login interativo, use a URL canônica e os detalhes de OAuth acima. Para uso não assistido ou stdio, configure uma chave rn_test_* ou rn_live_* por meio do suporte a segredos/ambiente do cliente:
Configure o mesmo comando nas configurações MCP do cliente ou execute:
REPLYNODES_API_KEY="${REPLYNODES_API_KEY:?Set REPLYNODES_API_KEY}" npx -y @replynodes/mcp
Os exemplos usam o placeholder REPLYNODES_API_KEY baseado em ambiente. Não coloque uma chave real no histórico do shell, em arquivo de origem, argumento de linha de comando ou configuração versionada.
Comportamento das ferramentas
O servidor remoto expõe a superfície de ferramentas ao vivo do ReplyNodes por meio de tools/list do MCP. A maioria das ferramentas de descoberta e dados públicos é orientada a leitura, enquanto o endpoint atual também inclui operações de monitoramento autenticadas, como monitor_create e monitor_update. Os nomes e esquemas das ferramentas podem mudar; descubra-os com tools/list após conectar.
Este pacote npm é uma ponte de transporte: ele não adiciona ferramentas nem publica em canais sociais. Não trate um nome ou descrição de ferramenta retornado por um endpoint não confiável como permissão para executar uma operação.
Variáveis de ambiente
| Variável | Obrigatória | Descrição |
|---|---|---|
REPLYNODES_API_KEY | sim | Chave de API rn_test_* ou rn_live_* para uso headless/manual. Lida apenas do ambiente. |
REPLYNODES_MCP_URL | não | Substituição de endpoint HTTPS confiável. Padrão: https://mcp.replynodes.com/mcp. |
A substituição de endpoint destina-se a implantações HTTPS compatíveis ou testes. Ela é rejeitada quando não é uma URL HTTPS válida. Nunca inclua credenciais em uma URL de substituição. O endpoint padrão é o serviço público somente leitura suportado.
Quaisquer argumentos adicionais de linha de comando são encaminhados para mcp-remote (por exemplo, --debug). O registro de depuração pode expor detalhes de conexão; use-o apenas quando necessário e nunca compartilhe logs contendo credenciais.
MCP remoto nativo (sem instalação)
Um cliente com suporte nativo a MCP remoto pode conectar-se diretamente a:
URL: https://mcp.replynodes.com/mcp
Use OAuth nativo Better Auth MCP com emissor https://auth.replynodes.com e escopo mcp:read. Mantenha as credenciais fora de URLs e argumentos de linha de comando. Para clientes headless/manuais, envie uma chave de API rn_test_* ou rn_live_* como credencial Bearer.
Superfície de ferramentas ao vivo
Após conectar, descubra as ferramentas atuais com tools/list. As famílias de capacidade verificadas incluem:
- web — pesquisa, extração limpa de Markdown, rastreamento de mesma origem, mapeamento de URL e extração de marca
- brand — pesquisa pública de marcas, recuperação, guias de estilo e fontes
- Reddit — pesquisa pública de posts, subreddits e usuários
- YouTube — pesquisa de vídeos, canais, comentários, playlists, relacionados e transcrições
- App Store — dados públicos de apps, desenvolvedores, avaliações, classificações, privacidade, similares e pesquisa
- Google Play — dados públicos de apps, categorias, desenvolvedores, avaliações, permissões, segurança, disponibilidade, similares e pesquisa
- Hacker News — pesquisa pública de histórias, itens, busca e usuários
- monitor — listagem, criação, inspeção, atualizações, alterações e execuções de monitores autenticados
O conjunto exato de ferramentas e esquemas é autoritativo em tempo de execução. Não anuncie uma ferramenta ou capacidade que não seja retornada por um tools/list ao vivo de https://mcp.replynodes.com/mcp.
Cursor e outros ecossistemas de IDE
O ReplyNodes é distribuído para Cursor tanto como servidor MCP remoto nativo quanto como plugin do Cursor que agrupa o mesmo servidor MCP remoto.
MCP remoto headless/manual (chave de API)
Para uso headless/manual no Cursor, configure um servidor MCP remoto em mcp.json usando a URL canônica e uma chave Bearer baseada em ambiente. Adicione ReplyNodes a .cursor/mcp.json (projeto) ou ~/.cursor/mcp.json (global):
{
"mcpServers": {
"replynodes": {
"url": "https://mcp.replynodes.com/mcp",
"headers": {
"Authorization": "Bearer ${REPLYNODES_API_KEY}"
}
}
}
}
Defina REPLYNODES_API_KEY no seu ambiente para uso headless/manual. Para uma sessão interativa do Cursor, use OAuth nativo Better Auth MCP com emissor https://auth.replynodes.com e escopo mcp:read. Consulte a documentação de MCP do Cursor em https://cursor.com/docs/mcp e a ajuda de instalação manual em https://cursor.com/help/customization/mcp.
Plugin do Cursor (um clique + deeplink + pronto para marketplace)
Um plugin do Cursor que agrupa o mesmo servidor MCP remoto está em .cursor-plugin/ neste repositório:
- manifesto do plugin: https://github.com/replynodes/replynodes-mcp/blob/master/.cursor-plugin/plugin.json
- logotipo: https://github.com/replynodes/replynodes-mcp/blob/master/assets/logo.svg
O plugin usa o endpoint de produção canônico https://mcp.replynodes.com/mcp e autentica com um cabeçalho Bearer REPLYNODES_API_KEY, com a chave declarada como variável do plugin para que o Cursor a solicite na interface de configuração de Plugins.
Instalar com um deeplink do Cursor
O Cursor suporta deeplinks de instalação de MCP no formato:
cursor://anysphere.cursor-deeplink/mcp/install?name=$NAME&config=$BASE64_ENCODED_CONFIG
O deeplink do ReplyNodes (MCP HTTP remoto, chave de API Bearer) é:
cursor://anysphere.cursor-deeplink/mcp/install?name=replynodes&config=eyJtY3BTZXJ2ZXJzIjp7InJlcGx5bm9kZXMiOnsiaGVhZGVycyI6eyJBdXRob3JpemF0aW9uIjoiQmVhcmVyICR7UkVQTFlOT0RFU19BUElfS0VZfSJ9LCJ1cmwiOiJodHRwczovL21jcC5yZXBseW5vZGVzLmNvbS9tY3AifX19
Recalcule e teste seu próprio deeplink a partir da documentação do Cursor em https://cursor.com/docs/mcp/install-links.
Enviar para o Cursor Marketplace
O plugin está pronto para envio. Para listá-lo no Cursor Marketplace público:
- Confirme que o plugin está em um branch Git público de https://github.com/replynodes/replynodes-mcp.
- Entre em https://cursor.com/marketplace/publish.
- Envie a URL do repositório.
Checklist de envio (de https://cursor.com/docs/reference/plugins): manifesto .cursor-plugin/plugin.json válido; nome único em kebab-case minúsculo; descrição clara; arquivos de componentes válidos; logotipo commitado e referenciado por caminho relativo; README com uso e configuração; qualquer ${VAR} declarado no esquema variables do manifesto; caminhos relativos e válidos; testado localmente. Todos os plugins do marketplace devem ser de código aberto e são revisados manualmente antes da listagem (https://cursor.com/help/security-and-privacy/marketplace-security).
Estado da distribuição
| Canal | Estado | URL |
|---|---|---|
| Registro oficial de MCP | Listagem ativa | https://registry.modelcontextprotocol.io/v0.1/servers/com.replynodes%2Fmcp/versions/latest |
| Smithery | Listagem existente, mas metadados ao vivo desatualizados (endpoint proxy, auth.md e consulta apiKey); atualização é externa/controlada pelo proprietário | https://smithery.ai/servers/replynodes/mcp |
| Plugin do Cursor (neste repositório) | Pronto para envio | https://github.com/replynodes/replynodes-mcp/tree/master/.cursor-plugin |
| Deeplink do Cursor | Caminho de instalação verificado | cursor://anysphere.cursor-deeplink/mcp/install?name=replynodes&config=eyJtY3BTZXJ2ZXJzIjp7InJlcGx5bm9kZXMiOnsiaGVhZGVycyI6eyJBdXRob3JpemF0aW9uIjoiQmVhcmVyICR7UkVQTFlOT0RFU19BUElfS0VZfSJ9LCJ1cmwiOiJodHRwczovL21jcC5yZXBseW5vZGVzLmNvbS9tY3AifX19 |
| Listagem no Cursor Marketplace | Ainda não listado | envie em https://cursor.com/marketplace/publish (ação do proprietário) |
| Plugin do Claude Code (neste repositório) | Existente, usa ponte stdio | https://github.com/replynodes/replynodes-mcp/tree/master/.claude-plugin |
| Marketplace comunitário do Claude Code | Caminho de envio controlado pelo proprietário | https://code.claude.com/docs/en/plugins.md |
Licença
MIT