Xiaohongshu API, 공식 플랫폼·GitHub 스크립트·호출당 과금 중 무엇을 택할까

“xiaohongshu api”나 “rednote api”를 검색하는 사람 대부분은 다른 계정의 공개 게시물과 댓글을 원합니다. 2026년 11월 4일 기준 Xiaohongshu 공식 오픈 플랫폼은 이를 제공하지 않았습니다. 계정 플랫폼에서 사용할 수 있는 권한 범위(scope)는 basic_info 하나뿐이며, 필드는 닉네임, 프로필 사진, 성별, 지역 네 가지입니다. 노트를 읽을 수 있는 권한 범위는 여전히 “예정”으로 표시되어 있습니다(범위 목록). GitHub의 인기 오픈소스 스크래퍼 9개도 점검했습니다.

이 스크래퍼들에는 최근 90일 동안 새 이슈 92건이 올라왔고, 그중 31건이 로그인 오류, 요청 차단, 페이지 변경을 보고합니다. 이어서 EveryInfra로 실제 유료 호출 9건을 실행했습니다. 호출당 비용은 $0.005556이었습니다. 검색 한 페이지에서 게시물 20개가 반환되어 게시물 1,000개당 $0.278입니다. 빈 결과와 잘못된 파라미터에는 비용이 들지 않습니다.

이 글은 Xiaohongshu 데이터를 얻는 세 가지 방법을 비교합니다. 첫째는 공식 오픈 플랫폼입니다. 둘째는 본인 계정으로 로그인해 실행하는 오픈소스 스크립트입니다. 셋째는 요청당 과금하는 서드파티 데이터 API입니다.

처음 두 방법은 공식 개발자 문서, GitHub 공개 데이터, 공개 이슈 등 공개 자료만 사용했습니다. 세 번째 방법은 저희 API인 EveryInfra를 사용했으며, 각 응답의 실제 과금액을 보고합니다. 다른 서드파티 서비스의 이름은 밝히지 않습니다. 서드파티 가격 비교 섹션에 공식을 정리해 두었으니, 어떤 가격표든 직접 환산할 수 있습니다.

결론부터: 각 경로로 할 수 있는 일과 없는 일

세 경로는 같은 데이터에 매긴 세 가지 가격이 아니며, 닿는 데이터 자체가 다릅니다. 공식 플랫폼은 본인 앱 로그인, 본인 스토어 주문, 본인 광고 보고서처럼 자기 자산을 위한 것입니다. 다른 사람의 게시물을 검색하거나 댓글을 읽는 엔드포인트는 없습니다.

GitHub 스크립트는 브라우저에서 보이는 대부분을 읽을 수 있습니다. 사용자 로그인으로 브라우저처럼 동작하기 때문입니다. 그래서 무엇을 얼마나 오래 읽을 수 있는지는 계정 상태와 그 주의 사이트 상황에 달려 있습니다. 호출당 과금 API는 같은 작업을 일반 HTTP 요청으로 바꿉니다. 요청마다 비용을 내며, 가져올 수 있는 데이터와 페이지당 행 수는 제공업체가 공개 카탈로그에 명시한 대로입니다.

사람들이 가장 많이 놓치는 것은 첫 번째 행입니다. 흔한 계획은 "먼저 공식 API를 신청하고, 거절당하면 그때 다른 방법을 찾는다"입니다. 하지만 현재 공개 콘텐츠 관련 스코프인 user_profile, read_notes, read_followers는 모두 닫혀 있습니다. 앱이 승인되더라도 받을 수 있는 것은 로그인한 사용자의 닉네임과 프로필 사진뿐입니다. 다음 섹션에서는 각 경로를 살펴보며, 주장마다 원문이나 테스트 데이터를 함께 제시합니다.

Xiaohongshu 공식 API가 있을까? 창구 네 곳, 용도도 네 가지

있습니다. 그것도 하나가 아니며, 창구마다 맡는 용도가 다릅니다. 2026년 11월 4일 Xiaohongshu의 공개 개발자 사이트를 모두 열어 보고, 사이트마다 대상, 이용 조건, 얻을 수 있는 데이터를 정리했습니다.

계정 플랫폼은 가장 최근에 열린 창구입니다. 홈페이지에서는 표준 OAuth 2.0으로 앱에 Xiaohongshu 로그인을 제공한다고 설명합니다(개발자 포털). 빠른 시작 가이드에 따르면 새 앱은 심사에 약 1~3영업일이 걸립니다. 또한 현재 열려 있는 스코프는 basic_info뿐이라고 밝힙니다(빠른 시작). 스코프 페이지에는 스코프 5개가 나와 있습니다.

상태가 “open”인 스코프는 basic_info뿐입니다. 나머지 4개는 “planned”이며, write_notes에는 수동 심사가 필요하고 특수한 경우에만 열린다는 설명도 붙어 있습니다(스코프 목록). API 레퍼런스에는 엔드포인트 11개가 있으며 모두 토큰과 로그인에 관한 것입니다. 상태 확인, 토큰 발급 및 갱신, 기본 사용자 정보 조회, 접근 권한 철회, 차량 화면과 웹 페이지용 QR 로그인을 처리합니다. 이 페이지는 2026년 8월 19일에 마지막으로 업데이트되었으며, 리프레시 토큰의 유효 기간을 180일로 명시합니다(API 레퍼런스).

이커머스 오픈 플랫폼은 스토어 운영자에게 익숙한 창구입니다. 개발자 역할은 두 가지입니다. 소프트웨어 벤더는 여러 Xiaohongshu 스토어를 위한 주문, 상품, ERP 도구를 만들어 서비스 마켓에 앱을 등록합니다. 자체 구축 개발자는 자사 스토어 전용 도구만 만듭니다. 진입 조건은 까다롭습니다. 벤더는 중국 본토에 등록된 지 1년이 넘은 법인이어야 하며, 사업 범위에 기술 개발 또는 기술 서비스가 포함되어야 합니다.

개인 스토어는 자체 구축 개발자로 등록할 수 없습니다(개발자 역할 가이드, 플랫폼 문서의 서드파티 미러). 권한 부여 가이드에 따르면 스토어 메인 계정만 앱에 권한을 부여할 수 있습니다. 인가 코드는 10분, 액세스 토큰은 7일, 리프레시 토큰은 14일 동안 유효합니다(벤더용 권한 부여 흐름).

모든 비즈니스 호출은 하나의 게이트웨이 주소로 전송됩니다. 각 호출에는 appId, timestamp, version, method, 앱 시크릿으로 만든 MD5 서명이 붙습니다(서명 방식). 이 창구는 스토어를 자사 시스템에 연결합니다. 데이터 범위는 권한을 부여한 스토어로 한정됩니다.

토큰 규칙을 보면 각 창구가 얼마나 좁은지 알 수 있습니다. 공개된 유효 기간을 나란히 정리했습니다:

세 번째 창구는 광고 마케팅 API입니다. 시작 가이드에 따르면 이 API는 이미 플랫폼에서 광고를 집행하고 있고 API 사용 경험이 있는 주요 업종 고객을 위한 것입니다. 개발자 등록은 플랫폼 영업 담당자가 시작합니다(Marketing API 시작 가이드). 자사 광고 계정의 리포트와 캠페인 관리 기능을 제공하며, 오가닉 게시물은 다루지 않습니다.

네 번째 창구는 공유 플랫폼으로, 다른 앱에 “원탭 공유”와 “빠른 게시” 기능을 제공했습니다(공유 플랫폼). 2025년 11월 한 개발자는 이 페이지에 가입 버튼이 없고 중단 상태로 표시된다는 글을 올렸습니다(포럼 게시물). 2026년 11월 4일에 저희가 접속했을 때도 가입 경로는 여전히 없었습니다. Xiaohongshu 안에서 실행되는 앱을 위한 미니 프로그램 플랫폼도 있지만(미니 프로그램 플랫폼), 이 역시 커뮤니티 콘텐츠를 읽지 않습니다.

공식 플랫폼이 제공하지 않는 것

네 창구를 함께 보면 결론은 간단합니다. 공식 API는 내부 연동용입니다. 본인 계정, 자사 스토어, 자사 광고만 다룹니다. 네 창구 중 어디에도 모든 게시물을 검색하거나, 임의의 댓글을 읽거나, 공개 프로필을 조회하는 서드파티용 엔드포인트는 문서화되어 있지 않습니다. 스코프 페이지에서 read_notes와 read_followers는 여전히 “planned” 상태입니다.

중국 본토 외 지역의 독자에게는 문서가 하나 더 있습니다. 중국 본토 외 지역에서 가입한 사용자는 RedNote 사용자입니다. 이들은 2026년 6월 9일부터 시행된 RedNote 약관을 따르며, 운영 주체는 Rednote Technology Pte. Ltd.입니다(RedNote Terms of Service). 두 약관이 자동화된 데이터 조회에 대해 무엇을 규정하는지는 아래 컴플라이언스 섹션에서 다룹니다.

따라서 “rednote api”라는 질문의 답은 “xiaohongshu api”라는 질문의 답과 같습니다. 어느 쪽에도 공개 콘텐츠 조회용 공식 API는 없습니다.

결국 “xiaohongshu api”라는 검색어 뒤에는 서로 다른 두 가지 수요가 있습니다. 자사 앱의 로그인, 자사 스토어 연동, 자사 광고 계정의 리포트가 필요하다면 공식 창구를 이용하세요. 여기까지만 읽으셔도 됩니다. 경쟁사 추적, 브랜드 모니터링, 상품 조사, 콘텐츠 트렌드 분석이 필요하다면 현재로서는 공식 창구가 도움이 되지 않습니다. 선택지는 스크립트 또는 서드파티 API입니다.

두 방법 모두 법적 한계를 명확히 이해해야 하며, 이는 아래 컴플라이언스 섹션에서 다룹니다. 크리에이터 마켓플레이스 API에 대한 질문도 자주 나옵니다. 중국 포럼의 한 개발자는 본인 쿠키로 해당 페이지의 엔드포인트를 호출할 수 있다고 했습니다. 같은 스레드의 다른 개발자는 처음 몇 개의 선별된 댓글만 반환되었고 페이지네이션은 작동하지 않았다고 말했습니다(포럼 스레드). 이 방법도 페이지 엔드포인트에 본인 로그인을 사용하므로, 다음 섹션에서 다루는 스크립트 방식에 해당합니다.

GitHub의 Xiaohongshu API: 인기 저장소 9개를 직접 측정한 결과

오픈소스 스크립트는 무료이고 코드를 직접 읽을 수 있어서 많은 개발자가 가장 먼저 선택합니다. “스크립트는 자주 깨진다”는 말을 기억에 의존해 쓰고 싶지 않았기에, 2026년 11월 4일 00:19:50(싱가포르 시간)에 GitHub API로 GitHub를 표본 조사했습니다. 규칙은 간단했습니다. GitHub에서 xiaohongshu, xhs spider, 앱의 중국어 이름으로 검색했습니다. 검색어별로 스타 수 상위 30개 결과를 가져와 중복을 제거했습니다.

그다음 데이터 수집이 주목적인 저장소만 남겼습니다. 크롤러, 요청 래퍼, MCP 서버, 명령줄 도구, 다운로더가 여기에 해당합니다. 게시물 발행, 이미지 생성, 여러 사이트의 동영상 다운로드만 하는 도구는 제외했습니다. 9개 저장소가 남았습니다. “90일간 이슈”는 2026년 8월 6일부터 11월 4일까지 등록된 이슈이며, 풀 리퀘스트는 제외했습니다(GitHub issues API).

각 이슈의 제목을 읽고 직접 네 그룹으로 분류했습니다. 첫 번째 그룹은 로그인, 쿠키, QR 코드 또는 세션 오류입니다(10건). 두 번째 그룹은 인증 절차, 검색 제한 또는 요청 차단입니다(3건). 세 번째 그룹은 페이지나 엔드포인트가 바뀐 뒤 읽기, 파싱 또는 자동화 단계가 실패하거나 시간 초과된 경우입니다(18건).

나머지 61건은 기능 요청, 설치 문제, 보안 공지, 홍보 글, 또는 내용이 불분명한 제목입니다. 제목만으로는 잘못 판단할 수 있습니다. 예를 들어 제목이 “문제” 한 단어뿐인 이슈 3건은 “기타” 그룹으로 분류했습니다. 따라서 31건은 하한값입니다.

이 수치가 활발한 프로젝트가 나쁘다는 뜻은 아닙니다. 오히려 사용자가 많고 메인테이너가 활발하게 활동하기 때문에 이슈가 많이 등록됩니다. xiaohongshu-mcp는 30일간 커밋이 35개였습니다. 최근 이슈로는 “로그인할 수 없음”(#880, 10월 23일)과 “검색이 제한되지만 모바일 앱에서는 작동함”(#877, 10월 21일)이 있습니다. 한 사용자는 플랫폼이 이 도구를 허용하는지 직접 물었습니다.

같은 사용자는 이 도구 때문에 자신의 게시물 노출이 줄어들 수 있는지도 물었습니다(#878, 10월 22일). XHS-Downloader 이슈 #497(10월 17일)은 전형적인 페이지 변경 사례입니다. 웹 페이지의 서버 측 데이터가 새 문법을 쓰기 시작하자 파서가 멈췄습니다. 같은 저장소의 #479는 사이트의 방어 장치가 작동하지 않도록 크롤링 속도를 늦추는 설정을 요청합니다. Spider_XHS 이슈 #191(10월 10일)의 제목은 그저 “쿠키가 유효하지 않거나 만료됨”입니다.

또 다른 위험은 아무도 관리하지 않는 프로젝트입니다. ReaJason/xhs는 Xiaohongshu 웹사이트용 요청 래퍼입니다. 마지막 커밋은 2025년 7월 1일로, 490일 전입니다. xiaohongshu-cli는 2026년 3월 21일 이후 멈춰 있습니다. 새 이슈가 없다고 해서 코드가 작동한다는 뜻은 아닙니다.

사용자가 떠났다는 뜻일 수도 있습니다. 매일 실행할 작업에 쓸 스크립트를 고르기 전에 세 가지를 확인하세요. 마지막 커밋 날짜를 봅니다. 지난달 이슈에서 로그인, 만료, 파싱 오류를 확인합니다. 메인테이너가 얼마나 빨리 답하는지 살펴봅니다.

스크립트의 실제 비용: 로그인, 서명, RedNote 계정 체계 분리, 라이선스

첫 번째 비용은 로그인입니다. 인기 스크립트는 거의 모두 로그인 후 쿠키를 저장하라고 요구합니다. xiaohongshu-mcp README는 한 계정이 여러 웹 클라이언트에서 동시에 로그인 상태를 유지할 수 없다고 굵은 글씨로 안내합니다. 다른 웹 클라이언트에서 로그인하면 도구가 로그아웃됩니다. 작성자는 실명 인증을 하지 않은 신규 계정에서는 인증 절차가 표시된다고도 경고합니다(xiaohongshu-mcp README).

xiaohongshu-cli의 한 사용자는 #82에서 이 도구가 7일마다 다시 로그인하게 만든다고 불만을 제기했습니다. 로그인이 만료되면 예약 작업이 멈추고, 다음 리포트가 비어 있을 때에야 알게 되는 경우가 많습니다. 계정 자체도 위험합니다. 사용자 약관 2.3조는 계정을 소유자 본인만 사용할 수 있다고 규정합니다. 제3자에게 넘기는 것은 효력이 없으며, 플랫폼은 위험하다고 판단한 계정을 차단할 수 있습니다(사용자 약관). 스크립트를 실행하는 계정은 언제든 잃을 수 있다고 생각하세요.

두 번째 비용은 요청 서명입니다. Xiaohongshu 웹 엔드포인트로 보내는 요청에는 x-s, x-s-common 같은 서명 헤더가 붙습니다. 일부 엔드포인트에는 안티봇 헤더가 하나 더 필요합니다. 이 작업만 전담하는 저장소도 있습니다. xhshow README에 따르면 이 도구는 x-s, x-s-common, x-rap-param 헤더를 생성합니다. 피드, 검색, 게시 엔드포인트에는 x-rap-param 헤더가 추가로 필요하다고 덧붙입니다(Cloxl/xhshow).

MediaCrawler는 다른 방식을 씁니다. Playwright 브라우저에 로그인 상태를 유지하고, 그 브라우저에서 JavaScript를 실행해 서명 값을 얻습니다. README에 따르면 탐지 위험을 낮추기 위해 사용자가 이미 쓰고 있는 Chrome에 연결합니다(MediaCrawler README). 두 방식에는 공통된 약점이 있습니다. 서명 방식이 바뀌면 이에 의존하는 모든 스크립트가 동시에 멈춥니다. 앞서 본 오작동 이슈 18건의 원인 중 하나가 이것입니다.

세 번째 비용은 중국 외 지역 독자에게 가장 중요한 RedNote 계정 체계 분리 문제입니다. xiaohongshu-mcp의 이슈 #579가 이를 설명합니다. 2025년 12월 8일 이후 중국 외 전화번호로 가입한 사용자는 RedNote 사용자입니다. 이들의 웹 세션은 rednote.com으로 연결되고, 쿠키는 .rednote.com 도메인을 사용합니다.

xiaohongshu.com 쿠키만 읽는 스크립트는 계속 “로그인되지 않음”이라고 표시합니다. 이는 중국 본토 사용자와 RedNote 사용자에게 서로 다른 약관을 적용하는 사용자 약관 내용과도 일치합니다. 싱가포르, 런던, 뉴욕의 팀이 2026년에 현지 전화번호로 계정을 만들었다면 많은 튜토리얼이 작동하지 않을 수 있습니다.

두 계정 유형은 서로 다른 규칙을 따릅니다. 다음 표는 이슈와 두 약관에서 확인한 사실을 정리한 것입니다:

네 번째 비용은 라이선스이며, 많은 사람이 이 부분을 놓칩니다. MediaCrawler의 라이선스는 “NON-COMMERCIAL LEARNING LICENSE 1.1”입니다. 이 라이선스는 소프트웨어를 학습과 연구 목적으로만 사용할 수 있다고 규정합니다. 대규모 크롤링이나 플랫폼 운영 방해에 사용해서는 안 됩니다. 상업적으로 사용하려면 저작권자의 서면 동의가 필요합니다(MediaCrawler 라이선스).

Spider_XHS와 xiaohongshu-cli는 GitHub에 라이선스를 명시하지 않았습니다. GitHub는 라이선스가 없으면 작성자가 모든 권리를 보유한다고 설명합니다. 다른 사람에게는 코드를 사용, 수정, 공유할 권한이 없습니다(라이선스에 관한 GitHub 문서). 이 코드를 제품이나 고객 납품물에 넣는 회사는 법무팀을 설득하기 어려울 것입니다.

호출 단위로 과금하는 Xiaohongshu 스크래핑 API: 직접 테스트한 결과

세 번째 방법은 요청당 과금하는 데이터 API입니다. HTTP 요청을 보내면 제공업체가 구조화된 데이터 한 페이지를 돌려주고, 요청마다 비용을 지불합니다. 2026년 11월 4일 싱가포르 시간 00:14부터 00:20까지 EveryInfra로 실제 호출을 실행했습니다. Xiaohongshu 액션 6개를 유료로 9회 호출했습니다. 요청 3건은 의도적으로 실패시켰습니다. 그 밖에 요청 4건이 요청 속도 제한(429)에 걸렸고, 다시 보내자 성공했습니다.

먼저 무료 카탈로그에서 파라미터와 가격을 확인했습니다(카탈로그, 싱가포르 시간 00:13 조회). Xiaohongshu 액션은 17개입니다. 그중 16개는 호출당 $0.005556이고, 크리에이터 마케팅용 랭킹 목록 1개는 $0.016입니다. 검색, 사용자 게시물, 상품 검색은 페이지당 20행, 댓글은 15행, 답글은 10행을 반환합니다. 페이지 토큰은 24시간 동안 유효합니다.

9회 호출의 총비용은 $0.061115이며, 과금 단위는 11건입니다(게시물 3개 배치는 3건으로 계산).

과금액은 카탈로그의 페이지 크기가 아니라 실제로 반환된 행 수로 나눴습니다. 그래서 19행을 반환한 호출은 행당 비용이 조금 더 높습니다. 가장 큰 차이는 게시물 상세에서 나타납니다. 검색과 같은 $0.005556이지만, 검색은 게시물 20개를 반환하고 상세 호출은 1개를 반환합니다. 행당으로 보면 상세가 20배 비쌉니다. 대량 분석에는 검색 결과에 이미 포함된 필드(제목, 본문 일부, 좋아요, 저장 수, 댓글 수, 날짜, 작성자)를 사용하고, 더 필요할 때만 상세 액션을 호출하세요.

중국 외 지역 독자라면 영어 키워드 테스트를 자세히 볼 필요가 있습니다. 다른 필터 없이 “Singapore food”를 검색했습니다. 게시물 19개가 반환되었지만 제목에 영어 단어가 들어간 것은 4개뿐이었습니다. 나머지는 중국어였는데, 플랫폼이 영어 검색어를 같은 주제의 중국어 콘텐츠와 매칭한다는 뜻입니다. 19개 중 작성된 지 30일이 안 된 게시물은 3개뿐이었고, 게시물 경과 일수의 중앙값은 242일이었습니다.

기본 정렬이 관련도순이어서 꾸준히 읽히는 가이드가 상위에 오르기 때문입니다. 댓글이 가장 많은(412개) 게시물은 2025년 9월에 올라온 비싼 식사에 대한 불만 글이었습니다. 2026년 1월에 올라온 저렴한 두리안 게시물에는 댓글이 80개 달렸습니다. 이번 주의 주제 동향을 보려면 sort를 newest로 설정하거나 date_range를 추가하세요. 그렇지 않으면 대부분 오래된 가이드를 읽게 됩니다.

두 키워드의 결과는 크게 다릅니다. 두 검색 모두 기본 정렬을 사용했습니다:

테스트에서 네 가지를 더 확인했습니다. 첫째, 페이지네이션은 실제로 다음 결과로 넘어갑니다. 2페이지에는 1페이지와 겹치는 게시물이 없었습니다. 게시물 40개 중 21개는 작성 30일 이내, 12개는 7일 이내였고, 가장 오래된 게시물은 231일 전에 작성되었습니다. 둘째, 상세 호출은 게시물을 실시간으로 다시 읽습니다. 검색 결과에서 댓글이 231개로 표시된 게시물이 2초 뒤 상세 호출에서는 232개였습니다. 상세 호출은 IP 지역, 토픽 태그 8개, 이미지 10개 목록도 추가로 제공합니다.

셋째, 답글은 별도로 호출해야 합니다. 1페이지의 상위 댓글 15개에는 답글 53개가 있다고 표시되었지만, 댓글마다 인라인으로 포함된 답글은 1개뿐이었습니다. 전체 스레드가 필요하면 xiaohongshu/sub_comments를 호출하세요. 넷째, comments_batch는 게시물 단위로 과금됩니다. 게시물 3개는 $0.005556의 3배이므로 댓글당 가격은 단일 호출과 같습니다. 배치로 아낄 수 있는 것은 비용이 아니라 요청 수와 요청 속도 제한 여유입니다.

연결 방법: curl, 응답 필드, MCP

가장 간단한 연결 방법은 POST 요청 하나입니다. 다음은 표에 있던 영어 키워드 검색입니다. API 키는 코드가 아니라 환경 변수에 보관하세요:

curl -s https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"xiaohongshu","action":"search","params":{"keyword":"Singapore food","sort":"newest","date_range":"last_7_days"}}'
# Next page: copy next_page_token into params.page_token. For slow jobs add "mode":"async" and poll the job_id.

응답 필드는 카탈로그의 response_fields 목록과 일치합니다. 다음 표는 저희가 사용한 필드 그룹과 테스트에서 확인한 내용입니다:

AI 클라이언트에서는 EveryInfra를 원격 MCP 서버로 사용할 수 있습니다. MCP(Model Context Protocol)는 AI 클라이언트가 외부 도구를 호출할 수 있게 해 주는 개방형 프로토콜입니다(명세). 모든 도구 이름은 everyinfra_로 시작합니다. 클라이언트에 다음 블록을 추가하면 바로 시작할 수 있습니다:

{
  "mcpServers": {
    "everyinfra": {
      "url": "https://api.everyinfra.com/mcp",
      "headers": { "Authorization": "Bearer ${env:EVERYINFRA_API_KEY}" }
    }
  }
}

그다음에는 자연어로 다음과 같이 요청할 수 있습니다. “Xiaohongshu에서 최근 7일간 올라온 싱가포르 호커 음식 관련 게시물을 검색해 줘. 댓글이 20개 넘는 게시물만 남기고 각각 댓글 1페이지씩 가져와. 사람들이 불만을 제기한 음식을 정리해 줘.” 액션 페이지와 플레이그라운드는 Xiaohongshu 데이터 API와 검색에 있습니다. MCP 설정 점검 항목은 원격 MCP 설정에서, Xiaohongshu 도구 목록은 Xiaohongshu MCP에서 확인할 수 있습니다.

실패, 빈 결과, 요청 속도 제한: 무엇이 무료일까

호출당 과금에서 가장 걱정되는 것은 얻는 것 없이 비용만 내는 일입니다. 요청 3건(빈 결과, 잘못된 파라미터, API 키 없음)을 의도적으로 실패시켰습니다. 그 밖에 요청 4건이 요청 속도 제한(429)에 걸렸습니다. 7건 모두 과금되지 않았습니다:

빈 결과는 29초가 걸렸습니다. 응답에는 count 0과 reason empty_result_refunded가 표시되었고, 과금되지 않았습니다. 422 오류는 허용값을 나열해 주므로 AI 모델이 API를 호출할 때 유용합니다.

모델이 did_you_mean을 읽고 스스로 요청을 수정합니다.

요청 속도 제한은 계정 단위로 적용되며 계정의 모든 키가 이를 공유하므로, 키를 늘려도 여유가 늘어나지 않습니다. 계정 한도는 누적 충전 금액에 따라 달라집니다(요금).

429 응답 4건은 의도한 것이 아니었습니다. 테스트 키에는 분당 10회라는 자체 상한이 있었습니다. 00:14:59부터 00:15:48까지 저희가 직접 보낸 호출은 4건뿐이었으므로, 같은 시간에 다른 테스트도 같은 키를 사용하고 있었던 것입니다.

429 응답에는 모두 “Nothing was charged”라는 메시지와 5~17초의 retry_after가 담겨 있었습니다. 77~147초 뒤 네 요청을 다시 보냈고, 네 건 모두 정상 가격인 $0.005556으로 성공했습니다. 예약 작업에서는 retry_after만큼 기다린 뒤 재시도하고, 실행마다 대기 시간을 확보해 두세요. 과금과 환불을 대조하는 전체 방법은 실패 환불 대조를 참고하세요.

Xiaohongshu API 요금은 TikTok의 10배, 예산은 따로 잡아야 합니다

솔직히 말씀드리면, 저희 카탈로그에서 가장 비싼 소셜 플랫폼은 Xiaohongshu입니다. 플랫폼별로 이용 가능한 모든 액션의 가격 중앙값을 구했습니다. Xiaohongshu는 호출당 $0.005556입니다.

TikTok, YouTube, Instagram, Bilibili, Reddit은 $0.000556으로 정확히 10분의 1입니다. Douyin, Kuaishou, Weibo, Zhihu, X는 $0.000806이므로 Xiaohongshu가 6.9배 비쌉니다. Taobao와 JD는 $0.001389이므로 Xiaohongshu가 4배 비쌉니다. Xiaohongshu보다 약간 비싼 곳은 중앙값 $0.006875인 Amazon뿐입니다.

Xiaohongshu의 카탈로그 가격은 다른 플랫폼의 4~10배입니다. 최신 가격은 요금 페이지에서 확인할 수 있습니다. 예산으로 환산하면 월 $10로 Xiaohongshu는 $0.005556 기준 약 1,800회, TikTok은 중앙값 $0.000556 기준 약 18,000회 호출할 수 있습니다.

즉 같은 예산으로 보낼 수 있는 Xiaohongshu 요청은 TikTok 요청의 약 10분의 1입니다. 한 프로젝트에서 두 플랫폼을 함께 다룬다면 단가를 하나로 잡지 마세요. TikTok 가격은 TikTok 데이터 API 페이지에서 따로 확인할 수 있습니다. 또한 다음 섹션에서 다룰 호출 줄이는 방법이 다른 플랫폼보다 여기서 더 중요하다는 뜻이기도 합니다.

호출을 줄이는 방법: 다섯 가지 습관과 한 달 비용 계산

첫째, 상세보다 목록을 먼저 활용하세요. 검색과 사용자 게시물은 페이지당 20행을 반환하며 제목, 본문 일부, 좋아요, 저장 수, 댓글 수, 날짜, 링크가 포함됩니다. 대부분의 정렬과 필터링은 이것만으로 충분합니다.

xiaohongshu/note는 IP 지역, 토픽 태그, 전체 본문이 필요할 때만 호출하세요. 상세 행 하나의 비용은 목록 행의 20배입니다. 둘째, 댓글을 가져오기 전에 댓글 수를 확인하세요. 게시물 40개 표본에서 댓글 수 중앙값은 14개였고, 20개 이상인 게시물은 18개뿐이었습니다.

댓글이 0개인 게시물의 댓글을 가져오면 빈 결과가 나옵니다. 과금은 없지만 요청 속도 제한 할당량 1회를 소모합니다. 셋째, 전체를 다시 가져오는 대신 시간 필터를 쓰세요. 매일 실행하는 작업이라면 sort를 newest로, date_range를 last_24_hours 또는 last_7_days로 설정해 새 게시물만 처리할 수 있습니다.

넷째, 답글 스레드는 필요할 때만 여세요. sub_comment_count로 각 댓글의 답글 수를 이미 알 수 있으므로, 답글이 많은 댓글만 펼치면 됩니다. 다섯째, 업무에 필요한 빈도로만 작업을 실행하세요. 경쟁사 리포트는 대부분 주 1회로 충분합니다.

이 표는 카탈로그 가격 $0.005556을 기준으로 합니다. 댓글 20개 이상인 게시물 비율(40개 중 18개)은 저희 표본에서 나온 값입니다. 청구 금액이 아니라 추정치입니다.

키워드에 따라 이 비율은 달라집니다. 같은 모니터링 작업의 월 비용이 $70.01에서 $4.44로 15.8분의 1이 됩니다. 절감 효과는 단가 인하가 아니라 호출 수 감소에서 나옵니다. 여기서는 호출당 과금이 유리합니다. 모든 호출이 드러나므로 각 절감 조치로 얼마를 아낄 수 있는지 미리 계산할 수 있습니다.

두 번째 습관을 검색에서 얻은 선크림 게시물 40개로 더 자세히 살펴보겠습니다. 40개 게시물의 댓글은 모두 1,177개였습니다. 11개는 댓글이 0개였고, 18개는 20개 이상이었으며, 댓글이 가장 많은 게시물에는 231개가 달렸습니다. 다음 표는 카탈로그 가격인 페이지당 $0.005556과 페이지당 댓글 15개를 기준으로 합니다:

마지막 행은 댓글 1,000개당 $0.444입니다. 첫 페이지의 $0.370보다 높은데, 게시물의 마지막 페이지는 꽉 차지 않는 경우가 많기 때문입니다.

그러니 먼저 모든 댓글이 정말 필요한지 판단하세요. 의견 태깅에는 게시물마다 상위 댓글 15개면 충분한 경우가 많습니다. 브랜드를 언급한 댓글의 비율처럼 전체 댓글 기준의 비율이 필요할 때만 모든 페이지를 가져오세요. 게시물 하나도 같은 방식으로 추정할 수 있습니다. 상세 호출에서 확인한 댓글 232개짜리 게시물은 16페이지, 즉 $0.0889가 듭니다.

답글도 같은 방식입니다. 한 페이지의 상위 댓글 15개에 표시된 답글 수는 53개였고, 각 댓글에는 이미 답글 1개가 인라인으로 포함되어 있었습니다. 나머지 답글을 모두 xiaohongshu/sub_comments로 페이지당 10행씩 열려면 14회 호출, 즉 $0.0778이 듭니다. 답글이 5개 이상인 댓글 4개만 열면 4회 호출, 즉 $0.0222입니다. 비용은 70% 이상 줄고, 가장 활발한 스레드는 그대로 확보할 수 있습니다.

마지막으로 시간을 고려하세요. 테스트에 사용한 키는 분당 10회 호출을 허용합니다. 이 속도라면 모든 게시물의 댓글을 가져오는 일간 계획은 하루 420회 호출이 필요하고, 대기열에서 42분이 걸립니다. 활발한 게시물의 댓글만 가져오는 주간 계획은 실행당 200회 호출, 즉 20분입니다. 계정 한도는 누적 충전 금액에 따라 달라지므로 요금 페이지를 확인하세요. 한도와 관계없이 호출이 적을수록 대기 시간이 줄고 요청 속도 제한 오류도 줄어듭니다.

서드파티 가격 비교법: 공식 하나와 질문 여섯 가지

많은 서드파티 서비스가 요청당 과금하지만 가격 표기 방식은 제각각입니다. 호출당, 행당, 크레딧당으로 과금하는 곳이 있고, 월 요금이나 초기 요금을 추가하는 곳도 있습니다. 비교할 때는 공식 하나를 쓰세요. 1,000행당 가격 = 요청당 가격 ÷ 요청당 실제 반환 행 수 × 1,000.

가상의 예를 들어 보겠습니다. 호출당 $0.01을 받고 10행을 반환하는 서비스는 1,000행당 $1.00입니다. 같은 $0.01에 20행을 반환하면 $0.50입니다. 따라서 "호출당 가격"만으로는 알 수 있는 것이 많지 않습니다. 페이지당 몇 행이 반환되는지 묻고, 가능하면 직접 한 번 호출해 세어 보세요. 이 공식으로 계산하면 EveryInfra의 Xiaohongshu 검색은 게시물 1,000개당 $0.278, 댓글은 1,000개당 $0.370입니다.

사람들이 흔히 건너뛰는 것은 두 번째, 세 번째, 네 번째 행입니다. 드문 키워드를 쓰거나 AI 클라이언트가 가끔 잘못된 파라미터를 보내면 실패 비용이 월 청구액의 일부가 됩니다. 테스트에서 데이터를 반환하지 않은 요청 7건(계획된 실패 3건, 요청 속도 제한 4건)은 모두 $0이었습니다. 이 항목들을 확인한 뒤 직접 한 번 호출해 행 수를 세어 보세요. 가격과 규칙은 요금 페이지에 있습니다.

컴플라이언스 기본: 데이터 사용자가 알아야 할 법률, 플랫폼 약관, 실무 원칙

이 글은 법률 자문이 아닙니다. 법률과 플랫폼 약관의 주요 내용을 정리한 것이며, 실제 사용 방식은 변호사와 상의하세요. 중국에는 Xiaohongshu 데이터와 직접 관련된 규정이 세 가지 있습니다.

개인정보보호법 제27조는 공개된 개인정보를 다룹니다. 정보 주체가 스스로 공개했거나 이미 합법적으로 공개된 정보는 "합리적인 범위 내에서" 처리할 수 있습니다. 정보 주체가 명확히 거부한 경우에는 이 조항이 적용되지 않습니다. 처리가 정보 주체에게 중대한 영향을 미치는 경우에는 동의를 받아야 합니다(개인정보보호법).

네트워크 데이터 보안 관리 조례 제18조는 네트워크 데이터에 접근하거나 이를 수집하는 자동화 도구를 다룹니다. 이런 도구를 사용하는 자는 네트워크 서비스에 미치는 영향을 평가해야 합니다. 다른 네트워크에 침입하거나 서비스의 정상 운영을 방해해서는 안 됩니다(조례 원문). 이 조례는 2025년 1월 1일부터 시행 중입니다(중국 사법부).

2025년에 개정된 반부정당경쟁법은 제13조 제3항을 신설했습니다. 이 조항에 따르면 사업자는 사기나 강압으로 다른 사업자가 합법적으로 보유한 데이터를 취득하거나 사용해서는 안 됩니다. 이를 위해 기술적 통제를 우회하거나 무력화해서도 안 됩니다. 개정법은 2025년 10월 15일 시행되었습니다(반부정당경쟁법(2025)).

플랫폼 약관 두 가지도 적용됩니다. Xiaohongshu 이용자 약관은 2026년 3월 23일 개정되었습니다. 제3.4조와 제4.1조는 서면 허가 없이 플랫폼 콘텐츠를 열람·집계하거나 상업적으로 이용하는 행위를 제한합니다. 스크래핑과 다운로드를 모방하는 행위도 제한합니다.

제2.3조는 계정을 타인에게 빌려주는 행위도 제한합니다(이용자 약관). 중국 본토 외 이용자는 2026년 6월 9일부터 RedNote 약관을 따릅니다. 이 약관도 데이터의 자동 추출을 제한합니다(RedNote 서비스 약관). 귀사의 사용 방식이 이러한 제한에 해당하는지는 변호사와 상의하세요.

중국 법원은 플랫폼 데이터를 허가 없이 대규모로 수집해 재판매한 사건에서 손해배상을 인정한 바 있습니다. 법원은 대체로 네 가지를 따집니다. 수집자가 기술적 통제를 회피하거나 무력화했는가? 흩어진 레코드가 재판매용 대규모 데이터 모음이 되었는가? 개인정보나 비공개 기능에 접근했는가? 플랫폼의 정상 운영에 피해가 있었는가?

어떤 방식을 선택하든 데이터 사용자는 최소한 다음 원칙을 지켜야 합니다.

• 브랜드 리스닝이나 제품 조사처럼 합법적이고 명확한 목적으로만 데이터를 사용하세요. 목적을 문서로 남기고, 목적을 바꾸기 전에 다시 검토하세요.
• 플랫폼 약관과 업무를 수행하는 지역의 법률을 따르세요. 상업적 재판매나 콘텐츠 대량 다운로드처럼 약관이 제한하는 용도라면 먼저 변호사와 상의하세요.
• 개인정보는 최소한으로만 보관하세요. 댓글의 닉네임, 프로필 사진, IP 지역은 개인정보로 취급하세요. 분석에 쓰지 않는 필드는 저장하지 마세요. 가능하면 개별 행 대신 집계값을 보관하세요. 데이터 보관 기간과 그 이유를 기록하세요.
• 원시 데이터를 재판매하지 마세요. 고객에게는 원시 행 묶음이 아니라 분석 결과와 요약 표를 제공하고, 원시 행을 공개하지 마세요.
• 분석에 필요한 것만 가져오고, 오래된 원시 데이터는 정해진 일정에 따라 삭제하세요.
• 비공개 메시지, 비공개 계정 등 공개되지 않은 콘텐츠에는 손대지 마세요. 데이터를 이용해 사용자에게 대량 메시지를 보내지 마세요.

이 원칙들은 "호출을 줄이는 방법" 섹션의 습관과 방향이 같습니다. 분석에 쓰는 것만 가져오면 비용이 줄고, 저장하고 보호해야 할 데이터도 줄어듭니다.

작업별로 어떤 방식을 선택해야 할까

자체 앱을 만들면서 "Xiaohongshu로 로그인" 기능이 필요하다면 계정 플랫폼에서 basic_info를 신청하세요. 앱을 만들고 콜백 주소를 설정한 뒤 1~3영업일의 심사를 기다리면 됩니다. Xiaohongshu에서 판매하면서 주문과 애프터서비스를 ERP로 가져오려면 이커머스 오픈 플랫폼을 이용하세요. 개발자가 있다면 자체 개발 역할을 선택하고, 없다면 서비스 마켓에서 업체를 찾으세요. 광고를 집행하면서 보고서를 대량으로 받으려면 플랫폼 영업 담당자에게 Marketing API 개통을 요청하세요. 이 세 가지 작업에는 서드파티가 필요 없으며, 서드파티를 써서도 안 됩니다.

다른 사람이나 기업을 관찰하는 작업이라면 현재 공식 경로로는 할 수 없습니다. 경쟁사의 게시물 수와 참여도, 특정 주제에 대한 사용자 의견, 제품 추천, 플랫폼 내 브랜드 이미지 등이 여기에 해당합니다. 스크립트와 서드파티 API 중에서 선택할 수 있습니다. 소규모 작업, 비정기 작업, 학습 목적이라면 오픈소스 스크립트로 충분합니다. 잃어도 괜찮은 계정을 사용하고, 라이선스를 꼭 읽어 보세요. 매일 돌리는 작업, 고객 납품, 또는 AI 클라이언트가 스스로 데이터를 호출하는 경우에는 호출당 과금 API가 더 편합니다.

"호출을 줄이는 방법" 섹션의 습관으로 호출량을 줄이고, 컴플라이언스 섹션의 원칙을 따르세요. 이는 해외 브랜드에도 중요합니다. Inside Retail Asia는 2026년 10월 12일 보도에서 사람들이 이 앱을 검색 엔진처럼 사용한다고 전했습니다(Inside Retail Asia).

따라서 브랜드에는 보통 팔로워 수보다 키워드 조사가 더 많은 것을 알려 줍니다. 관련 글 두 편에서 더 자세히 다룹니다. Xiaohongshu 데이터 내보내기와 스냅샷 분석은 검색 및 댓글 데이터를 스냅샷으로 저장하는 방법을 보여 줍니다. Xiaohongshu 댓글 일괄 수집은 댓글을 일괄 수집하는 전체 절차를 안내합니다.

업계 동향: 2026년 10~11월

• 2026년 11월 3일: 샘플 수집 하루 전, MediaCrawler, xiaohongshu-mcp, XiaohongshuSkills 모두 새 커밋이 있었습니다. 최근 30일 커밋 수는 각각 11, 35, 32였습니다. ReaJason/xhs는 여전히 2025년 7월 1일에 멈춰 있었습니다(GitHub API, 2026년 11월 4일 싱가포르 시간 00:19:50 조회). 시사점: 활발한 도구는 계속 바뀌므로 함께 업데이트해야 합니다. 멈춘 도구는 예약 작업에 적합하지 않습니다.
• 2026년 10월 21~23일: 같은 주에 xiaohongshu-mcp에 "로그인 불가"와 "검색 제한" 이슈가 등록되었습니다. 11월 1일 메인테이너가 검색 대기와 게시 흐름 관련 수정을 병합했습니다. 11월 3일에는 로그인 실패 후 브라우저 정리 문제를 고친 수정이 이어졌습니다(커밋 기록). 시사점: 로그인에 의존하는 도구는 몇 주마다 수정이 필요하므로, 예약 작업에는 실패 알림이 필요합니다.
• 2026년 10월 17일: 사이트 웹 페이지의 서버 측 데이터 형식이 바뀌었습니다. 스타가 13,000개 이상인 다운로더 XHS-Downloader는 수정이 나올 때까지 게시물을 파싱하지 못했습니다(이슈 497). 시사점: 평범한 평일에 일어난 페이지 변경 하나로 그 페이지를 읽는 모든 스크립트가 멈출 수 있으므로 복구 시간을 계획해 두세요.
• 2026년 8월 19일: 계정 플랫폼 API 레퍼런스가 업데이트되었지만 여전히 basic_info만 열려 있습니다(API 레퍼런스). 시사점: 가까운 시일 내에 노트를 읽는 공식 API가 나온다는 전제로 계획하지 마세요.

시작하기: 테스트 호출 한 번에서 주간 작업까지

1단계: EveryInfra에 회원가입하고 API 키를 만드세요. 월 요금이 없고, 충전한 잔액은 만료되지 않습니다. 자세한 절차는 빠른 시작에 있습니다. 2단계: 무료 카탈로그를 확인하세요. 그런 다음 액션 페이지에서 호출을 한 번 시도하세요. 게시물 관련 페이지는 검색, 게시물 상세, 사용자 게시물입니다.

댓글 관련 페이지는 댓글, 일괄 댓글, 답글입니다. 상점 데이터에는 상품 검색을 사용하세요. 3단계: 응답의 charged_usd와 행 수를 확인하고 "과금액 ÷ 행 수 × 1,000"으로 1,000행당 가격을 직접 계산하세요. 그런 다음 "호출을 줄이는 방법" 섹션의 표로 한 달 비용을 추정하세요. 4단계: AI 클라이언트에 MCP 블록을 추가하고 매주 한 번 키워드를 실행하도록 요청하세요. 다른 플랫폼은 데이터 마켓에서, 서비스 상태는 상태 페이지에서 확인할 수 있습니다.

FAQ

Xiaohongshu에는 공식 API가 있나요?

이 질문은 "xiaohongshu api documentation", "rednote api documentation" 같은 검색 추천어에서 나왔습니다. 공식 API는 있지만 자체 데이터에만 사용할 수 있습니다. 계정 플랫폼은 basic_info(닉네임, 프로필 사진, 성별, 지역)만 제공합니다. 이커머스 플랫폼에서는 기업과 서비스 제공업체가 상점의 권한을 받아 해당 상점의 주문과 상품을 읽을 수 있습니다. 광고 API는 광고주에게 해당 광고주의 보고서를 제공합니다(scope 목록, 상점 권한 부여). 다른 사람의 공개 게시물이나 댓글을 읽는 공식 API는 없으며, read_notes는 여전히 "예정" 상태입니다.

Xiaohongshu API 키는 어떻게 받나요?

이 질문은 "xiaohongshu api key", "rednote api key" 추천어에서 나왔습니다. 단일한 공식 "API 키"는 없습니다. 계정 플랫폼에서는 앱을 만들고 app id와 app secret을 받습니다. 심사에는 1~3영업일 정도 걸립니다(빠른 시작).

이커머스 플랫폼에서는 인증된 기업이 appId와 appSecret을 받고, 이어서 상점 메인 계정이 권한을 부여해야 합니다. 광고 API는 영업 담당자가 등록 절차를 시작합니다. 공개 게시물을 읽는 키가 필요하다면 그것은 서드파티 서비스의 키입니다. EveryInfra에서는 회원가입 후 콘솔에서 만들 수 있습니다.

GitHub의 Xiaohongshu 스크레이퍼를 상용 제품에 써도 되나요?

이 질문은 "xiaohongshu api github" 추천어에서 나왔습니다. 라이선스를 확인하세요. 저희가 살펴본 샘플 9개 중 MediaCrawler의 라이선스는 비상업적 학습만 허용하고 대규모 크롤링을 금지합니다(라이선스).

Spider_XHS와 xiaohongshu-cli는 라이선스를 명시하지 않았으므로 저작자가 모든 권리를 보유합니다. xiaohongshu-mcp는 Apache-2.0, XHS-Downloader는 GPL-3.0을 사용합니다. 라이선스는 코드에만 적용되며, 그 코드로 수집한 데이터에는 적용되지 않습니다. 그 데이터에는 여전히 플랫폼 약관과 법률이 적용됩니다.

RedNote 계정으로 Xiaohongshu 스크립트를 쓸 수 있나요?

이 질문은 "rednote xiaohongshu api", "rednote api github" 추천어에서 나왔습니다. 안 되는 경우가 많습니다. xiaohongshu-mcp의 이슈 #579가 이 변화를 설명합니다.

2025년 12월 8일 이후 중국 외 전화번호로 가입한 계정은 RedNote 계정입니다. 이 계정의 웹 세션은 rednote.com으로 옮겨지고 쿠키 도메인도 바뀝니다. 그래서 xiaohongshu.com 쿠키만 읽는 스크립트는 "로그인되지 않음"을 보고합니다. RedNote 사용자는 별도 약관도 따르는데, 이 약관은 2026년 6월 9일 시행되었으며 자동 추출을 금지합니다(RedNote 약관).

Xiaohongshu API 요금은 보통 어떻게 책정되나요?

이 질문은 "xiaohongshu api pricing", "xiaohongshu api pricing reddit" 추천어에서 나왔습니다. 공식 경로에는 API 자체 요금이 명시되어 있지 않습니다. 서드파티 서비스는 보통 요청당, 행당, 크레딧당으로 과금하며 월 요금을 추가하는 곳도 있습니다. 비교하기 전에 가격 비교 섹션의 공식으로 모든 가격을 1,000행당 가격으로 환산하세요. EveryInfra는 Xiaohongshu 액션 17개 중 16개가 호출당 $0.005556입니다. 테스트 기준으로 검색 게시물 1,000개당 $0.278, 댓글 1,000개당 $0.370이었습니다(카탈로그).

참고 자료

1. “Developer portal home”, Xiaohongshu 오픈 플랫폼, 2026-11-04 열람. https://openaccount.xiaohongshu.com/
2. “Scope list”, Xiaohongshu 오픈 플랫폼, 최종 업데이트 2026-03-29, 스크린샷 2026-11-04. https://openaccount.xiaohongshu.com/docs/scope
3. “API reference”, Xiaohongshu 오픈 플랫폼, 최종 업데이트 2026-08-19. https://openaccount.xiaohongshu.com/docs/api-reference
4. “Quick start”, Xiaohongshu 오픈 플랫폼, 최종 업데이트 2026-03-29. https://openaccount.xiaohongshu.com/docs/quick-start
5. “Authorization flow for software vendors”, Xiaohongshu 이커머스 오픈 플랫폼. https://open.xiaohongshu.com/document/developer/file/38
6. “Signature method”, Xiaohongshu 이커머스 오픈 플랫폼. https://open.xiaohongshu.com/document/developer/file/39
7. “Developer document index”, Xiaohongshu 이커머스 오픈 플랫폼. https://open.xiaohongshu.com/document/developer/file/4
8. “Developer role guide”, 이커머스 플랫폼 문서의 서드파티 미러. https://xiaohongshu.apifox.cn/doc-2811119
9. “Marketing API getting started guide”, Xiaohongshu 광고 플랫폼, 2024-01-03 업데이트. https://ad.xiaohongshu.com/openApiDoc?categoryId=761&articleId=3047
10. “Share open platform home”, Xiaohongshu. https://agora.xiaohongshu.com/index
11. 공유 플랫폼 중단에 관한 포럼 글, V2EX, 2025-11-06. https://global.v2ex.co/t/1170874
12. “Mini program open platform”, Xiaohongshu. https://miniapp.xiaohongshu.com/
13. “Xiaohongshu user agreement”, 2026-03-23 개정. https://agree.xiaohongshu.com/h5/terms/ZXXY20220331001/-1
14. “RedNote Terms of Service”, 2026-06-09 시행. https://agree.xiaohongshu.com/h5/terms/ZXXY20251205003/-1
15. “NanmiCoder/MediaCrawler”, GitHub, 2026-11-04 열람. https://github.com/NanmiCoder/MediaCrawler
16. “MediaCrawler NON-COMMERCIAL LEARNING LICENSE 1.1”, GitHub. https://github.com/NanmiCoder/MediaCrawler/blob/main/LICENSE
17. “xpzouying/xiaohongshu-mcp”, GitHub. https://github.com/xpzouying/xiaohongshu-mcp
18. xiaohongshu-mcp 커밋 기록, GitHub. https://github.com/xpzouying/xiaohongshu-mcp/commits/main
19. xiaohongshu-mcp 이슈 880, 로그인 불가, 2026-10-23. https://github.com/xpzouying/xiaohongshu-mcp/issues/880
20. xiaohongshu-mcp 이슈 877, 검색 제한, 2026-10-21. https://github.com/xpzouying/xiaohongshu-mcp/issues/877
21. xiaohongshu-mcp 이슈 878, 플랫폼이 이 도구를 허용하는가, 2026-10-22. https://github.com/xpzouying/xiaohongshu-mcp/issues/878
22. xiaohongshu-mcp 이슈 579, rednote.com 사용자 지원, 2026-03-13. https://github.com/xpzouying/xiaohongshu-mcp/issues/579
23. “JoeanAmier/XHS-Downloader”, GitHub. https://github.com/JoeanAmier/XHS-Downloader
24. XHS-Downloader 이슈 497, 서버 측 데이터 파싱 실패, 2026-10-17. https://github.com/JoeanAmier/XHS-Downloader/issues/497
25. XHS-Downloader 이슈 479, 크롤링 속도를 낮추는 설정, 2026-09-15. https://github.com/JoeanAmier/XHS-Downloader/issues/479
26. “cv-cat/Spider_XHS”, GitHub. https://github.com/cv-cat/Spider_XHS
27. Spider_XHS 이슈 191, 쿠키가 유효하지 않거나 만료됨, 2026-10-10. https://github.com/cv-cat/Spider_XHS/issues/191
28. “jackwener/xiaohongshu-cli”, GitHub. https://github.com/jackwener/xiaohongshu-cli
29. xiaohongshu-cli 이슈 82, 7일마다 강제 로그인, 2026-08-17. https://github.com/jackwener/xiaohongshu-cli/issues/82
30. “ReaJason/xhs”, GitHub. https://github.com/ReaJason/xhs
31. “white0dew/XiaohongshuSkills”, GitHub. https://github.com/white0dew/XiaohongshuSkills
32. “autoclaw-cc/xiaohongshu-skills”, GitHub. https://github.com/autoclaw-cc/xiaohongshu-skills
33. “Jamailar/Beav”, GitHub. https://github.com/Jamailar/Beav
34. “Cloxl/xhshow”, 요청 서명 라이브러리, GitHub. https://github.com/Cloxl/xhshow
35. “List repository issues”, GitHub REST API 문서. https://docs.github.com/en/rest/issues/issues#list-repository-issues
36. “Licensing a repository”, GitHub 문서. https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/licensing-a-repository
37. “Personal Information Protection Law of the PRC”, 중국 국가인터넷정보판공실. https://www.cac.gov.cn/2021-08/20/c_1631050028355286.htm
38. “Network Data Security Management Regulations”(국무원령 제790호), 중국 생태환경부 사이트 게재본. https://www.mee.gov.cn/zcwj/gwywj/202410/t20241003_1087417.shtml
39. “Release of the Network Data Security Management Regulations”, 중국 사법부, 2024-09-30. https://www.moj.gov.cn/pub/sfbgw/gwxw/xwyw/202409/t20240930_507076.html
40. “Anti-Unfair Competition Law of the PRC”, 2025년 개정본, 중국 국가지식산권국. https://www.cnipa.gov.cn/art/2026/5/20/art_104_206437.html
41. “Less shouting, more answering: How brands win on XHS”, Inside Retail Asia, 2026-10-12. https://insideretail.asia/2026/10/12/less-shouting-more-answering-how-brands-win-on-xhs/
42. V2EX 포럼 스레드 t/1170609(크리에이터 마켓플레이스 페이지 엔드포인트에 관한 답글을 인용), V2EX. https://www.v2ex.com/t/1170609
43. EveryInfra 소셜 데이터 카탈로그(무료 열람), 2026-11-04 00:13(싱가포르 시간) 열람. https://api.everyinfra.com/api/v1/social/catalog
44. “Model Context Protocol specification 2025-06-18”. https://modelcontextprotocol.io/specification/2025-06-18