Pular para o conteúdo
0bull
Comece grátis

Plataforma para desenvolvedores

API de publicação em redes sociais para desenvolvedores em iPhones reais

A API de publicação em redes sociais para desenvolvedores conecta seus sistemas a iPhones reais para fluxos de publicação no TikTok, Instagram e YouTube. A 0bull oferece uma REST API, um servidor MCP autenticado por OAuth e uma interface de navegador para revisão manual.

Comece grátisLeia a documentação para desenvolvedores

Ver o fluxo de integração

Construa sobre três objetos. Slot, conta, envio.

A API e o servidor MCP da 0bull expõem o mesmo modelo central de publicação: um telefone é um slot, uma conta social vinculada é uma conta, e um trabalho de mídia é um envio. Contas e envios suportam TikTok, Instagram e YouTube. A plataforma usa TikTok como padrão por compatibilidade retroativa.

Slot

Um UUID para um telefone atribuído.

Conta

Uma conta de plataforma, opcionalmente vinculada a um telefone; a publicação exige uma conta ativa nesse telefone.

Envio

Uma tarefa de vídeo com um status a consultar.

Os IDs de conta são UUIDs. As ferramentas de telefone usam o UUID do slot retornado por list-phones-tool, não o rótulo visível ao usuário. Um envio deve ter como destino uma conta ativa no telefone dela. A maioria das ações de plataforma e das ações de fluxo que tocam o telefone entra na fila e retorna imediatamente. phone-control-tool, phone-snapshot-tool e phone-ocr-tool retornam de forma síncrona. Consulte os recursos de conta ou de envio para o trabalho enfileirado de conta e de envio.

Três interfaces. Use a que combina com o trabalho.

Use a REST quando sua aplicação precisa de um contrato HTTP estável. Use o MCP quando um cliente de IA deve descobrir ferramentas e agir com OAuth pelo navegador. Use o painel ou o controle pelo navegador quando uma pessoa precisa inspecionar a tela real.

Para sistemas

REST API

Crie contas, liste contas, enfileire envios e consulte o status com requisições HTTP autenticadas por bearer token.

Abrir a referência da API
Para clientes de IA

Servidor MCP

Dê ao Claude Code, Claude Desktop, Cursor, Codex ou outro cliente MCP acesso à interface mais completa de conta, envio, cobrança, upload e controle do telefone.

$ claude mcp add --transport http 0bull https://0bull.net/mcp
Ver opções de conexão
Para operadores

Controle pelo navegador

Deixe um VA ou operador trabalhar a partir da tela do telefone quando um humano precisar revisar ou lidar com um aviso da plataforma.

Ver o fluxo do operador

Autentique e envie. Depois, observe e revise.

Comece autenticando a interface que seu cliente usa. Clientes REST criam um token de API em Configurações, copiam-no uma vez e o enviam como bearer token. Clientes MCP adicionam a URL do servidor HTTP e autorizam em um navegador via OAuth. Nenhum dos dois modelos de identidade dá acesso às contas ou às permissões de telefone de outro usuário.

A partir daí, liste as contas ou os telefones que você pode alcançar. Selecione uma conta pelo UUID dela ou um telefone pelo UUID do slot. Coloque um envio na fila apenas para uma conta ativa. Depois consulte o recurso retornado, em vez de tratar uma requisição aceita como um resultado já publicado.

  1. Autentique o cliente.
  2. Encontrar uma conta ou um telefone atribuído.
  3. Enfileire um envio, faça upload da mídia pela URL de upload assinada quando necessário, e use a ferramenta de telefone apropriada; consulte o envio para o trabalho enfileirado.
  4. Consulte o status e traga uma pessoa quando a plataforma precisar de atenção.
REST API: listar contascurl
curl https://0bull.net/api/v1/accounts \
  -H "Authorization: Bearer $OBULL_TOKEN" \
  -H "Accept: application/json"
MCP: adicione o servidor HTTPjson
{
  "mcpServers": {
    "0bull": {
      "type": "http",
      "url": "https://0bull.net/mcp"
    }
  }
}

O telefone faz parte do contrato. Projete em torno dele.

Acesso restrito
Cada token de API e cada autorização de MCP têm escopo na conta que os criou. As chamadas de MCP só enxergam as contas do autor da chamada e alcançam os telefones para os quais ele tem permissão.
A revisão humana é suportada
Um envio pode falhar de um jeito que exige que uma pessoa inspecione o aparelho. O modelo de status documentado deixa esses estados visíveis para que seu fluxo de trabalho possa parar e repassar para um operador.
Os limites de requisições estão documentados
A REST API e o MCP permitem 60 requisições por minuto. A consulta é esperada, mas deixe um intervalo entre as chamadas de status enquanto o telefone conclui o trabalho.

Referência das ferramentas do MCP

Ferramentas de verdade. Agrupadas por tarefa.

O servidor MCP expõe as ferramentas registradas no servidor 0bull Phone Farm. Use a referência completa para parâmetros e formatos de resposta; esta página mantém o mapa legível.

Contas

Crie e inspecione as contas de publicação que suas automações usam.

  • list-accounts-tool

    Listar contas no TikTok, no Instagram e no YouTube.

  • get-account-tool

    Buscar uma única conta de publicação em qualquer plataforma.

  • create-account-tool

    Vincular uma conta de publicação que já está conectada em um telefone.

  • delete-account-tool

    Remover uma conta da fazenda sem excluí-la na plataforma dela.

Envios e uploads

Conduza a mídia pelo fluxo de publicação e observe o resultado.

  • list-submissions-tool

    Listar os envios recentes nas plataformas suportadas.

  • get-submission-tool

    Buscar um envio e consultar seu status.

  • create-upload-url-tool

    Criar uma URL assinada de curta duração para upload direto de vídeo.

  • create-submission-tool

    Colocar um vídeo na fila a partir de uma URL pública ou de mídia enviada para uma conta.

  • cancel-submission-tool

    Cancelar um envio na fila ou em andamento.

  • delete-submission-tool

    Excluir um envio concluído e o vídeo armazenado dele.

Telefones

Inspecionar e operar diretamente um slot de telefone atribuído.

  • list-phones-tool

    Listar os slots de telefone que você pode ver, com o estado da sessão deles.

  • list-phone-runs-tool

    Listar as execuções de um telefone, das mais recentes para as mais antigas.

  • get-phone-run-tool

    Obter uma execução de telefone pelo ID da execução.

  • phone-command-tool

    Executar comandos de dispositivo, como ações de área de transferência, URL, energia e conectividade.

  • phone-control-tool

    Enviar operações diretas de toque, deslize, atalho de teclado e entrada de texto.

  • phone-snapshot-tool

    Capturar uma imagem JPEG da tela do telefone.

  • phone-ocr-tool

    Ler texto da tela de um telefone com OCR.

  • run-macro-tool

    Executar um fluxo nomeado ou uma sequência bruta de passos no telefone.

  • run-phone-agent-tool

    Peça ao agente de interface do telefone que execute uma tarefa específica de forma assíncrona.

Cobrança e aluguéis

Ler aluguéis e solicitar mudanças na quantidade de telefones com aprovação humana envolvida.

  • get-billing-tool

    Ler aluguéis de telefone, datas de renovação e pedidos pendentes.

  • start-rental-tool

    Retornar um link do Stripe Checkout para um primeiro pedido de telefone.

  • request-phones-tool

    Solicitar uma mudança na quantidade de telefones alugados.

  • get-billing-request-tool

    Verificar o status de uma solicitação de mudança na quantidade de telefones.

Leia cada parâmetroRevisar o status assíncrono

Conheça os limites. Antes de construir.

O modelo de produto documentado é um fluxo com telefone real. A 0bull coloca as ações na fila do aparelho físico, em vez de apresentar isso como uma API de publicação direta na plataforma. As interfaces REST e MCP são interfaces de controle da 0bull para esses fluxos de dispositivo.

A REST é uma API HTTP com bearer token para contas e envios. O MCP é um servidor autenticado por OAuth para um cliente MCP, com o conjunto de ferramentas mais amplo, que também cobre uploads, cobrança e operações diretas no telefone.

As contas usam UUIDs e identificam sua própria plataforma. As ferramentas de telefone usam o UUID do slot retornado por list-phones-tool. O rótulo do slot visível ao usuário não é o identificador a ser passado para uma ferramenta de telefone.

O envio entra na fila do telefone. Consulte o recurso do envio e leia seu status. Uma requisição aceita não é o mesmo que um vídeo publicado.

Sim. A interface do navegador é o caminho do operador para trabalho prático na tela, revisão e outras ações em que um VA ou colega de equipe precisa ver o aparelho.

A referência da API cobre autenticação por bearer, paginação, códigos de resposta e erros de validação. As páginas de conexão e visão geral do MCP cobrem OAuth, escopo, trabalho assíncrono e limites de requisições.

Abrir a documentaçãoOperações de telefone para agênciasFluxo de dispositivo no TikTok

O seu próximo passo.
Já está nas suas mãos.

Escolha um país. Nós atribuímos o telefone. Você segue daí.

Comece grátis