Saltar al contenido

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.

Para sistemas

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 API
Para clientes de IA

Servidor 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/mcp
Ver opciones de conexión
Para operadores

Control 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 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í, 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.

  1. Autenticar al cliente.
  2. Encuentra una cuenta o un teléfono asignado.
  3. 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.
  4. Consulta el estado y suma a una persona cuando la plataforma necesite atención.
REST API: listar cuentascurl
curl https://0bull.net/api/v1/accounts \
  -H "Authorization: Bearer $OBULL_TOKEN" \
  -H "Accept: application/json"
MCP: añade el servidor HTTPjson
{
  "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-tool

    Enumera cuentas en TikTok, Instagram y YouTube.

  • get-account-tool

    Obtén una cuenta de publicación en cualquier plataforma.

  • create-account-tool

    Vincula una cuenta de publicación que ya tiene la sesión iniciada en un teléfono.

  • delete-account-tool

    Elimina 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-tool

    Enumera los envíos recientes en las plataformas compatibles.

  • get-submission-tool

    Obtén un envío y consulta su estado.

  • create-upload-url-tool

    Crea una URL firmada de corta duración para cargar un vídeo directamente.

  • create-submission-tool

    Pon en cola un vídeo desde una URL pública o desde medios subidos para una cuenta.

  • cancel-submission-tool

    Cancela un envío en cola o en curso.

  • delete-submission-tool

    Elimina un envío terminado y su vídeo almacenado.

Teléfonos

Inspecciona y opera una ranura de teléfono asignada directamente.

  • list-phones-tool

    Enumera las ranuras de teléfono que puedes ver con su estado de sesión.

  • list-phone-runs-tool

    Lista las ejecuciones de un teléfono, de la más reciente a la más antigua.

  • get-phone-run-tool

    Obtén una ejecución de teléfono por su id de ejecución.

  • phone-command-tool

    Ejecuta comandos del dispositivo, como acciones de portapapeles, URL, energía y conectividad.

  • phone-control-tool

    Envía operaciones directas de toque, deslizamiento, teclas de acceso rápido y entrada de texto.

  • phone-snapshot-tool

    Captura una instantánea JPEG de la pantalla del teléfono.

  • phone-ocr-tool

    Lee texto de la pantalla de un teléfono con OCR.

  • run-macro-tool

    Ejecuta un flujo de trabajo con nombre o una secuencia directa de pasos en el teléfono.

  • run-phone-agent-tool

    Dale 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-tool

    Consulta los alquileres de teléfonos, las fechas de renovación y los pedidos pendientes.

  • start-rental-tool

    Devuelve un enlace de Stripe Checkout para un primer pedido de teléfono.

  • request-phones-tool

    Solicita un cambio en la cantidad de teléfonos alquilados.

  • get-billing-request-tool

    Comprueba 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
Contáctanos