> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# AI로 샤오홍슈 노트 검색하기

> 검색 기능을 찾고 입력과 요금을 확인한 다음 노트 한 페이지를 가져옵니다. 댓글 수집이나 전체 결과 내보내기는 하지 않습니다.

BeatAPI로 샤오홍슈 노트를 검색하려면 무료 Search 호출로 검색 기능을 찾고, 무료 Inspect 호출로 `data:xiaohongshu.app_v2.search_notes`의 입력과 요금을 확인한 다음, 유료 Run 호출로 노트 한 페이지를 가져오세요. 이 가이드는 검색 한 번만 다루며, 댓글 수집과 전체 결과 내보내기는 별도 작업입니다.

## 준비

AI 클라이언트에 [BeatAPI MCP](https://beatapi.io/mcp)를 연결하고 BeatAPI API 키를 준비하세요. Search와 Inspect 호출은 무료이고, Run 호출은 잔액을 사용합니다.

## AI에 전달할 작업

> 샤오홍슈에서 캠핑 커피에 관한 노트를 검색하세요. 먼저 기능을 찾고 필수 입력, 실행 준비 상태와 요금을 확인해 실행 전에 알려주세요. 제가 승인하면 한 페이지만 가져오고 간단한 미리보기와 가능한 경우 출처 링크를 보여주세요. 확인 없이 댓글을 가져오거나 다음 페이지를 요청하거나 유료 실행을 재시도하지 마세요.

## 기능 찾기

HTTP 클라이언트에서는 무료 Search 요청으로 시작합니다.

```bash
curl -sS https://api.beatapi.io/v1/capabilities/search \
  -H "Content-Type: application/json" \
  -d '{"query":"小红书 搜索笔记"}'
```

Search 응답의 `reference` 값을 Inspect 요청에 복사하세요. 아래 Inspect 요청은 `data:xiaohongshu.app_v2.search_notes`를 사용합니다. Search가 다른 reference를 반환하면 반환된 reference를 사용하세요.

```bash
curl -sS https://api.beatapi.io/v1/capabilities/inspect \
  -H "Content-Type: application/json" \
  -d '{"reference":"data:xiaohongshu.app_v2.search_notes"}'
```

## 결제 전 확인

Inspect 응답은 입력 스키마, 가격, 준비 상태, 다음 호출을 알려 줍니다. 준비 상태가 `ready` 또는 `runnable`일 때만 계속하세요. `listed` 상태의 기능은 실행할 수 없습니다. `next` 호출의 모든 자리표시자를 자신의 입력으로 바꾸세요.

## 한 페이지 가져오기

Inspect의 가격을 승인한 뒤 Inspect 응답에 있는 Run 호출을 API 키와 함께 보내세요. `data:xiaohongshu.app_v2.search_notes`의 Run 요청은 다음과 같습니다.

```bash
curl -sS https://api.beatapi.io/v1/capabilities/run \
  -H "Authorization: Bearer $BEATAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"reference":"data:xiaohongshu.app_v2.search_notes","input":{"keyword":"露营咖啡"},"view":"preview","max_items":5}'
```

위 Run 요청은 예시이며 기록된 결과가 아닙니다. 실제 응답의 필드를 읽으세요. `runnable` 기능도 고정된 출력 구조를 보장하지 않습니다.

## 결과 읽기

`preview` 보기는 원래 응답보다 항목이 적을 수 있습니다. 미리보기가 짧은 것은 플랫폼 페이지 나누기가 아닙니다. [AI에 결과가 몇 개만 보이는 이유는 무엇인가요?](/faq/social-data-preview)를 참고하세요.

## 요금과 범위

이 가이드는 Run으로 유료 검색을 한 번 시작하며, Search와 Inspect는 무료입니다. 현재 가격은 이 가이드의 고정 금액이 아니라 Inspect 응답에서 확인합니다. 검색 결과 한 페이지에 일치하는 노트가 모두 담긴다는 보장은 없으며, 검색 순위가 유지된다는 보장도 없습니다.

[Capabilities 계약](/capabilities) · [Social Data 계약](/social-data)