Pular para o conteúdo

Plataforma para desenvolvedores

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

The social media posting API for developers that runs on real iPhones. Your code posts to TikTok, Instagram and YouTube through a REST API or an OAuth-authenticated MCP server, and a real iPhone does the work. Need a human? Take the screen in the browser.

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

A REST API e o servidor MCP compartilham um modelo simples: um telefone é um slot, uma conta social vinculada é uma conta e um trabalho de vídeo é um envio. Contas e envios funcionam no TikTok, Instagram e YouTube.

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. Escolha sua arma.

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

Entregue ao Claude Code, Claude Desktop, Cursor, Codex ou qualquer cliente MCP o kit completo: contas, envios, cobrança, uploads e controle direto do telefone.

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

Controle pelo navegador

Coloque um VA ou operador na tela ao vivo do telefone sempre que um humano precisar revisar uma publicação ou responder a um aviso.

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 telefones que você pode acessar. Escolha uma conta pelo UUID ou um telefone pelo UUID do slot, coloque um envio na fila para uma conta ativa e depois consulte o recurso retornado até o status final.

  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"
    }
  }
}

Restrito e seguro. Fácil de planejar.

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.
Passagem para humanos integrada
Quando um trabalho precisa de uma pessoa no aparelho, o status do envio avisa, e seu fluxo passa o telefone para um operador.
Limites de requisição claros
REST e MCP permitem 60 requisições por minuto. Consultar o status é esperado, então espace as chamadas enquanto o telefone faz o trabalho.

Referência das ferramentas do MCP

Ferramentas de verdade. Agrupadas por tarefa.

Todas as ferramentas que seu agente recebe, agrupadas pela função. Parâmetros completos e formatos de resposta estão na referência.

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

    Remove an account from 0bull without deleting it on its platform.

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

    Dê ao agente de IA no telefone uma tarefa em linguagem simples e deixe ele trabalhar.

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.

Perguntas de desenvolvedores. Respondidas com clareza.

Não. A 0bull roda o app nativo em um iPhone físico e publica a partir do telefone, do mesmo jeito que uma pessoa faria no app. A REST API e o servidor MCP são a forma de controlar esses telefones.

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.

Ele entra na fila do telefone. Consulte o recurso do envio e leia o status para saber quando o vídeo foi publicado.

Sim. Abra o telefone no navegador e assuma: revisões, trabalho direto na tela, tudo o que um VA ou colega precisar ver.

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.

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

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

Peça um telefone
Fale conosco