Documentação do SociaHive
Guias rápidos, configuração do MCP, padrões de fluxo, receitas do cookbook e referências dos SDKs da plataforma de automação SociaHive.
Controle o SociaHive (agendamento de posts, fluxos de automação, contatos e métricas) por código. Escolha a porta que combina com você.
As três portas
Para assistentes de IA
Deixe o Claude, o ChatGPT, o Cursor ou qualquer assistente compatível com MCP usar o SociaHive por você. Configuração em dois minutos via MCP.
Para desenvolvedores
Chame a API REST direto ou use os SDKs oficiais de Node e Python no seu aplicativo. Inclui cURL, OpenAPI e geração de código.
Para quem automatiza sem código
O nó da comunidade do n8n, n8n-nodes-sociahive, está no npm. As listagens do Zapier e do Make chegam em breve. Até lá, aponte um nó HTTP genérico para a API REST.
O que mais tem aqui
- Padrões de fluxo: sete padrões com nome (roteador por palavra-chave, fallback com IA, sequência com ramificações e outros) que cobrem quase tudo o que as pessoas montam nos fluxos do SociaHive.
- Cookbook: três receitas completas que você pode copiar e executar hoje: responder comentários do Instagram com um direct de forma automática, agendar uma semana de posts a partir de um CSV e receber um resumo diário de desempenho com o Claude.
As superfícies em resumo
| Superfície | URL / pacote | Autenticação | Melhor para |
|---|---|---|---|
| Servidor MCP (HTTP) | https://www.sociahive.com/api/mcp | OAuth 2.1 + DCR ou X-API-Key | Assistentes de IA: Claude, ChatGPT, Cursor |
| Servidor MCP (stdio) | binário sociahive-mcp | X-API-Key | Clientes de IA locais (Claude Desktop, Claude Code) |
| API REST v1 | https://www.sociahive.com/api/v1/* | X-API-Key ou bearer OAuth | Qualquer cliente HTTP; a base dos SDKs |
| CLI | sociahive (npm) | variável de ambiente SOCIAHIVE_API_KEY | Scripts de shell, CI/CD, operações pontuais |
| SDK de Node | @sociahive/sdk | Igual à REST | Código de aplicativo em TypeScript / Node.js |
| SDK de Python | sociahive (PyPI) | Igual à REST | Código de aplicativo em Python |
Endereços auxiliares:
- Referência interativa da API: interface Scalar que exibe a especificação OpenAPI 3.1, com teste na hora.
- Especificação OpenAPI 3.1: legível por máquina; use no Postman, em GPTs personalizados do ChatGPT ou em qualquer gerador de SDK.
- Descoberta de OAuth:
/.well-known/oauth-authorization-server(RFC 8414) e/.well-known/oauth-protected-resource(RFC 9728). Os clientes MCP usam esses endereços para configurar a autenticação sozinhos.