탐색으로 건너뛰기

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

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

준비

AI 클라이언트에 BeatAPI MCP를 연결하고 BeatAPI API 키를 준비하세요. Search와 Inspect 호출은 무료이고, Run 호출은 잔액을 사용합니다.

AI에 전달할 작업

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

기능 찾기

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

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를 사용하세요.

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 요청은 다음과 같습니다.

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에 결과가 몇 개만 보이는 이유는 무엇인가요?를 참고하세요.

요금과 범위

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

Capabilities 계약 · Social Data 계약