> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.

# Laravel Bluesky

> revolution/laravel-bluesky의 개요, 요건, 설치, 초기 설정, 첫 게시까지를 한꺼번에 확인합니다.

## 개요

[revolution/laravel-bluesky](https://github.com/invokable/laravel-bluesky)는 AT Protocol(Bluesky)을 Laravel에서 다루기 위한 패키지입니다.

Facade는 `Revolution\Bluesky\Facades\Bluesky`입니다. 게시 작성, 피드 취득, 검색, 미디어 게시 등을 Laravel의 HTTP 클라이언트에 가까운 형태로 다룰 수 있습니다.

## 요건

* PHP `>= 8.3`
* Laravel `>= 12.x`

## 설치

```bash theme={null}
composer require revolution/laravel-bluesky
```

## 환경 변수

App Password 인증을 사용하는 경우에는 `.env`를 설정합니다.

```dotenv theme={null}
BLUESKY_IDENTIFIER=your-handle.bsky.social
BLUESKY_APP_PASSWORD=xxxx-xxxx-xxxx-xxxx
```

## 퀵 스타트

### 첫 게시

```php theme={null}
use Revolution\Bluesky\Facades\Bluesky;

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

### TextBuilder로 링크와 태그 다루기

```php theme={null}
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);
```

<Warning>
  `searchPosts()`는 API의 일시적인 제한으로 인해 현재 미인증 상태에서는 동작하지 않습니다. 검색을 사용할 때에도 인증된 세션을 사용하세요.
</Warning>

## 문서

<Columns cols={2}>
  <Card title="Basic client" href="/ko/packages/laravel-bluesky/basic-client" icon="terminal-square">
    App Password / OAuth, 게시, 미디어, 리플라이, 인용, 피드, 검색을 확인합니다.
  </Card>

  <Card title="Socialite" href="/ko/packages/laravel-bluesky/socialite" icon="shield-check">
    AT Protocol OAuth(DPoP)를 사용한 Bluesky 고유의 Socialite 설정과 사용법.
  </Card>

  <Card title="알림 채널" href="/ko/packages/laravel-bluesky/notification" icon="bell">
    Laravel Notification 채널로서 Bluesky에 게시·DM을 전송합니다.
  </Card>

  <Card title="Feed Generator" href="/ko/packages/laravel-bluesky/feed-generator" icon="rss">
    자체 알고리즘 피드를 생성·공개합니다.
  </Card>
</Columns>

## 참고 링크

* GitHub: [invokable/laravel-bluesky](https://github.com/invokable/laravel-bluesky)
* DeepWiki: [invokable/laravel-bluesky](https://deepwiki.com/invokable/laravel-bluesky)


## Related topics

- [Laravel Bluesky](/en/packages/laravel-bluesky/index.md)