Douyin MCP를 사용하려면 Douyin 계정이 필요한가요?
아니요. 클라이언트는 HTTPS로 EveryInfra가 운영하는 서버에 연결하므로 Douyin 계정, 쿠키, 로컬 설치, 브라우저가 필요 없습니다. 필요한 인증 정보는 EveryInfra API 키뿐입니다. 모든 기능은 공개 데이터만 읽으며 게시, 좋아요, 메시지 전송은 하지 않습니다.
자체 방문 통계는 항상 수집됩니다. 사용자가 공개 페이지를 어떻게 이용하는지 파악하는 데 쓰이는 Google Analytics(로그인한 워크스페이스는 제외)는 동의한 경우에만 사용됩니다. 자세한 내용은 개인정보 처리방침을 참고하세요.
Douyin MCP 서버
연결하면 에이전트가 좋아요 수나 업로드 날짜로 Douyin 동영상을 검색하고, 댓글과 답글을 페이지별로 가져오고, 보이스오버를 문장마다 타임스탬프가 붙은 텍스트로 변환하고, 계정의 팔로워와 게시물을 확인할 수 있습니다. 클라이언트는 HTTPS로 EveryInfra 서버에 연결하므로 Douyin 계정, 쿠키, 로컬 브라우저가 필요 없습니다.
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에 전달하세요.
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_search | Xingtu 크리에이터 검색 | 요청 1,000개당 $0.56 |
xingtu_creator_analytics | Xingtu 크리에이터 분석 | 요청 1,000개당 $0.56 |
xingtu_rate_card | Xingtu 크리에이터 단가표 | 요청 1,000개당 $0.56 |
xingtu_creator_rankings | Xingtu 크리에이터 순위 | 요청 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_ability | Xingtu 크리에이터 전환 능력 | 요청 1,000개당 $1.6 |
xingtu_link_structure | Xingtu 연결 사용자 구조 | 요청 1,000개당 $16 |
xingtu_recommended_videos | Xingtu 추천 동영상 | 요청 1,000개당 $1.6 |
xingtu_touch_distribution | Xingtu 연결 사용자 유입 경로 | 요청 1,000개당 $16 |
xingtu_video_performance | Xingtu 동영상 성과 | 요청 1,000개당 $16 |
search에서 받은 동영상 url로 다음 단계가 이어집니다. comments와 transcript 모두 이 url을 받고, author_id는 profile과 user_posts에, 댓글의 id는 comment_replies에 전달합니다.
keyword에는 계정 이름이나 동영상 ID가 아니라 동영상에서 찾고 싶은 검색어를 넣습니다. most_liked 또는 newest로 정렬하고, publish_time을 one_day, one_week, half_year로 제한하고, limit을 기본값 10에서 최대 50까지 늘릴 수 있습니다. 각 동영상에는 좋아요·댓글·공유·저장 수, 길이, 해시태그, 작성자의 팔로워 수가 포함됩니다.
page_token 없이 호출하면 comments는 기본적으로 상위 댓글 20개를 읽습니다. 더 가져오려면 먼저 빈 page_token을 보낸 뒤, 응답의 next_page_token을 매번 다시 전달하세요. 페이지당 최대 50개입니다. 각 댓글에는 is_hot과 liked_by_author 플래그가 있으며, reply_count가 0보다 크면 해당 id를 comment_replies에 전달해 답글을 최대 100개까지 가져올 수 있습니다.
transcript는 동영상 url만 있으면 됩니다. 전체 음성 텍스트와 함께 문장별 시작·종료 시간(초)과 텍스트를 담은 segments, 그리고 audio_url과 duration_sec을 반환합니다. 에이전트는 특정 문장을 타임스탬프와 함께 인용하거나 동영상 전체를 요약할 수 있습니다.
author_id는 secUid이므로 user_id로 그대로 사용할 수 있습니다. profile은 닉네임, Douyin ID, 팔로워 수와 동영상 수, IP 위치, is_live, has_shop을 반환합니다. user_posts는 동영상을 최신순으로 기본 20개, 최대 100개까지 나열하며, since로 가장 이른 업로드 날짜를 지정할 수 있습니다.
에이전트는 먼저 기능 카탈로그를 확인한 뒤 도구와 파라미터를 선택합니다. 각 예시는 해당 API 페이지로 연결되므로 파라미터와 필드를 미리 확인할 수 있습니다.
Douyin에서 인기 캠핑 동영상을 검색해서 각 동영상의 제목, 크리에이터, 좋아요 수를 정리해 주세요.
사용된 도구: everyinfra_call_apiDouyin · 검색
이 Douyin 동영상의 댓글을 읽고 사람들이 가장 많이 제기하는 문제 3가지를 요약해 주세요.
사용된 도구: everyinfra_call_apiDouyin · 댓글
이 Douyin 계정의 최신 동영상을 각 동영상의 좋아요, 댓글, 공유 수와 함께 나열해 주세요.
사용된 도구: everyinfra_call_apiDouyin · 사용자 게시물
이 Douyin 동영상의 음성을 텍스트로 변환해 주세요.
사용된 도구: everyinfra_call_apiDouyin · 트랜스크립트
클라이언트의 원격 MCP 설정에 다음 서버 주소를 입력하세요: https://api.everyinfra.com/mcp. Authorization: Bearer 뒤에 API 키를 붙인 헤더 하나를 추가하세요. 이 키 하나로 같은 주소에서 everyinfra_call_api와 검색, CAPTCHA 해결, AI, 계정 도구까지 총 24개의 도구를 사용할 수 있습니다.
{ "mcpServers": { "everyinfra": { "url": "https://api.everyinfra.com/mcp", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } }
API 키는 클라이언트의 시크릿 또는 환경 변수 설정에 보관하고, 저장소에 절대 커밋하지 마세요.
아니요. 클라이언트는 HTTPS로 EveryInfra가 운영하는 서버에 연결하므로 Douyin 계정, 쿠키, 로컬 설치, 브라우저가 필요 없습니다. 필요한 인증 정보는 EveryInfra API 키뿐입니다. 모든 기능은 공개 데이터만 읽으며 게시, 좋아요, 메시지 전송은 하지 않습니다.
동영상은 https://www.douyin.com/video/<video ID> 형식을 사용합니다. video, comments, transcript는 모두 이 url을 받으며, 프로필이나 검색 페이지 링크는 받지 않습니다. 계정은 secUid를 사용하는데, 보통 MS4w로 시작하고 결과에서는 author_id로 표시됩니다. profile과 user_posts에서는 이 값을 user_id에 넣으세요. author_uid는 같은 사용자의 숫자 ID입니다.
실제 조회수는 가져올 수 없습니다. 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건이며, 결과가 없는 블록은 과금되지 않습니다.
text에는 전체 음성 텍스트를, segments에는 문장별 타임라인을 반환하며, segments의 각 항목에는 start, end(초 단위), text가 포함됩니다. 이 밖에 audio_url과 동영상 길이인 duration_sec도 반환하며, 모두 동영상 url 하나로 가져올 수 있습니다.
기능별로 과금됩니다. Douyin 기능의 요금은 요청 1,000개당 $0.56부터이며, MCP로 연결해도 추가 비용은 없습니다. 실패한 호출, 잘못된 파라미터, 빈 결과는 과금되지 않습니다. 댓글은 반환된 20개마다 과금되고, user_posts는 페이지마다 호출 1건으로 계산되며, everyinfra_list_capabilities 카탈로그는 무료입니다.