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.
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 APIServidor 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/mcpControle 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 operadorAutentique 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.
- Autentique o cliente.
- Encontrar uma conta ou um telefone atribuído.
- 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.
- Consulte o status e traga uma pessoa quando a plataforma precisar de atenção.
curl https://0bull.net/api/v1/accounts \
-H "Authorization: Bearer $OBULL_TOKEN" \
-H "Accept: application/json"{
"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-toolListar contas no TikTok, no Instagram e no YouTube.
get-account-toolBuscar uma única conta de publicação em qualquer plataforma.
create-account-toolVincular uma conta de publicação que já está conectada em um telefone.
delete-account-toolRemove 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-toolListar os envios recentes nas plataformas suportadas.
get-submission-toolBuscar um envio e consultar seu status.
create-upload-url-toolCriar uma URL assinada de curta duração para upload direto de vídeo.
create-submission-toolColocar um vídeo na fila a partir de uma URL pública ou de mídia enviada para uma conta.
cancel-submission-toolCancelar um envio na fila ou em andamento.
delete-submission-toolExcluir um envio concluído e o vídeo armazenado dele.
Telefones
Inspecionar e operar diretamente um slot de telefone atribuído.
list-phones-toolListar os slots de telefone que você pode ver, com o estado da sessão deles.
list-phone-runs-toolListar as execuções de um telefone, das mais recentes para as mais antigas.
get-phone-run-toolObter uma execução de telefone pelo ID da execução.
phone-command-toolExecutar comandos de dispositivo, como ações de área de transferência, URL, energia e conectividade.
phone-control-toolEnviar operações diretas de toque, deslize, atalho de teclado e entrada de texto.
phone-snapshot-toolCapturar uma imagem JPEG da tela do telefone.
phone-ocr-toolLer texto da tela de um telefone com OCR.
run-macro-toolExecutar um fluxo nomeado ou uma sequência bruta de passos no telefone.
run-phone-agent-toolDê 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-toolLer aluguéis de telefone, datas de renovação e pedidos pendentes.
start-rental-toolRetornar um link do Stripe Checkout para um primeiro pedido de telefone.
request-phones-toolSolicitar uma mudança na quantidade de telefones alugados.
get-billing-request-toolVerificar 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