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 conecta tus sistemas con iPhones reales para flujos de trabajo de publicación en TikTok, Instagram y YouTube. 0bull te ofrece una REST API, un servidor MCP autenticado por OAuth y una superficie de navegador para una revisión práctica.
Construye sobre tres objetos. Ranura, cuenta, envío.
La API y el servidor MCP de 0bull exponen el mismo modelo de publicación básico: un teléfono es una ranura, una cuenta social vinculada es una cuenta, y un trabajo de medios es un envío. Las cuentas y los envíos admiten TikTok, Instagram y YouTube. La plataforma usa TikTok por defecto por compatibilidad con versiones anteriores.
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. Usa la que encaje con el trabajo.
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
Da a Claude Code, Claude Desktop, Cursor, Codex u otro cliente MCP acceso a la superficie más completa de cuenta, envío, facturación, carga y control del teléfono.
$ claude mcp add --transport http 0bull https://0bull.net/mcpControl desde el navegador
Deja que un VA o un operador trabaje desde la pantalla del teléfono cuando una persona necesite revisar o gestionar un aviso de la plataforma.
Ver el flujo de trabajo del operador
Autentica 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í, enumera las cuentas o teléfonos a los que puedes acceder. Selecciona una cuenta por su UUID o un teléfono por su UUID de ranura. Pon en cola un envío solo para una cuenta activa. Después consulta el recurso devuelto en lugar de tratar una solicitud aceptada como un resultado publicado.
- 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"
}
}
}El teléfono es parte del contrato. Diseña en torno a él.
- 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.
- Se admite la revisión humana
- Un envío puede fallar de una forma que requiera que una persona inspeccione el dispositivo. El modelo de estado documentado deja esos estados visibles para que tu flujo de trabajo pueda detenerse y pasar el control a un operador.
- Los límites de peticiones están documentados
- REST y MCP permiten 60 solicitudes por minuto. Es normal consultar el estado periódicamente, pero deja tiempo entre llamadas mientras el teléfono completa su trabajo.
Referencia de herramientas de MCP
Una superficie de herramientas real. Agrupada por el trabajo.
El servidor MCP expone las herramientas registradas en el servidor 0bull Phone Farm. Usa la referencia completa para parámetros y formas de respuesta; esta página mantiene el mapa claro.
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 la granja 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-toolPídele al agente de la GUI en el teléfono que realice una tarea concreta de forma asíncrona.
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.
Conoce los límites. Antes de construir.
El modelo de producto documentado es un flujo de trabajo con teléfonos reales. 0bull pone en cola acciones en el teléfono físico, en lugar de presentarlo como una API de publicación directa en la plataforma. Las interfaces REST y MCP son superficies de control de 0bull para esos flujos de trabajo de dispositivos.
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.
El envío está en cola para el teléfono. Consulta el recurso del envío y lee su estado. Que se acepte una solicitud no significa que el vídeo se haya publicado.
Sí. La superficie del navegador es el camino del operador para el trabajo práctico en pantalla, la revisión y otras acciones donde un VA o un compañero de equipo necesita ver el dispositivo.
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í.
Empieza gratis