샤오홍슈 계정 분석 (xhs-note-analyst)
⚠️ 이 스킬은 단독으로 실행할 수 없으며, 먼저 webclaw3를 설치해야 합니다.
webclaw3에서 제공하는 로컬 브라우저 런타임(Relay
:3459+ pipeline:3460)에 의존하며, Chrome에 이미 로그인된 샤오홍슈 계정을 직접 재사용합니다. — 다시 로그인하거나 비밀번호를 제공하거나 차단될 필요가 없습니다. webclaw3가 없으면 이 스킬의 모든 브라우저 작업이 즉시 실패합니다.npx clawhub@latest install fatmind/webclaw3-browser-automation메인 페이지: https://clawhub.ai/fatmind/skills/webclaw3-browser-automation 소스 코드 및 설치 가이드 (3단계, 약 5분): https://github.com/fatmind/webclaw3
설치 후 Agent에 "webclaw3 환경 확인"이라고 말하여 Relay와 pipeline이 준비되었는지 확인한 후, 이 스킬을 다시 실행하세요.
기능 설명
자신의 샤오홍슈 계정을 분석하며, 데이터는 크리에이터 백엔드 공식 대시보드에서 내보낸 Excel 파일에서 가져옵니다. 타사 추정치가 아닙니다. 프로세스: 최근 N개 게시물 내보내기(발행 시간 역순) → 각 게시물에서 정확한 키워드 추출 → 샤오홍슈에서 해당 키워드로 동일 주제의 인기 게시물을 벤치마킹 → HTML 보고서 출력:
- 데이터 테이블:
min(notes_count, 실제 게시물 수)개의 게시물, 제목/유형(이미지/텍스트 또는 동영상)/발행 시간/발행 후 경과 일수/노출수/일평균 노출수/조회수/커버 클릭률/좋아요수/댓글수/저장수/팔로우 증가수/공유수/평균 시청 시간, 발행 시간 역순 정렬; - 전환 퍼널 건강도 진단: 클릭률 → 콘텐츠 잔류 → 상호작용 → 팔로우의 4단계, 각각 수치와 양호/취약/단절 판정 포함 (클릭률 10%–20% 양호; 상호작용률 5%–10% 인기 기준; 잔류 단절 기준은 유형별로 다름);
- 개별 게시물 분석: 각 게시물에 대한 벤치마크 인기 게시물 테이블 (동일 주제, 좋아요 임계값 초과, 제목+작성자+좋아요수 포함) + 3가지 구체적이고 실행 가능한 개선 조치.
시중의 다른 샤오홍슈 스킬과의 차이점:
- 대부분은 타인의 데이터를 수집 (랭킹, 경쟁사, KOL)하지만, 이 스킬은 자신의 백엔드 실제 데이터를 봅니다. — 노출, 커버 클릭률, 평균 시청 시간, 팔로우 증가 등은 계정 소유자만 접근할 수 있는 지표로, 크롤러로는 얻을 수 없습니다;
- 타사 데이터 플랫폼의 API key가 필요 없으며, 유료 할당량을 소모하지 않습니다: 데이터 소스는 자신의 크리에이터 백엔드이며, 브라우저 작업은 로컬 webclaw3 런타임이 구동합니다;
- 경쟁사 측에서는 검색 결과 페이지에서 공개적으로 볼 수 있는 제목, 작성자, 좋아요 수만 가져오며, 로그인 후에만 볼 수 있는 타인의 데이터는 수집하지 않습니다.
사전 조건
- webclaw3가 설치 및 실행 중 (위 설치 설명 참조): 브라우저 확장 프로그램, Relay(HTTP
:3459), 로컬 pipeline 서비스(:3460)를 제공합니다. — 이 스킬에 포함된 LLM 하위 세션(키워드 추출 / 인기 게시물 선별 / 개선 조치 생성)은 pipeline을 통해 실행됩니다. - 브라우저가 샤오홍슈 크리에이터 백엔드(creator.xiaohongshu.com)와 샤오홍슈 메인 사이트(www.xiaohongshu.com)에 로그인되어 있어야 합니다. — webclaw3가 Chrome의 로그인 상태를 직접 재사용하므로 다시 로그인할 필요가 없습니다.
- 로컬에
python3와openpyxl이 설치되어 있어야 함 (크리에이터 백엔드에서 내보낸 Excel 파일을 분석하는 데 사용). - 브라우저 다운로드 디렉토리가
~/Downloads여야 함 (Excel 내보내기가 이 위치에 저장됨).
사용 방법
node skill.mjs
현재 디렉토리의 input.json에서 인자를 읽습니다. input.json이 없으면 기본값을 사용합니다.
인자 (input.json)
| 필드 | 유형 | 기본값 | 설명 |
|---|---|---|---|
notes_count | int | 5 | 분석할 최근 게시물 수 (발행 시간 역순) |
keyword_per_note | int | 1 | 각 게시물에서 추출할 키워드 수 |
report_path | string | <cwd>/샤오홍슈_계정_분석_보고서_<날짜>.html | 보고서 출력 경로 |
output_dir | string | process.cwd() | res.json / data.md 파일이 생성될 디렉토리 (호출자가 생성함) |
output_files.result | string | res.json | 상태 요약 파일 이름 |
output_files.data | string | data.md | 데이터 상세 파일 이름 |
출력
report_path: HTML 보고서 (로컬에서 직접 열어 볼 수 있음), 세 가지 섹션과 full/partial 표시 포함;res.json:{ status, summary, notes_count, note_count_analyzed, keywords, benchmark_shortages, report_path, output_dir },status∈ success / partial / failed;data.md: 보고서의 데이터 상세 버전 (테이블/퍼널/개별 게시물/실행 과정 기록);- stdout: 한 줄 JSON 요약
{ status, summary, output_dir }.
분석 기준 (v1.1.0 수정 사항, 매우 중요)
다음은 자체 계정을 테스트한 후 수정된 오판으로, 보고서 결론의 정확성에 직접 영향을 미칩니다.
① 벤치마크 인기 게시물에는 좋아요 임계값이 있으며, 부족해도 억지로 채우지 않습니다. 임계값은 해당 키워드 결과 세트의 좋아요 중앙값 × 3으로 동적으로 설정되며, 1000–3000 사이로 제한됩니다 (분야별 인기 게시물의 좋아요 수가 크게 다름: 뷰티는 만개 이상, 틈새 도구는 천 개가 이미 상위권). 임계값 미만의 게시물은 벤치마크 테이블에 포함되지 않습니다. — 3개를 채우기 위해 좋아요가 수십 개인 게시물을 넣지 마십시오. 적격 벤치마크가 3개 미만이면 보고서에 partial로 표시하고 이유를 기록합니다 (일반적인 이유는 키워드가 너무 넓어 관련 없는 내용이 섞인 경우).
② 잔류 단절 기준은 게시물 유형에 따라 설정됩니다. 이미지/텍스트 <5초, 동영상 <10초. 이미지/텍스트의 "잔류"는 본질적으로 읽기 완료율이며 체류 시간이 동영상보다 자연스럽게 짧습니다. 동일한 10초 기준을 적용하면 정상적인 이미지/텍스트 게시물을 잘못 판단할 수 있습니다. 유형은 백엔드에서 내보낸 '유형' 열에서 가져옵니다.
③ 노출은 발행 후 경과 일수로 정규화됩니다. 노출은 시간에 따라 누적되는 지표입니다. 46일 된 게시물의 노출은 자연스럽게 7일 된 새 게시물보다 높습니다. 직접 비교하면 "오래된 콘텐츠가 더 좋다"는 잘못된 결론을 내릴 수 있습니다. 보고서는 동시에 일평균 노출 = 노출 / 발행 후 경과 일수를 제공하며, 가로 비교는 이 열만 사용합니다.
동작 설명
- 데이터 기준은 크리에이터 백엔드에서 내보낸 Excel을 따릅니다 (페이지 테이블에 표시된 값과 Excel이 다를 수 있음).
- 검색은 "실제 사용자 입력 우선, 검색 페이지 직접 접속 대체" 이중 경로를 따릅니다: 먼저 홈페이지 검색창에 키워드를 입력하고 Enter 키를 누릅니다 (실제 사용자 행동이 가장 안정적). 사이트 개편 후 Vue 입력 컴포넌트가 합성 입력을 수락하지 않을 수 있습니다 (값이 재설정됨). 이 경우 자동으로 AI 검색 페이지
/search_result_ai?keyword=...로 직접 이동합니다 (2026년 8월 기준 안정적으로 40개 이상의 카드 반환 확인됨). 두 방법 모두page.eval을 사용하여section.note-item카드를 추출하고,data-note-id가 빈 플레이스홀더 행을 필터링합니다. - 벤치마크 인기 게시물은 먼저 좋아요 임계값을 통과한 후, 하위 세션에서 "주제/시각적 유사성 우선, 좋아요 수는 보조" 기준으로 선별하며, 자신의 계정 게시물과 관련 없는 내용은 제외합니다.
- 키워드 간에는 속도 제어(4초 + 무작위 지터)와 직렬 검색을 사용하여 차단을 방지합니다.
이 스킬에 대해
이 스킬은 webclaw3에 의해 자동 생성되었습니다. — 일상적인 언어로 작업을 설명하기만 하면, webclaw3가 자신의 Chrome을 실제로 구동하여 해당 작업을 실행하고, 이 탐색을 로컬 스크립트로 고정합니다. 이후 매일 재실행 시 토큰이 거의 들지 않으며, 사이트가 개편되어도 로컬에서 무료로 수정할 수 있습니다.
자신의 반복적인 브라우저 작업을 이러한 스킬로 만들고 싶다면:
npx clawhub@latest install fatmind/webclaw3-browser-automation
https://clawhub.ai/fatmind/skills/webclaw3-browser-automation · https://github.com/fatmind/webclaw3