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

# 빠른 시작

이 예제에서는 XDK를 사용해 Bearer 토큰 인증 방식으로 포스트를 빠르게 검색하는 방법을 보여줍니다.

<div id="step-1-install-the-sdk">
  ## 1단계: SDK 설치하기
</div>

```bash theme={null}
pip install xdk
```

<div id="step-2-get-your-bearer-token">
  ## 2단계: Bearer 토큰 발급받기
</div>

1. [X 개발자 콘솔](https://developer.x.com/en/portal/dashboard)에 로그인합니다.
2. 새 App을 생성하거나 App을 선택합니다.
3. "Keys and Tokens"에서 app-only 인증용 Bearer 토큰을 생성합니다.

<div id="step-3-write-and-run-your-first-script">
  ## 3단계: 첫 번째 스크립트 작성하고 실행하기
</div>

`quickstart.py` 파일을 생성합니다:

```python theme={null}
# Client 가져오기
from xdk import Client
# 실제 Bearer 토큰으로 교체
client = Client(bearer_token="YOUR_BEARER_TOKEN_HERE")
# "api"를 언급하는 최근 포스트 가져오기
# search_recent는 Iterator를 반환하므로 반복 처리
for page in client.posts.search_recent(query="api", max_results=10):
    if page.data and len(page.data) > 0:
        # 첫 번째 포스트에 접근 - Pydantic 모델은 속성 및 딕셔너리 접근을 모두 지원
        first_post = page.data[0]
        post_text = first_post.text if hasattr(first_post, 'text') else first_post.get('text', '')
        print(f"Latest Post: {post_text}")
        break
    else:
        print("포스트를 찾을 수 없습니다.")
        break
```

실행하세요:

```bash theme={null}
python quickstart.py
```

**예상 출력**:

```
최신 게시물: XDK Python SDK에 대한 흥미로운 업데이트!
```

**문제 해결**: 401 오류가 발생하면 Bearer 토큰을 다시 확인하세요. 요청 한도(429) 오류인 경우, 잠시 기다렸다가 다시 시도하세요.

<div id="next-steps">
  ## 다음 단계
</div>

* [Authentication](/ko/xdks/python/authentication)을 살펴보고 Bearer 토큰(App 전용) 인증, PKCE를 사용하는 OAuth 2.0(사용자 컨텍스트), OAuth 1.0a(레거시 사용자 컨텍스트)를 어떻게 사용하는지 이해하세요.
* 여러 번 API 호출을 하지 않고도 대량의 결과를 반환받고자 할 때 활용하는 [Pagination](/ko/xdks/python/pagination)에 대해 알아보세요.
* 실시간 데이터를 다루는 방법을 배우기 위해 [Streaming](/ko/xdks/python/streaming)을 살펴보세요.
  Python XDK를 사용하는 상세 코드 예시는 [코드 샘플 GitHub 저장소](https://github.com/xdevplatform/samples/tree/main/python)를 확인하세요.