LotsSocial

npx add-mcp 'https://api.lots.social/mcp'

Pergunte ao seu agente, por exemplo.

Assim que o LotsSocial estiver conectado, solicitações simples como estas funcionam.

• "Agende os três posts desta semana no LinkedIn para às 9h nos dias úteis."
• "Transforme esta postagem de blog em uma legenda de carrossel para o Instagram e um tópico para o X."
• "Quais posts do mês passado tiveram mais engajamento em cada rede?"

Conecte em dois minutos.

Claude

Configurações → Conectores → Adicionar conector personalizado. Cole a URL, conecte e faça login com sua conta Lots.

ChatGPT

Configurações → Apps e Conectores → Avançado → ative o Modo de desenvolvedor e crie um conector com a URL e faça login.

Claude Code

claude mcp add --transport http lots-social https://api.lots.social/mcp

Codex

codex mcp add lots-social --url https://api.lots.social/mcp

Cursor, Windsurf e outros

{
  "mcpServers": {
    "lots-social": {
      "url": "https://api.lots.social/mcp"
    }
  }
}

Agentes na nuvem sem MCP

Dê ao agente https://api.lots.social/docs.md e uma chave de API de lotstech.com/api. Ele chama a API REST com Authorization: Bearer <key>.

Todo servidor usa OAuth: seu agente age como você, dentro dos seus próprios papéis e espaços de trabalho. Você pode desconectá-lo a qualquer momento pelo aplicativo.

31 ferramentas, também endpoints REST.

Cada ferramenta está disponível via MCP e como endpoint REST em https://api.lots.social/api/v1/lotssocial.

Crie até 50 rascunhos ou posts agendados para um conjunto compartilhado de contas conectadas. Trabalho com escopo de marca deve passar brand_id. Reddit e Pinterest precisam de platform_fields (subreddit; board_id e title), para todo o lote ou por post; plataformas que exigem mídia precisam dela antes do agendamento.

Cancelar Post Agendado

POST /posts/:post_id/cancel

Cancele um post agendado e retorne-o ao rascunho. Use list_social_posts com type=scheduled para encontrar o UUID do post.

Verificar Financiamento de Créditos

Verifique a cobertura do plano, o financiamento de créditos e as taxas de capacidade atuais. A cobertura do plano é usada primeiro; a capacidade além dela é paga automaticamente com os créditos do proprietário, cobrada diariamente (créditos gratuitos primeiro, depois créditos do plano, depois comprados). Se os créditos estiverem baixos, forneça o settings_url retornado para que o proprietário possa recarregar ou escolher um plano.

Concluir Upload de Mídia

Finalize um upload iniciado com create_media_upload depois que o arquivo for enviado via PUT para upload_url. Verifica o arquivo, salva-o na biblioteca de mídia e retorna seu media_id para create_social_post ou update_social_post. Adicione uma descrição e texto alternativo para que o arquivo possa ser encontrado e reutilizado.

Criar Marca

Crie uma marca (um grupo nomeado de contas conectadas, como uma empresa ou cliente) em um espaço de trabalho, opcionalmente colocando contas conectadas nela imediatamente. Uma conta já em outra marca é movida e a resposta nomeia a marca que ela deixou. Nomes de marca são únicos por espaço de trabalho; um conflito retorna o brand_id existente. Use quando a pessoa pedir para agrupar contas e depois passe brand_id ao postar para essa marca. Para conectar novas contas diretamente na marca, chame get_connect_link com seu brand_id.

Criar Upload de Mídia

Comece a enviar um arquivo de vídeo ou imagem que você tem localmente. Retorna um upload_url de curta duração: envie os bytes brutos do arquivo via PUT para ele com o cabeçalho Content-Type fornecido e depois chame complete_media_upload com o file_key para obter um media_id. Use para todo vídeo e para qualquer imagem que você não possa passar como URL.

Crie um rascunho ou post agendado para contas conectadas selecionadas. Use platform_captions para texto específico por conta e platform_fields para Reddit (subreddit, title, flair) e Pinterest (board_id, title, link). Trabalho com escopo de marca deve passar brand_id. O agendamento executa todas as regras de rede (validate_social_post é a execução de teste); rascunhos podem ficar incompletos.

Criar Espaço de Trabalho

Crie um novo espaço de trabalho de propriedade da pessoa, por exemplo, um por empresa ou cliente que ela administra. Contas, posts, mídia e resultados em espaços de trabalho diferentes nunca se misturam. Espaços de trabalho são gratuitos e ilimitados. Depois, use get_connect_link com o novo workspace_id para conectar suas contas sociais.

Excluir Arquivo de Mídia

Exclui permanentemente um arquivo de mídia. IMPORTANTE: Requer media_id — chame list_media primeiro para obter o UUID do arquivo de mídia. A exclusão é irreversível.

Exclua permanentemente um rascunho ou post agendado do LotsSocial. Posts publicados não podem ser excluídos: o LotsSocial não pode remover um post da rede, então a recusa retorna o link ao vivo de cada rede para a pessoa abrir e excluir lá enquanto estiver conectada. Criadores podem excluir apenas seus próprios rascunhos; gerentes e administradores podem excluir qualquer rascunho ou post agendado em seu espaço de trabalho.

Obter Detalhes da Conta

Obtenha o perfil de uma conta conectada, contagem de seguidores, saúde da conexão (ativa, expirando ou precisa reconectar, com o último erro) e histórico de postagens. account.audience tem a contagem diária mais recente de seguidores (inscritos no YouTube) com captured_on e followers_change_7d / followers_change_30d; cada mudança informa os dias que realmente cobre, que é mais curto enquanto o rastreamento é novo. Redes sem contagens retornam unavailable_reason, nunca 0. Contas do Reddit e Pinterest carregam posting_fields: o que passar em platform_fields e, para Pinterest, os boards da conta (IDs de board). Use quando posts para a conta falharem ou a pessoa perguntar sobre ela; se precisar reconectar, chame get_connect_link com account.reconnect.arguments (este account_id) e dê o link à pessoa: ele renova esta mesma conta no lugar.

Obter Análises Agregadas

Retorne totais de engajamento normalizados, detalhamentos por plataforma, principais posts, atualidade das análises e contagens de seguidores para um espaço de trabalho, marca, subconjunto de contas, plataforma ou intervalo de datas. Os totais cobrem apenas posts com análises; analytics_freshness.posts_without_analytics conta posts publicados que ainda não têm análises ou cuja rede não as compartilha. summary.avg_engagement_rate conta apenas posts que relataram exposição (impressões, senão visualizações, senão alcance): seu engajamento sobre sua exposição; summary.engagement_rate_basis informa quantos posts e quais denominadores foram usados, e a taxa é nula com um motivo quando nenhum o fez. audience lista cada conta no escopo com sua contagem diária mais recente de seguidores, captured_on, followers_change_7d / followers_change_30d (cada um informa os dias que cobre) ou unavailable_reason; ignora o intervalo de datas.

Obter Status de Cobrança

Mostre quanto o LotsSocial custa para esta pessoa agora: saldo de Créditos LotsTech, qual plano (se houver) cobre quantas contas, quantas contas são pagas com créditos, o gasto mensal de créditos e aproximadamente quanto tempo o saldo dura. Use quando perguntarem sobre créditos, custo, cobrança ou se podem adicionar outra conta, e depois que comprarem créditos para confirmar que a recarga chegou. Contas além de um plano custam créditos mensais; posts, armazenamento de mídia, espaços de trabalho e marcas são gratuitos (uso justo). Membros do espaço de trabalho de outra pessoa veem apenas se outra conta pode ser adicionada, já que o proprietário paga.

Obter Posts de Destaque da Marca

Retorne os posts publicados da marca classificados em relação à sua mediana de engajamento por plataforma, a partir de análises salvas. Use para análise de desempenho solicitada ou exemplos anteriores relevantes. Relata cobertura e desempenho relativo; não requer um fluxo de trabalho de pesquisa.

Obter Link de Conexão

Crie um link que a pessoa abre no navegador para conectar uma conta social (LinkedIn, Instagram, X e outras) ao LotsSocial, ou para reconectar uma que já tem. Use sempre que pedirem para conectar, adicionar ou vincular uma conta, ou quando list_connected_accounts mostrar que a conta para a qual querem postar está ausente. Para renovar uma conta existente (expirada, precisa reconectar ou posts falham com erro de autorização), passe seu account_id: o link renova essa mesma conta no lugar, mantendo seu ID, marca, histórico de posts e posts agendados, e não adiciona nada novo. Dê a url à pessoa e peça para abri-la; nunca abra você mesmo, porque faz login na conta social dela. O link funciona por uma hora. Um link de nova conta pode conectar várias contas; contas além da cobertura do plano são pagas com créditos automaticamente e, se o saldo não cobrir a conta, ofereça get_credits_link. Depois, chame list_connected_accounts (ou get_account_details para uma reconexão) para confirmar.

Obter Link de Créditos

Crie um link de checkout para comprar Créditos LotsTech, que pagam por contas conectadas além da cobertura do plano. Use quando a pessoa pedir para adicionar créditos, ou quando get_billing_status ou get_connect_link mostrar que não há créditos suficientes para o que ela quer. Pergunte quanto ela quer gastar se não tiver dito (mínimo de US$ 10). Dê a url para pagar no navegador; nunca peça dados de cartão no chat. Créditos comprados nunca expiram. Chame get_billing_status depois para confirmar que chegaram.

Obter Detalhes de Mídia

Recupera detalhes de um arquivo de mídia específico (imagem/vídeo). IMPORTANTE: Requer media_id — chame list_media primeiro para obter o UUID do arquivo de mídia.

Obter Manual da Plataforma

Obtenha orientações de plataforma versionadas e datadas, com evidências de política oficial, prática observada e experimental mantidas separadas. Os agentes devem obedecer às regras oficiais e tratar a orientação de alcance como testável, não garantida.

Obter Análises de Post

GET /posts/:post_id/analytics

Retorne análises de engajamento para um post publicado, por rede. Use list_social_posts com type=posted para encontrar o UUID do post. Uma entrada de rede com analytics_available=false não tem dados ainda (ou a rede não os compartilha) e fornece um motivo: relate esse motivo, nunca como engajamento zero.

Recupera detalhes completos de um único post social, incluindo todos os arquivos de mídia, logs de plataforma, contas conectadas, status de publicação e histórico de edição. Aplica controle de acesso baseado em papéis — criadores só podem acessar seus próprios posts, a menos que tenham permissões de gerente/administrador.

Listar Marcas

Liste as marcas em um espaço de trabalho com quantas contas conectadas cada uma possui. Marcas agrupam contas (por exemplo, uma empresa ou cliente); passe um brand_id ao postar para que apenas as contas dessa marca sejam usadas. Crie ou reagrupe marcas com create_brand e update_brand.

Listar Contas Conectadas

Liste contas sociais conectadas para você, um espaço de trabalho ou uma marca: plataforma, nome, status de conexão, marca, caption_limit (caracteres que esta conta aceita; X Premium permite 25.000, X gratuito 280) e requires_media (Instagram, YouTube, Pinterest e TikTok precisam de imagem ou vídeo). Escreva cada legenda dentro do caption_limit da conta. Ao trabalhar para uma marca, passe brand_id: um espaço de trabalho pode conter contas de várias marcas.

Listar Arquivos de Mídia

Pesquise imagens e vídeos acessíveis por nome de arquivo, tags, descrição ou texto alternativo antes de pedir um novo ativo ao proprietário.

Liste posts em rascunho, agendados ou publicados com plataforma, mídia, criador, espaço de trabalho e filtro opcional por marca.

Listar Espaços de Trabalho

Recupera todos os espaços de trabalho dos quais o usuário autenticado é membro. Retorna detalhes do espaço de trabalho, incluindo nome, slug, tipo, proprietário e o papel do usuário e data de entrada em cada espaço de trabalho. Verifica automaticamente o status da assinatura.

Atualizar Marca

Renomeie uma marca ou mova contas conectadas para dentro ou para fora dela. add_account_ids move contas de nenhuma marca ou de outra marca (relatado como moved_from); remove_account_ids as deixa sem marca. As contas devem estar conectadas no espaço de trabalho da marca. Use quando a pessoa pedir para reagrupar contas, ou quando create_social_post recusar contas de marcas diferentes e a pessoa quiser colocá-las em uma marca. Posts agendados mantêm suas contas.

Atualizar Metadados de Mídia

Atualize a descrição, o texto alternativo ou as tags de um ativo de mídia para que pessoas e agentes possam encontrá-lo e reutilizá-lo.

Atualize um rascunho ou post agendado existente. Suporta legendas específicas por conta, platform_fields do Reddit e Pinterest (mesclados sobre os salvos) e seleções de substituição de plataforma/mídia; preserva atribuição existente e campos não alterados pela solicitação.

Atualizar Espaço de Trabalho

Renomeie um espaço de trabalho ou altere sua descrição ou logotipo. Somente proprietários e administradores. Excluir um espaço de trabalho e gerenciar seus membros são feitos no aplicativo LotsSocial.

Enviar Mídia Armazene uma imagem ou vídeo na biblioteca de mídia do LotsSocial a partir de um link público (url), ou uma imagem a partir de base64, e retorne seu media_id e URL pública. Vídeos (MP4, MOV, WebM até 200 MB) são transmitidos a partir do link. Para um arquivo no seu computador, use create_media_upload e complete_media_upload. Adicione uma descrição e texto alternativo para que o ativo possa ser encontrado e reutilizado.

Verifique uma publicação contra todas as regras da rede sem salvá-la: limites de legenda e título, mídia e campos obrigatórios, contagem de arquivos, formato, tamanho, proporção, duração do vídeo, transparência e animação, por conta. Aceita a mesma entrada que create_social_post (ou post_id para verificar uma atualização, ou posts mais plataformas para um lote em massa). Retorna valid, errors (bloquear agendamento), warnings (um rascunho pode mantê-los) e notices (arquivos que o LotsSocial converterá), cada um com account_id, media_id e a frase que o painel mostra. Corrija os erros antes de agendar.

Perguntas, respondidas.

Qual é a URL do servidor MCP do LotsSocial?

https://api.lots.social/mcp. Adicione-o como um servidor MCP remoto (conector personalizado) no seu agente de IA e entre com sua conta Lots.

Quais agentes funcionam com LotsSocial?

Claude, ChatGPT (modo desenvolvedor), Claude Code, Codex, Cursor, Windsurf e qualquer outro cliente que suporte MCP remoto com OAuth. Agentes sem MCP usam a API REST com uma chave de API.

Onde estão os documentos da API do LotsSocial?

https://api.lots.social/docs.md: Markdown escrito para que um agente de IA possa lê-lo. As solicitações vão para https://api.lots.social/api/v1/lotssocial com Authorization: Bearer <your key>.

Como obtenho uma chave de API do LotsSocial?

Use Gerar chave nesta página ou em lotstech.com/api. Entre com sua conta LotsTech, nomeie a chave e copie-a uma vez. Você pode revogá-la lá a qualquer momento.

O acesso MCP ou API custa extra?

Não. Está incluído no LotsSocial. Você paga apenas pelo plano ou uso do próprio LotsSocial, e seu provedor de IA cobra pelo próprio uso.