Laravel Bluesky

Resumen, requisitos, instalación, configuración inicial y primer post con revolution/laravel-bluesky.

​

Descripción general

revolution/laravel-bluesky es un paquete para trabajar con AT Protocol (Bluesky) desde Laravel.

El Facade es Revolution\Bluesky\Facades\Bluesky. Puedes crear publicaciones, obtener feeds, buscar y publicar multimedia con un estilo cercano al cliente HTTP de Laravel.

​

Requisitos

• PHP >= 8.3
• Laravel >= 12.x

​

Instalación

composer require revolution/laravel-bluesky

​

Variables de entorno

Si vas a usar autenticación con App Password, configura .env.

BLUESKY_IDENTIFIER=your-handle.bsky.social
BLUESKY_APP_PASSWORD=xxxx-xxxx-xxxx-xxxx

​

Inicio rápido

​

Primera publicación

use Revolution\Bluesky\Facades\Bluesky;

$response = Bluesky::login(
    identifier: config('bluesky.identifier'),
    password: config('bluesky.password'),
)->post('Hello Bluesky');

​

Manejar enlaces y etiquetas con TextBuilder

use Revolution\Bluesky\Facades\Bluesky;
use Revolution\Bluesky\Record\Post;
use Revolution\Bluesky\RichText\TextBuilder;

$post = Post::build(function (TextBuilder $builder) {
    $builder->text('Hello Bluesky')
        ->newLine(count: 2)
        ->link('https://bsky.app/')
        ->newLine()
        ->tag('#Bluesky');
});

$response = Bluesky::login(
    identifier: config('bluesky.identifier'),
    password: config('bluesky.password'),
)->post($post);

searchPosts() no funciona actualmente sin autenticación debido a una restricción temporal de la API. Utiliza una sesión autenticada también cuando quieras buscar.

​

Documentación

Basic client

Revisa App Password / OAuth, publicaciones, multimedia, respuestas, citas, feeds y búsqueda.

Socialite

Configuración y uso de Socialite específico de Bluesky con OAuth (DPoP) de AT Protocol.

Canal de notificaciones

Envía publicaciones y DMs a Bluesky como canal de Laravel Notification.

Feed Generator

Crea y publica tus propios feeds algorítmicos.

​

Enlaces de referencia

• GitHub: invokable/laravel-bluesky
• DeepWiki: invokable/laravel-bluesky