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

Douyin MCP 서버

Douyin MCP: 로그인 없이 AI가 동영상, 댓글, 음성 텍스트를 가져옵니다

연결하면 에이전트가 좋아요 수나 업로드 날짜로 Douyin 동영상을 검색하고, 댓글과 답글을 페이지별로 가져오고, 보이스오버를 문장마다 타임스탬프가 붙은 텍스트로 변환하고, 계정의 팔로워와 게시물을 확인할 수 있습니다. 클라이언트는 HTTPS로 EveryInfra 서버에 연결하므로 Douyin 계정, 쿠키, 로컬 브라우저가 필요 없습니다.

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

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

예시: 지난 일주일간 좋아요가 가장 많은 캠핑 동영상

everyinfra_call_api
{
  "platform": "douyin",
  "action": "search",
  "params": {
    "keyword": "露营",
    "sort": "most_liked",
    "publish_time": "one_week"
  }
}

각 결과의 url은 comments와 transcript에 전달하고, 보통 MS4w로 시작하는 secUid인 author_id는 profile에 전달하세요.

Douyin MCP로 호출할 수 있는 기능 37개

everyinfra_list_capabilities는 아래 각 행의 파라미터를 에이전트에게 알려 주고, everyinfra_call_api는 platform을 douyin으로, action을 첫 번째 열의 값으로 설정해 실행합니다. 이 표에는 동영상과 댓글 외에도 인기 급상승 목록, 크리에이터 및 Xingtu 데이터, Hot Spot 순위, 상품과 라이브 커머스 상품, 음악이 포함됩니다. 단가가 서로 다르므로 세 번째 열을 확인하세요.

action기능가격
search검색요청 1,000개당 $8.33
profile상세 정보요청 1,000개당 $0.56
user_posts사용자 게시물요청 1,000개당 $0.56
video동영상 상세 정보요청 1,000개당 $0.56
comments댓글요청 1,000개당 $0.56
comment_replies댓글 답글요청 1,000개당 $0.56
trending인기 급상승요청 1,000개당 $0.56
transcript트랜스크립트요청 1,000개당 $0.56
creator_search크리에이터 검색요청 1,000개당 $0.56
creator_audience크리에이터 오디언스요청 1,000개당 $0.56
creator_trend크리에이터 성장 추이요청 1,000개당 $0.56
creator_benchmark크리에이터 벤치마크요청 1,000개당 $0.56
xingtu_creator_searchXingtu 크리에이터 검색요청 1,000개당 $0.56
xingtu_creator_analyticsXingtu 크리에이터 분석요청 1,000개당 $0.56
xingtu_rate_cardXingtu 크리에이터 단가표요청 1,000개당 $0.56
xingtu_creator_rankingsXingtu 크리에이터 순위요청 1,000개당 $0.56
product_search상품 검색요청 1,000개당 $13.33
product_detail상품 상세 정보요청 1,000개당 $13.33
live_product_search라이브 상품 검색요청 1,000개당 $0.56
hashtag_search해시태그 검색요청 1,000개당 $15.56
hashtag_detail해시태그 상세요청 1,000개당 $15.56
billboard_video_hot인기 동영상 순위요청 1,000개당 $0.81
billboard_low_fan_explosion팔로워가 적은 계정의 인기 콘텐츠 순위요청 1,000개당 $0.81
billboard_high_completion완주율 상위 목록요청 1,000개당 $0.81
billboard_search_hot인기 검색 순위요청 1,000개당 $0.81
billboard_account_search핫스팟 계정 검색요청 1,000개당 $0.81
music_search음악 검색요청 1,000개당 $8
search_suggest검색어 추천요청 1,000개당 $8
billboard_rise_list급상승 순위요청 1,000개당 $0.81
billboard_challenge_hot챌린지 인기 순위요청 1,000개당 $0.81
billboard_topic_hot토픽 인기 순위요청 1,000개당 $0.81
music_detail음악 상세요청 1,000개당 $0.81
xingtu_conversion_abilityXingtu 크리에이터 전환 능력요청 1,000개당 $1.6
xingtu_link_structureXingtu 연결 사용자 구조요청 1,000개당 $16
xingtu_recommended_videosXingtu 추천 동영상요청 1,000개당 $1.6
xingtu_touch_distributionXingtu 연결 사용자 유입 경로요청 1,000개당 $16
xingtu_video_performanceXingtu 동영상 성과요청 1,000개당 $16

주제 하나로 댓글, 음성 텍스트, 계정 프로필까지 얻는 방법

search에서 받은 동영상 url로 다음 단계가 이어집니다. comments와 transcript 모두 이 url을 받고, author_id는 profile과 user_posts에, 댓글의 id는 comment_replies에 전달합니다.

  1. search로 동영상 찾기

    search

    keyword에는 계정 이름이나 동영상 ID가 아니라 동영상에서 찾고 싶은 검색어를 넣습니다. most_liked 또는 newest로 정렬하고, publish_time을 one_day, one_week, half_year로 제한하고, limit을 기본값 10에서 최대 50까지 늘릴 수 있습니다. 각 동영상에는 좋아요·댓글·공유·저장 수, 길이, 해시태그, 작성자의 팔로워 수가 포함됩니다.

  2. comments와 comment_replies로 댓글 읽기

    commentscomment_replies

    page_token 없이 호출하면 comments는 기본적으로 상위 댓글 20개를 읽습니다. 더 가져오려면 먼저 빈 page_token을 보낸 뒤, 응답의 next_page_token을 매번 다시 전달하세요. 페이지당 최대 50개입니다. 각 댓글에는 is_hot과 liked_by_author 플래그가 있으며, reply_count가 0보다 크면 해당 id를 comment_replies에 전달해 답글을 최대 100개까지 가져올 수 있습니다.

  3. transcript로 음성을 텍스트로 변환하기

    transcript

    transcript는 동영상 url만 있으면 됩니다. 전체 음성 텍스트와 함께 문장별 시작·종료 시간(초)과 텍스트를 담은 segments, 그리고 audio_url과 duration_sec을 반환합니다. 에이전트는 특정 문장을 타임스탬프와 함께 인용하거나 동영상 전체를 요약할 수 있습니다.

  4. profile과 user_posts로 계정 확인하기

    profileuser_posts

    author_id는 secUid이므로 user_id로 그대로 사용할 수 있습니다. profile은 닉네임, Douyin ID, 팔로워 수와 동영상 수, IP 위치, is_live, has_shop을 반환합니다. user_posts는 동영상을 최신순으로 기본 20개, 최대 100개까지 나열하며, since로 가장 이른 업로드 날짜를 지정할 수 있습니다.

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

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

  1. Douyin에서 인기 캠핑 동영상을 검색해서 각 동영상의 제목, 크리에이터, 좋아요 수를 정리해 주세요.

    사용된 도구: everyinfra_call_apiDouyin · 검색

  2. 이 Douyin 동영상의 댓글을 읽고 사람들이 가장 많이 제기하는 문제 3가지를 요약해 주세요.

    사용된 도구: everyinfra_call_apiDouyin · 댓글

  3. 이 Douyin 계정의 최신 동영상을 각 동영상의 좋아요, 댓글, 공유 수와 함께 나열해 주세요.

    사용된 도구: everyinfra_call_apiDouyin · 사용자 게시물

  4. 이 Douyin 동영상의 음성을 텍스트로 변환해 주세요.

    사용된 도구: everyinfra_call_apiDouyin · 트랜스크립트

클라이언트에 추가

클라이언트의 원격 MCP 설정에 다음 서버 주소를 입력하세요: https://api.everyinfra.com/mcp. Authorization: Bearer 뒤에 API 키를 붙인 헤더 하나를 추가하세요. 이 키 하나로 같은 주소에서 everyinfra_call_api와 검색, CAPTCHA 해결, AI, 계정 도구까지 총 24개의 도구를 사용할 수 있습니다.

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

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

Claude, Cursor 등 클라이언트별 설정 방법과 전체 도구 보기

자주 묻는 질문

Douyin MCP를 사용하려면 Douyin 계정이 필요한가요?

아니요. 클라이언트는 HTTPS로 EveryInfra가 운영하는 서버에 연결하므로 Douyin 계정, 쿠키, 로컬 설치, 브라우저가 필요 없습니다. 필요한 인증 정보는 EveryInfra API 키뿐입니다. 모든 기능은 공개 데이터만 읽으며 게시, 좋아요, 메시지 전송은 하지 않습니다.

동영상 링크와 계정 ID는 어떤 형식을 사용하나요?

동영상은 https://www.douyin.com/video/<video ID> 형식을 사용합니다. video, comments, transcript는 모두 이 url을 받으며, 프로필이나 검색 페이지 링크는 받지 않습니다. 계정은 secUid를 사용하는데, 보통 MS4w로 시작하고 결과에서는 author_id로 표시됩니다. profile과 user_posts에서는 이 값을 user_id에 넣으세요. author_uid는 같은 사용자의 숫자 ID입니다.

Douyin 동영상의 조회수를 가져올 수 있나요?

실제 조회수는 가져올 수 없습니다. Douyin은 조회수를 공개하지 않습니다. 대부분의 결과에는 view_count가 없고 가끔 0으로 표시되는데, 둘 다 실제 재생 수를 반영하지 않습니다. 동영상의 성과를 판단하려면 like_count, comment_count, share_count를 사용하세요.

호출당 댓글을 몇 개까지 가져올 수 있고, 페이지는 어떻게 넘기며, 호출은 어떻게 계산되나요?

page_token 없이 한 번 호출하면 상위 댓글을 읽습니다. 기본값은 20개이며, limit을 아무리 높게 설정해도 최대 약 50–60개입니다. 페이지를 넘기려면 먼저 빈 page_token을 보낸 뒤, 응답의 next_page_token을 그대로 다시 전달하세요. 각 페이지에는 최상위 댓글이 최대 50개 포함되며 토큰은 24시간 동안 유효합니다. 댓글 20개마다 호출 1건으로 계산되므로 댓글 50개짜리 페이지는 3건이며, 결과가 없는 블록은 과금되지 않습니다.

transcript는 무엇을 반환하나요?

text에는 전체 음성 텍스트를, segments에는 문장별 타임라인을 반환하며, segments의 각 항목에는 start, end(초 단위), text가 포함됩니다. 이 밖에 audio_url과 동영상 길이인 duration_sec도 반환하며, 모두 동영상 url 하나로 가져올 수 있습니다.

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

기능별로 과금됩니다. Douyin 기능의 요금은 요청 1,000개당 $0.56부터이며, MCP로 연결해도 추가 비용은 없습니다. 실패한 호출, 잘못된 파라미터, 빈 결과는 과금되지 않습니다. 댓글은 반환된 20개마다 과금되고, user_posts는 페이지마다 호출 1건으로 계산되며, everyinfra_list_capabilities 카탈로그는 무료입니다.

에이전트에게 Douyin 댓글과 음성 텍스트를 제공하세요

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