Plataforma de desarrollador
API de publicación en redes sociales para desarrolladores sobre iPhones reales
La API de publicación en redes sociales para desarrolladores que funciona con iPhones reales. Tu código publica en TikTok, Instagram y YouTube a través de una REST API o un servidor MCP autenticado con OAuth, y un iPhone real hace el trabajo. ¿Necesitas a una persona? Toma la pantalla desde el navegador.
Construye sobre tres objetos. Ranura, cuenta, envío.
La REST API y el servidor MCP comparten un modelo sencillo: un teléfono es una ranura, una cuenta social vinculada es una cuenta y un trabajo de vídeo es un envío. Las cuentas y los envíos funcionan en TikTok, Instagram y YouTube.
Ranura
Un UUID para un teléfono asignado.
Cuenta
Una cuenta de plataforma, opcionalmente vinculada a un teléfono; publicar requiere una cuenta activa en su teléfono.
Envío
Un trabajo de vídeo con un estado que consultar.
Los ID de cuenta son UUID. Las herramientas de teléfono usan el UUID de ranura que devuelve list-phones-tool, no la etiqueta visible para las personas. Un envío debe apuntar a una cuenta activa en su teléfono. La mayoría de las acciones de plataforma y de flujo de trabajo que tocan el teléfono se ponen en cola y responden de inmediato. phone-control-tool, phone-snapshot-tool y phone-ocr-tool devuelven la respuesta de forma síncrona. Consulta los recursos de cuenta o envío para el trabajo de cuenta y envío en cola.
Tres interfaces. Elige tu arma.
Usa REST cuando tu app necesite un contrato HTTP estable. Usa MCP cuando un cliente de IA deba descubrir herramientas y actuar con OAuth en el navegador. Usa el panel o el control desde el navegador cuando una persona necesite inspeccionar la pantalla real.
REST API
Crea cuentas, enumera cuentas, pon en cola envíos y consulta el estado con solicitudes HTTP con token de portador.
Abre la referencia de la APIServidor MCP
Dale a Claude Code, Claude Desktop, Cursor, Codex o cualquier cliente MCP el kit completo: cuentas, envíos, facturación, subidas y control directo del teléfono.
$ claude mcp add --transport http 0bull https://0bull.net/mcpControl desde el navegador
Pon a un VA u operador en la pantalla del teléfono en directo siempre que una persona tenga que revisar una publicación o atender un aviso.
Ver el flujo de trabajo del operadorAutentica y envía. Luego observa y revisa.
Empieza autenticando la superficie que usa tu cliente. Los clientes REST crean un token de API en Ajustes, lo copian una vez y lo envían como token de portador. Los clientes MCP añaden la URL del servidor HTTP y autorizan en un navegador a través de OAuth. Ninguno de los dos modelos de identidad da acceso a las cuentas de otro usuario ni a permisos de teléfono.
Desde ahí, lista las cuentas o teléfonos a los que tienes acceso. Elige una cuenta por su UUID o un teléfono por el UUID de su ranura, pon en cola un envío para una cuenta activa y luego consulta el recurso devuelto hasta su estado final.
- Autenticar al cliente.
- Encuentra una cuenta o un teléfono asignado.
- Pon en cola un envío, sube medios a través de la URL de carga firmada cuando sea necesario, y usa la herramienta de teléfono adecuada; consulta el envío para el trabajo en cola.
- Consulta el estado y suma a una persona cuando la plataforma necesite atención.
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"
}
}
}Limitado y seguro. Fácil de planificar.
- Acceso limitado
- Cada token de API y autorización de MCP está limitado a la cuenta que lo creó. Las llamadas MCP solo ven las cuentas de quien llama y llegan a los teléfonos para los que esa persona tiene permiso.
- Relevo humano integrado
- Cuando un trabajo necesita a una persona en el teléfono, el estado del envío lo indica y tu flujo le pasa el teléfono a un operador.
- Límites de uso claros
- REST y MCP permiten 60 solicitudes por minuto. Consultar el estado es lo esperado, así que espacia las llamadas mientras el teléfono hace su trabajo.
Referencia de herramientas de MCP
Una superficie de herramientas real. Agrupada por el trabajo.
Todas las herramientas que recibe tu agente, agrupadas por la tarea que hacen. Los parámetros completos y la forma de las respuestas están en la referencia.
Cuentas
Crea e inspecciona las cuentas de publicación que usan tus automatizaciones.
list-accounts-toolEnumera cuentas en TikTok, Instagram y YouTube.
get-account-toolObtén una cuenta de publicación en cualquier plataforma.
create-account-toolVincula una cuenta de publicación que ya tiene la sesión iniciada en un teléfono.
delete-account-toolElimina una cuenta de 0bull sin borrarla en su plataforma.
Envíos y cargas
Mueve los medios por el flujo de trabajo de publicación y observa su resultado.
list-submissions-toolEnumera los envíos recientes en las plataformas compatibles.
get-submission-toolObtén un envío y consulta su estado.
create-upload-url-toolCrea una URL firmada de corta duración para cargar un vídeo directamente.
create-submission-toolPon en cola un vídeo desde una URL pública o desde medios subidos para una cuenta.
cancel-submission-toolCancela un envío en cola o en curso.
delete-submission-toolElimina un envío terminado y su vídeo almacenado.
Teléfonos
Inspecciona y opera una ranura de teléfono asignada directamente.
list-phones-toolEnumera las ranuras de teléfono que puedes ver con su estado de sesión.
list-phone-runs-toolLista las ejecuciones de un teléfono, de la más reciente a la más antigua.
get-phone-run-toolObtén una ejecución de teléfono por su id de ejecución.
phone-command-toolEjecuta comandos del dispositivo, como acciones de portapapeles, URL, energía y conectividad.
phone-control-toolEnvía operaciones directas de toque, deslizamiento, teclas de acceso rápido y entrada de texto.
phone-snapshot-toolCaptura una instantánea JPEG de la pantalla del teléfono.
phone-ocr-toolLee texto de la pantalla de un teléfono con OCR.
run-macro-toolEjecuta un flujo de trabajo con nombre o una secuencia directa de pasos en el teléfono.
run-phone-agent-toolDale al agente de IA del teléfono una tarea en palabras sencillas y deja que la ejecute.
Facturación y alquileres
Consulta los alquileres y solicita cambios en el número de teléfonos con aprobación humana de por medio.
get-billing-toolConsulta los alquileres de teléfonos, las fechas de renovación y los pedidos pendientes.
start-rental-toolDevuelve un enlace de Stripe Checkout para un primer pedido de teléfono.
request-phones-toolSolicita un cambio en la cantidad de teléfonos alquilados.
get-billing-request-toolComprueba el estado de una solicitud de cambio en el número de teléfonos.
Preguntas de desarrolladores. Respondidas claramente.
No. 0bull ejecuta la app nativa en un iPhone físico y publica desde el teléfono, igual que lo haría una persona en la app. La REST API y el servidor MCP son la forma de controlar esos teléfonos.
REST es una API HTTP con token de portador para cuentas y envíos. MCP es un servidor autenticado por OAuth para un cliente MCP, con una superficie de herramientas más amplia que también cubre cargas, facturación y operaciones directas en el teléfono.
Las cuentas usan UUID e identifican su propia plataforma. Las herramientas de teléfono usan el UUID de ranura que devuelve list-phones-tool. La etiqueta de ranura visible para las personas no es el identificador que se debe pasar a una herramienta de teléfono.
Queda en cola para su teléfono. Consulta el recurso del envío y lee su estado para saber cuándo se ha publicado el vídeo.
Sí. Abre el teléfono en el navegador y toma el control: revisiones, trabajo directo en la pantalla, lo que un VA o un compañero necesite ver.
La referencia de la API cubre la autenticación con token de portador, la paginación, los códigos de respuesta y los errores de validación. Las páginas de conexión y descripción general de MCP cubren OAuth, alcances, trabajo asíncrono y límites de peticiones.
Tu próximo movimiento.
Ya está en tus manos.
Elige un país. Nosotros asignamos el teléfono. Tú sigues desde ahí.
Pide un teléfono