자체 방문 통계는 항상 수집됩니다. 사용자가 공개 페이지를 어떻게 이용하는지 파악하는 데 쓰이는 Google Analytics(로그인한 워크스페이스는 제외)는 동의한 경우에만 사용됩니다. 자세한 내용은 개인정보 처리방침을 참고하세요.

Xiaohongshu MCP 서버

Xiaohongshu MCP: 로그인 없이 AI가 RedNote 노트와 댓글을 읽고 크리에이터 정보를 확인합니다

Claude, Cursor, ChatGPT에 URL 하나만 지정하면 에이전트가 좋아요, 저장, 댓글 수로 정렬된 Xiaohongshu 노트를 검색하고, 토픽과 IP 위치가 포함된 본문 전체를 읽고, 댓글 스레드를 따라 크리에이터 프로필까지 확인할 수 있습니다. 서버는 EveryInfra가 운영하므로 API 키만 있으면 됩니다. RedNote 계정, 쿠키, QR 코드 스캔이 필요 없고 로컬 브라우저도 필요하지 않습니다.

17
기능 Xiaohongshu개
24
도구
106
플랫폼
MCP 서버 URL
https://api.everyinfra.com/mcp

중국 본토에서는 다음 URL을 사용하세요: https://api-cn.everyinfra.com/mcp

에이전트의 첫 호출: 좋아요가 가장 많은 노트

everyinfra_call_api
{
  "platform": "xiaohongshu",
  "action": "search",
  "params": {
    "keyword": "露营装备",
    "sort": "most_liked"
  }
}

search 결과의 노트 url에는 보통 xsec_token이 포함되어 있습니다. 이 url은 그대로 note와 comments에 전달하고, author_id는 profile에 전달하세요.

노트와 댓글부터 크리에이터, 상품까지 다루는 Xiaohongshu 기능 17개

에이전트는 everyinfra_list_capabilities로 이 기능과 파라미터 목록을 확인한 뒤, platform을 xiaohongshu로, action을 첫 번째 열의 값으로 설정해 everyinfra_call_api로 호출합니다. search부터 시작하세요. 다른 ID 없이 키워드만 있으면 되고, 반환되는 url과 author_id는 그대로 note, comments, profile에 넣을 수 있습니다.

action기능가격
search검색요청 1,000개당 $5.56
profile상세 정보요청 1,000개당 $5.56
user_posts사용자 게시물요청 1,000개당 $5.56
note노트 상세 정보요청 1,000개당 $5.56
video동영상 상세 정보요청 1,000개당 $5.56
comments댓글요청 1,000개당 $5.56
comments_batch여러 URL의 댓글요청 1,000개당 $5.56
sub_comments댓글 답글요청 1,000개당 $5.56
search_users사용자 검색요청 1,000개당 $5.56
hashtag해시태그요청 1,000개당 $5.56
trending인기 급상승요청 1,000개당 $5.56
product_search상품 검색요청 1,000개당 $5.56
product_detail상품 상세 정보요청 1,000개당 $5.56
reviews리뷰요청 1,000개당 $5.56
followers_list팔로워 목록요청 1,000개당 $5.56
note_location노트 위치요청 1,000개당 $5.56
pgy_content_squarePugongying 콘텐츠 보드요청 1,000개당 $16

키워드 하나에서 크리에이터 프로필까지, 호출 4번이면 충분합니다

각 호출의 결과가 다음 호출로 이어집니다. search는 url과 author_id를, comments는 comment_id를 반환하므로 에이전트가 링크나 ID를 따로 물어볼 필요가 없습니다.

  1. search로 좋아요가 가장 많은 노트 찾기

    search

    keyword에는 사용자 ID가 아니라 노트 내용에 들어 있는 단어를 넣습니다. most_liked, most_collected, most_commented, newest로 정렬하고, date_range를 last_7_days나 last_30_days로 좁히고, content_type을 image나 video로 지정할 수 있습니다. 모든 결과에는 url, 좋아요·저장·댓글 수, author_id가 포함됩니다.

  2. note로 노트 전문 읽기

    note

    search에서 받은 url을 xsec_token까지 포함해 그대로 전달합니다. 본문, 태그, topic_id가 포함된 토픽, 이미지, IP 위치와 함께 브랜드 협찬 여부와 연결 상품 여부를 나타내는 is_cooperation_note, has_goods를 받을 수 있습니다. topic_id를 hashtag에 전달하면 같은 토픽의 다른 노트를 볼 수 있습니다.

  3. comments와 sub_comments로 댓글 스레드 읽기

    commentssub_comments

    comments는 같은 노트 url을 받아 most_liked 또는 newest로 정렬합니다. 각 댓글에는 좋아요 수, IP 위치, sub_comment_count, is_author 플래그가 포함됩니다. 답글이 많은 댓글은 comment_id를 sub_comments에 전달해 답글을 펼칠 수 있으며, reply_to_author_name으로 각 답글이 누구에게 단 것인지 확인할 수 있습니다.

  4. profile과 user_posts로 크리에이터 분석하기

    profileuser_posts

    author_id를 profile의 user_id로 사용하면 정확한 팔로워 수, 좋아요·저장 수, Xiaohongshu ID(red_id), 인증 상태를 확인할 수 있습니다. user_posts는 크리에이터의 노트 목록을 반환하며, 고정 게시물은 is_pinned로, 상품 판매 노트는 is_goods_note로 표시됩니다. 댓글 결과에는 보통 29자로 된 다른 형식의 author_id가 표시되므로, profile로 변환한 뒤 반환된 user_id를 기준으로 중복을 제거하세요.

이제 필요한 것을 요청하세요

에이전트는 먼저 기능 카탈로그를 확인한 뒤 도구와 파라미터를 선택합니다. 각 예시는 해당 API 페이지로 연결되므로 파라미터와 필드를 미리 확인할 수 있습니다.

  1. Xiaohongshu에서 캠핑 장비 관련 인기 노트를 검색해서 좋아요 순으로 정렬한 표로 만들어 주세요.

    사용된 도구: everyinfra_call_apiXiaohongshu · 검색

  2. 이 Xiaohongshu 노트를 읽고 본문, 태그, 좋아요·저장·댓글 수를 알려 주세요.

    사용된 도구: everyinfra_call_apiXiaohongshu · 노트 상세 정보

  3. 이 노트의 댓글을 가져와서 사람들이 가장 많이 제기하는 문제 3가지를 요약해 주세요.

    사용된 도구: everyinfra_call_apiXiaohongshu · 댓글

  4. 이 Xiaohongshu 크리에이터의 팔로워 수, 좋아요·저장 수, 소개글을 보여 주세요.

    사용된 도구: everyinfra_call_apiXiaohongshu · 상세 정보

클라이언트 연결

원격 MCP를 지원하는 클라이언트라면 어디서든 다음 주소로 원격 MCP 서버를 추가하세요: https://api.everyinfra.com/mcp. Authorization: Bearer 뒤에 API 키를 붙인 헤더를 보내면 됩니다. 같은 URL에서 everyinfra_call_api 외에도 검색, CAPTCHA 해결, AI, 계정 도구를 제공하며 모두 합쳐 24개입니다.

mcp.json
{
  "mcpServers": {
    "everyinfra": {
      "url": "https://api.everyinfra.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

API 키는 클라이언트의 시크릿 또는 환경 변수 설정에 보관하고, 저장소에 절대 커밋하지 마세요.

클라이언트별 단계별 설정 방법과 전체 도구 목록

자주 묻는 질문

Xiaohongshu에 로그인해야 하나요?

아니요. EveryInfra가 서버를 운영하며 공개 데이터를 읽으므로 Xiaohongshu 계정, 쿠키, QR 코드 스캔 없이 EveryInfra API 키만 있으면 됩니다. 읽기 전용이므로 게시, 좋아요, 메시지 전송은 하지 않습니다.

노트 링크는 어떻게 전달해야 하며, xsec_token은 왜 유지해야 하나요?

경로가 /explore/<note ID> 또는 /discovery/item/<note ID>인 전체 노트 URL을 전달하고, 쿼리 파라미터는 모두 유지하세요. 최근 search 결과의 url에는 보통 노트의 액세스 토큰인 xsec_token이 포함되어 있으므로, 잘라내지 말고 해당 링크를 그대로 note와 comments에 전달하세요.

인기도, 날짜, 이미지/동영상 여부로 노트를 필터링할 수 있나요?

네, 모두 search에서 가능합니다. sort에는 인기도 기준인 most_liked, most_collected, most_commented 또는 newest를 지정합니다. date_range는 last_24_hours부터 last_1_year까지 지정할 수 있고, content_type에는 image 또는 video를 지정합니다. 다음 페이지를 가져오려면 next_page_token을 page_token으로 다시 전달하세요.

댓글과 중첩 답글도 가져올 수 있나요? 페이지는 어떻게 넘기나요?

네. comments는 최상위 댓글을 반환하며, 각 댓글에는 처음 몇 개의 답글과 sub_comment_count가 포함됩니다. 답글을 더 보려면 노트 url과 해당 댓글의 comment_id로 sub_comments를 호출하세요. 페이지를 넘기려면 이전 응답의 next_page_token을 page_token으로 전달하며, 페이지마다 호출 1건으로 계산됩니다. 여러 노트를 한 번에 처리하려면 comments_batch를 사용하세요.

브랜드 협찬 노트와 상품 판매 노트를 구분할 수 있나요?

네, 세 가지 필드로 구분할 수 있습니다. is_cooperation_note는 search와 note 결과에서 브랜드 협찬 노트를 표시하며, 정보가 없으면 포함되지 않습니다. is_goods_note는 search와 user_posts에서 상품 판매 노트를 표시하고, has_goods는 노트에 상품이 연결된 경우 note 결과에 나타납니다.

Xiaohongshu MCP는 어떻게 과금되나요?

MCP 자체에는 추가 비용이 없으며, Xiaohongshu 기능의 요금은 요청 1,000개당 $5.56부터입니다. search, comments, user_posts처럼 페이지 단위로 결과를 반환하는 기능은 페이지마다 호출 1건으로 계산됩니다. 실패한 호출, 파라미터가 잘못된 호출, 결과가 없는 호출은 과금되지 않으며, everyinfra_list_capabilities는 무료입니다.

에이전트에게 Xiaohongshu 노트와 댓글 스레드를 제공하세요

회원가입 후 콘솔에서 API 키를 만들어 위 설정에 추가하면 채팅에서 바로 이 도구들을 호출할 수 있습니다.