Yuanbao Search API와 이 API가 반환하지 않는 중국 플랫폼 데이터

2026년 10월 20일, 텐센트는 텐센트 클라우드를 통해 Yuanbao Search를 외부 개발자에게 공개했습니다. API, MCP 서버, 스킬 형태로 제공되며 매월 2,000건의 무료 호출이 포함됩니다(MyDrivers 보도, 10월 20일). SearchPro 결과에는 제목, 날짜, 링크, 요약, 사이트 이름, 관련도 점수가 담겨 있습니다.

좋아요, 댓글, 저장, 조회수, 팔로워 수는 포함되지 않습니다. 텐센트 클라우드 FAQ는 위챗 공식 계정 글도 대상에서 제외한다고 밝히고 있습니다(SearchPro API 레퍼런스, Yuanbao Search FAQ).

2026년 11월 6일 싱가포르 시간 00:17부터 00:20 사이에 EveryInfra로 Xiaohongshu, Douyin, Bilibili, 위챗에서 같은 제품 검색어 하나를 조회했습니다. 과금된 호출 6건의 비용은 $0.028557이었습니다. Xiaohongshu, Douyin, Bilibili의 모든 행에 좋아요, 댓글, 게시 시간이 포함되어 있었습니다. 위챗 글은 두 번째 호출로 조회수를 받을 수 있습니다. SearchPro는 이 수치를 하나도 반환하지 않으므로, Yuanbao를 사용하는 에이전트에는 앱 내부 데이터를 가져오는 데이터 API가 함께 필요합니다. EveryInfra는 텐센트와 제휴 관계가 없으며, 두 서비스는 별개입니다.

이 글은 중국 외 지역에서 AI 에이전트를 개발하면서 중국 소비자 데이터가 필요한 팀을 위한 것입니다. 대표적인 요청은 "이번 겨울 중국 구매자들은 패딩 점퍼의 어떤 점에 불만을 느끼는가" 같은 질문입니다. 서구권 검색 API는 이런 질문에 적합하지 않습니다.

주요 중국 앱 중 두 곳은 대부분의 해외 크롤러를 차단합니다. 나머지 두 곳에서는 웹 검색 결과로 나오는 동영상이 앱이 상위에 노출하는 동영상과 다르고, 수치도 없습니다. 텐센트의 새 검색 API는 중국 공개 웹과 텐센트 자체 뉴스 콘텐츠를 검색하는 데에는 좋은 도구입니다. 하지만 앱 내부에서 일어나는 일은 반환하지 않습니다. 아래에서는 양쪽을 데이터로 보여 주고, 두 가지를 하나의 에이전트에 함께 넣는 구성을 소개합니다.

Yuanbao Search에 관한 모든 사실은 cloud.tencent.com의 중국어 문서와 10월 20일부터 22일까지의 언론 보도에서 가져왔으며, 각 자료를 확인한 날짜를 함께 표기했습니다. 텐센트 클라우드 계정은 만들지 않았으므로, 아래의 Yuanbao 요청과 구성은 모두 직접 실행하지 않은 구성 예시입니다. EveryInfra 관련 수치는 모두 11월 6일의 실제 응답에서 얻었습니다. 이전 글인 DeepSeek Search API에 플랫폼 내부 데이터 더하기는 다른 검색 API와 다른 앱들을 다룹니다. 차이점은 뒤의 섹션에 정리했습니다.

서구권 검색 API로 중국 앱 데이터에 접근하기 어려운 이유

중국 소비자들의 대화는 대부분 네 개의 앱에서 이루어집니다. Xiaohongshu (RedNote)는 제품 팁과 리뷰를 공유하는 노트 앱입니다. 더우인은 TikTok의 중국 버전입니다. 빌리빌리는 긴 리뷰 영상과 영상 위에 흐르는 실시간 댓글이 특징인 동영상 사이트입니다. 위챗 공식 계정은 위챗 안에서 장문의 글을 발행합니다. 각 앱은 어떤 크롤러가 자신의 페이지를 읽을 수 있는지 정하고, 그 결정을 robots.txt 파일에 적어 둡니다.

저희는 11월 6일 싱가포르 시간 00:23에 네 개의 robots.txt 파일을 확인했습니다. Xiaohongshu robots.txt는 Googlebot에 Disallow: /를 지정하며, 와일드카드 그룹도 Disallow: /입니다. 반면 Sogou의 웹 및 모바일 크롤러에는 /explore와 노트 사이트맵 접근을 허용합니다. Sogou는 텐센트 소유입니다. 위챗 공식 계정 robots.txt는 모든 크롤러에 짧은 경로 목록만 허용하며, 글 경로는 이 목록에 없습니다. 더우인 robots.txt와 빌리빌리 robots.txt는 일부 경로만 차단하므로 동영상 페이지가 검색 엔진에 열려 있습니다.

robots 규칙이 열려 있어도 웹 검색이 어떤 영상을 반환하는지는 알 수 없습니다. 이를 측정하기 위해 간단한 프로브를 만들었습니다. Yuanbao 키가 없었기 때문에 프로브는 Yuanbao가 아닌 공개 웹 검색 엔진(지역 중국, 언어 중국어로 설정한 Google)을 사용합니다. 실제 호출로 얻은 각 행에 대해 제목의 앞 18자를 따옴표로 묶고 해당 앱의 site:를 붙여 검색했습니다. 같은 노트 또는 영상 ID가 상위 10개 링크에 나타나면 적중으로 봅니다.

먼저 방법 자체를 검증했습니다. 색인된 것으로 확인된 더우인과 빌리빌리 페이지 6개를 골랐고, 프로브는 6개를 모두 찾아냈습니다. 처음 사용한 방법은 ID만으로 검색하는 방식이었는데, 이미 알고 있던 페이지 6개 중 0개를 찾았습니다. 그래서 첫 번째 방법은 폐기했고 그 결과도 사용하지 않았습니다.

프로브는 Xiaohongshu 노트 19개 중 0개, 더우인 영상 10개 중 0개, 빌리빌리 영상 20개 중 4개, 위챗 글 36개 중 0개를 찾았습니다. 대조군은 6개 중 6개였습니다. Xiaohongshu와 위챗에서 결과가 0건인 것은 robots.txt 규칙에 따른 것입니다. 이 파일은 접근 제어 수단이 아니라 크롤러에 보내는 요청이며, 형식은 RFC 9309에 정의되어 있습니다. 같은 시각에 같은 검색 엔진에서 site:를 붙여 주제 자체도 검색했습니다. Xiaohongshu와 위챗은 1주일 제한 여부와 관계없이 결과가 0건이었습니다.

더우인과 빌리빌리에서 결과가 0건인 것은 새 영상이 늦게 색인된다는 뜻이 아닙니다. 저희 대조군 데이터가 그 가능성을 배제합니다. 두 사이트 모두 검색 엔진이 영상 페이지를 읽도록 허용합니다. 지난 1주일로 제한했을 때 같은 검색 엔진은 해당 주제로 빌리빌리 영상 10개를 반환했는데, 모두 다운 재킷 리뷰였고 "12시간 전"부터 "6일 전"까지로 표시되어 있었습니다. 더우인 영상은 "1일 전"부터 "6일 전"까지로 표시된 9개가 반환되었지만, 그중 제목이 다운 재킷에 관한 것은 1개뿐이었습니다. 대조군에도 새 영상이 있었습니다. "1일 전"으로 표시된 더우인 영상 1개와 "6일 전"으로 표시된 빌리빌리 영상 1개였으며, 프로브는 두 영상을 모두 제목으로 찾았습니다.

따라서 데이터가 보여 주는 것은 한 가지뿐입니다. 앱이 "좋아요순" 또는 기본 정렬로 반환한 행은 웹 검색 엔진의 상위 10개에 없었습니다. 빌리빌리에서 적중한 4개는 각각 게시된 지 16.1일, 1,070.6일, 1,386.1일, 2,113.4일 된 영상이었습니다. 최근 7일 이내 영상 13개는 하나도 찾지 못했습니다. 이는 느린 색인보다는 순위 기준이 다르다는 점을 시사합니다.

에이전트 입장에서는 두 가지를 알 수 있습니다. 웹 검색이 어떤 영상을 반환할지는 통제할 수 없으며, 그 결과는 앱 자체의 "좋아요순"이나 "최신순"과 일치하지 않습니다. 또한 검색 결과에는 해당 영상의 좋아요 수, 댓글 수, 저장 수가 포함되지 않습니다.

이 결과를 Yuanbao에 대한 테스트로 해석해서는 안 됩니다. Yuanbao는 별도의 색인을 사용하며, 텐센트는 몇 분 안에 업데이트된다고 밝힙니다(Yuanbao Search 제품 개요). Yuanbao가 보유한 앱 페이지와 그 순위는 Google과 다를 수 있습니다. Xiaohongshu가 Sogou 크롤러를 허용하므로 Yuanbao가 일부 Xiaohongshu 노트 페이지를 보유하고 있을 수 있습니다.

얼마나 보유하고 있는지는 측정하지 못했습니다. 확실한 점은 두 가지입니다. 첫째, 색인된 페이지라도 좋아요 수나 댓글 수 없이 반환됩니다. 둘째, 텐센트 스스로 위챗 공식 계정 글은 지원 범위가 아니라고 밝히고 있습니다.

Yuanbao Search API란 무엇인가: 11월 6일 확인한 문서 기준

Yuanbao Search는 제품명이며, 텐센트 클라우드 API에서의 코드는 wsa입니다. 제품 업데이트 페이지에 따르면 2025-07-01에 "웹 검색 API"라는 이름으로 출시되었습니다. 2026-01-21에 Lite 에디션이, 2026-05-29에 Flagship 에디션이 추가되었습니다. Yuanbao Search로 이름이 바뀐 것은 2026-10-09입니다. 10월 20일 출시는 기존 내부 서비스를 외부 사용자에게 공개한 것입니다.

Phoenix Tech의 10월 20일 보도에 따르면 이 색인은 수천억 개의 페이지를 보유하고 있습니다. 이 서비스는 하루 수억 건의 호출을 처리하며 50개가 넘는 텐센트 제품에 쓰이고 있습니다. 여기에는 WorkBuddy, ima, Tencent Financial Technology, 텐센트 비디오가 포함됩니다. 같은 보도에 따르면 금융, 건강, 법률, 여행 등 13개 분야의 신뢰할 수 있는 출처 157곳과 연결되어 있습니다. 아래 표는 저희가 확인한 사실을 정리한 것입니다. 각 페이지는 11월 6일 싱가포르 시간 00:13~00:41에 확인했습니다.

문서에 나오지 않는 내용도 있으며, 저희가 임의로 채우지 않았습니다. 과금 페이지에는 실패한 호출은 무료라고 되어 있지만, 결과가 0건인 호출을 성공으로 보는지는 나와 있지 않습니다. 과금 페이지와 환불 페이지에는 무료 할당량에 대한 언급이 전혀 없습니다.

MCP 페이지는 현재 규칙을 확인하려면 콘솔의 "이벤트" 페이지로 가라고 안내합니다. 2,000건과 6,000건이라는 수치는 언론 보도에서 나온 것입니다. 제품 개요는 텐센트 콘텐츠 출처 세 가지를 명시하지만 Xiaohongshu, 더우인, 빌리빌리에 대해서는 아무 언급이 없습니다. 마지막으로 과금 페이지의 단위는 "호출 1,000건당" 하나뿐이며, 결과 50개가 10개보다 비싼지는 나와 있지 않습니다.

Yuanbao Search API 가입 방법과 달러로 환산한 비용

API 키 가이드에는 네 단계가 나와 있습니다. 텐센트 클라우드 계정을 만들고 개인 또는 기업 실명 인증을 통과합니다. Yuanbao Search 콘솔에서 서비스를 활성화합니다. API 키를 생성합니다. 그런 다음 SearchPro 엔드포인트로 요청을 보냅니다. 저희가 읽은 문서는 모두 중국어 사이트에 있었으며, 중국 본토 외부에서의 가입은 테스트하지 않았습니다.

같은 페이지에는 두 가지 제한이 있습니다. 계정 또는 하위 계정 하나당 API 키는 동시에 최대 3개까지 보유할 수 있습니다. 평문 키는 생성할 때 한 번만 표시되므로 그때 저장해야 합니다. 하위 계정이 키를 생성하려면 먼저 주 계정에서 서비스 읽기·쓰기 권한을 부여받아야 합니다. FAQ에 따르면 요금이 연체된 계정은 서비스를 활성화할 수 없습니다.

무료 할당량은 주의해서 봐야 합니다. MyDrivers의 10월 20일 15:55 보도에 따르면 매월 무료 호출 2,000건이 제공됩니다. 같은 날 18:15에 나온 MyDrivers의 두 번째 보도는 이를 기간 한정 혜택이라고 하면서도 종료일은 밝히지 않았습니다.

10월 22일 Eastmoney 게시물에 따르면 10월과 11월에는 초대 코드로 할당량을 월 6,000건까지 늘릴 수 있습니다. 텐센트 문서에는 세 가지 접근 방식이 하나의 할당량을 공유하는지 나와 있지 않습니다. Zhihu 칼럼은 공유한다고 설명합니다. 무료 할당량은 장기 예산의 일부가 아니라 테스트용 여유분으로 보는 것이 좋습니다.

달러 기준으로 가격을 비교하기 위해 중국 국가외환관리국이 발표한 2026-11-05 기준환율(중간가)을 사용했습니다. 환율은 1달러당 6.7156위안이었습니다. Yuanbao의 달러 금액은 모두 근삿값입니다.

환불 규정은 간단합니다. 패키지의 1년 유효기간 안에는 사용하지 않은 분량을 환불받을 수 있으며, 쿠폰 금액은 차감됩니다. 종량제 요금은 환불되지 않습니다. 에이전트 프로젝트라면 무료 할당량과 종량제로 시작해 월간 사용량을 측정하고, 사용량이 안정된 뒤에 패키지를 구매하세요. 100만 건 패키지는 종량제보다 호출당 약 7.5% 저렴합니다.

Yuanbao Search API 반환값: 웹 필드는 있지만 참여 지표는 없다

SearchPro는 결과를 Pages 배열에 담습니다. 각 요소가 JSON 문자열이므로 클라이언트에서 한 번 더 파싱해야 합니다(SearchPro API 레퍼런스). 에디션마다 반환하는 필드가 다릅니다. 이미지 필드는 API 레퍼런스에서는 pics, API 키 가이드의 예시에서는 images입니다. 두 이름이 모두 확인되었으므로 필드를 매핑하기 전에 실제 응답을 확인하세요.

요청 파라미터는 유연하게 구성할 수 있습니다. 아래 표에 API 레퍼런스의 각 파라미터를 정리했습니다. Lite는 Mode, Cnt, Industry를 지원하지 않습니다.

이 옵션들은 배경 조사에 적합합니다. 에이전트는 최근 7일간의 뉴스를 요청하거나, 특정 브랜드 사이트에서 공식 입장을 검색할 수 있습니다. 하지만 "이 리뷰에 좋아요를 누른 사람이 몇 명인가"라는 질문에는 도움이 되지 않습니다. 아래 차트는 Yuanbao의 필드 목록과 저희가 실제로 받은 행을 나란히 보여 줍니다. Yuanbao 열에는 저희 목록 중 게시 시각만 있고 나머지는 없습니다. Xiaohongshu, Douyin, Bilibili 열에는 모든 행에 좋아요, 댓글, 저장 수, 게시 시각이 있습니다.

EveryInfra 쪽 필드 이름은 각 카탈로그의 response_fields 목록에서 가져왔습니다. Xiaohongshu 카탈로그에는 like_count, collect_count, comment_count, share_count, posted_at과 협찬 노트를 나타내는 is_cooperation_note가 있습니다. Douyin 카탈로그에는 author_follower_count, view_count, is_ad가 추가됩니다. Bilibili 카탈로그에는 view_count, 화면 댓글(탄막) 수인 danmaku_count, favorite_count, coin_count가 있습니다.

차트에서 두 셀은 설명이 필요합니다. 이번에는 Xiaohongshu의 share_count가 19개 행 모두에서 비어 있었고, Bilibili의 공유 수도 비어 있었습니다. 따라서 공유 수를 세 앱의 공통 지표로 다루지 마세요.

Douyin의 view_count는 10개 행 모두에서 비어 있었으므로, Douyin 조회수는 다른 호출로 가져오세요. Xiaohongshu의 협찬 플래그와 두 인증 플래그는 모든 행에서 false였고, Douyin의 광고 플래그는 비어 있었습니다. 쿼리를 하나만 실행했기 때문에 이 값들이 실제 값인지 기본값인지 판단할 수 없습니다. 그래서 저희는 이 값들을 광고 필터링에 사용하지 않습니다.

테스트 1: 중국 앱 4개에 쿼리 하나 보내기

모든 호출은 싱가포르 시각 11월 6일 00:17~00:20에 POST /api/v1/social로 보냈습니다. 쿼리는 "다운재킷 리뷰"를 뜻하는 중국어 문구였습니다. 호출 2건은 이 테스트 키에 적용된 분당 10회의 요청 속도 제한에 걸려 429를 반환했으며, 과금되지 않았습니다. 최근 30일 좋아요순으로 정렬한 Xiaohongshu 호출 1건은 0개 행을 반환했고, 시스템이 가차감된 금액을 환불했습니다. Douyin 호출 1건은 일부러 잘못된 정렬 값을 넣어 422를 반환했습니다. 과금된 호출 6건의 비용은 총 $0.028557이었습니다.

Xiaohongshu는 2026-11-02부터 2026-11-05 사이에 게시된 영상 노트 19개를 반환했습니다. 좋아요 수 중앙값은 9개였습니다. 상위 노트는 좋아요 334개, 댓글 14개, 저장 101개였고, 19개 중 6개에는 아직 댓글이 없었습니다. "최신순" 정렬은 게시된 지 몇 시간밖에 안 된 게시물을 반환하므로 수치가 낮습니다. 이 결과는 "이번 주 사람들이 어떤 브랜드를 테스트하는가"에 답할 뿐, "어떤 리뷰가 가장 인기 있는가"에는 답하지 못합니다. 좋아요순으로 정렬한 첫 호출은 0개 행을 반환했으며, 응답에는 사유로 empty_result_refunded가 표시되었습니다.

Douyin은 "좋아요순, 최근 1주" 조건으로 영상 10개를 반환했습니다. 좋아요 수는 1,507~17,048개, 중앙값은 4,896.5개였고, 10개 영상의 댓글은 총 4,501개였습니다. 상위 영상은 좋아요 17,048개, 댓글 853개, 저장 6,699개, 공유 3,674회를 기록했습니다. 두 번째 영상은 Bosideng 브랜드에 관한 영상으로, 좋아요 15,377개, 공유 15,860회였습니다. 작성자 팔로워 수는 137명부터 464,930명까지 분포했습니다. 팔로워가 137명인 계정도 좋아요 8,217개와 댓글 1,433개를 기록했으므로, 팔로워 수로 필터링하면 바이럴 영상을 놓치게 됩니다.

Bilibili는 기본 정렬로 영상 20개를 반환했으며, 조회수는 0~1,695,719회, 중앙값은 1,047.5회였습니다. 20개 영상의 화면 댓글(탄막)은 총 3,447개였고, 4개는 게시된 지 1년이 넘은 영상이었습니다. 상위 영상은 리뷰 크리에이터가 2023-12-01에 올린 비교 테스트 영상으로, 조회수 1,695,719회, 좋아요 44,806개, 댓글 3,678개를 기록했습니다. 이어서 bilibili/comments로 이 영상의 상위 댓글을 가져왔습니다. 상위 댓글 3개의 좋아요는 각각 3,999개, 1,843개, 1,831개였고, 첫 번째 댓글은 한 시청자가 테스트 결과를 짧게 요약한 내용이었습니다. 웹 검색으로 영상 페이지는 찾을 수 있지만, 그 아래 달린 댓글의 순위는 매길 수 없습니다.

테스트 2: 앱 내 결과는 얼마나 최신일까

제품 관련 질문은 시점이 중요합니다. 지난겨울의 리뷰보다 이번 주의 불만이 더 많은 것을 알려 줍니다. 호출 시각인 2026-11-05T16:19:30Z를 기준으로 각 행의 경과 기간을 측정했습니다. 구간은 1일 미만, 1~7일, 7~30일, 30일 초과의 4개입니다. Xiaohongshu 노트 19개는 모두 7일 미만이었고, 그중 12개는 1일 미만이었으며, 경과 기간 중앙값은 0.47일이었습니다. Douyin 영상 10개는 publish_time=one_week를 보냈기 때문에 모두 7일 미만이었고, 중앙값은 2.56일이었습니다.

나머지 두 앱은 새 콘텐츠와 오래된 콘텐츠가 섞여 있습니다. Bilibili의 기본 정렬은 7일 미만 영상 13개와 30일 초과 영상 6개를 반환했으며, 가장 오래된 영상은 2021-01-22에 게시되었습니다. WeChat은 최근 30일 이내 기사 24개와 그보다 오래된 기사 12개를 반환했으며, 가장 오래된 기사는 2024-12-18에 게시되었습니다. 에이전트는 이 행들을 모델에 보내기 전에 posted_at으로 필터링해야 합니다. 그렇지 않으면 모델이 2021년 리뷰를 올해의 의견처럼 제시할 수 있습니다.

Yuanbao에도 웹 결과를 최근 N일로 제한하는 자체 시간 필터 Freshness가 있습니다. 이 필터와 앱 내 date_range, publish_time 옵션은 비슷한 역할을 합니다. 다만 차이가 하나 있습니다. Yuanbao의 date는 웹 페이지의 게시 시각입니다. 앱 내 posted_at은 노트나 영상 자체가 올라간 시각입니다. 재게시물이나 애그리게이터 페이지에서는 두 시각이 다를 수 있으므로, 각 시각에 출처를 표시하세요.

WeChat의 공백: Yuanbao가 제외한 유일한 소스

Yuanbao FAQ에는 WeChat 공식 계정 콘텐츠를 포함하는지 직접 묻는 질문이 있습니다. 답은 "콘텐츠 저작권 때문에" 포함하지 않는다는 것입니다(Yuanbao Search FAQ). 문서에서 명시적으로 제외한 콘텐츠 소스는 WeChat뿐입니다. 제품 조사에서 WeChat은 장문 리뷰가 많이 올라오는 곳입니다. 저희 쿼리는 25개 계정의 기사 36개를 반환했으며, 가장 오래된 기사는 2024-12-18에 게시되었습니다.

EveryInfra의 두 기능으로 이 공백을 메울 수 있습니다. wechat_oa/article_search는 키워드로 기사를 검색해 제목, 요약, 링크, 계정 이름, 게시 시각을 반환합니다. 한 번의 호출로 기사 36개를 반환했고 비용은 $0.008이었습니다. wechat_oa/article_metrics는 기사 링크 하나를 받아 조회수, 좋아요, "wow" 수, 공유, 저장, 댓글을 반환하며, 비용은 기사당 $0.005556입니다. 플랫폼 개요는 WeChat 공식 계정 API 페이지에서 확인할 수 있습니다.

소비자 테스트 계정 Laoba Pingce가 2025-11-19에 게시한 리뷰로 테스트했습니다. 이 리뷰는 다운재킷 14개를 테스트한 글입니다. 호출 결과는 read_count 100001, like_count 2763, watching_count 1455, share_count 7763, collect_count 932, comment_count 94였습니다. WeChat은 인기 기사에 "100,000+"로 표시하므로, 100001은 이 표시를 나타내는 값이자 하한값일 가능성이 높습니다. 다만 이를 명시한 문서는 찾지 못했습니다. 답변에는 "조회수 100,000회 이상"으로 쓰세요.

이 기사는 공유가 7,763회였지만 좋아요는 2,763개에 그쳤습니다. Douyin의 Bosideng 영상에서도 공유가 좋아요보다 많은 같은 패턴이 나타났습니다. 리뷰 콘텐츠는 좋아요보다 공유를 통해 퍼집니다. 좋아요만으로 리뷰 순위를 매기는 에이전트는 이런 게시물을 과소평가하게 됩니다. 공유와 저장 수도 함께 반영하면 순위가 실제 독자 행동에 더 가까워집니다.

한 에이전트에서 Yuanbao MCP 서버와 EveryInfra MCP 서버를 함께 쓰는 방법(설정 예시)

두 서비스 모두 원격 MCP 서버입니다. 둘 다 Streamable HTTP를 사용하며, Authorization 헤더에서 Bearer 토큰을 읽습니다. Yuanbao 서버의 도구는 SearchPro 하나입니다(Yuanbao MCP 페이지). EveryInfra 서버는 싱가포르 시각 11월 6일 00:24에 tools/list로 도구 12개를 반환했습니다. 핵심 도구는 앱과 기능 목록을 무료로 조회하는 everyinfra_list_capabilities, 기능을 실행하는 everyinfra_call_api, 비동기 결과를 읽는 everyinfra_get_job입니다.

전송 방식은 MCP 2025-06-18 사양의 Transports 섹션에 정의되어 있습니다. 클라이언트는 Lifecycle 섹션에 설명된 대로 먼저 initialize를 보내 프로토콜 버전에 합의합니다. 그다음 Tools 섹션에 설명된 대로 tools/list와 tools/call을 사용합니다. HTTP에서는 initialize 이후의 모든 요청에 MCP-Protocol-Version 헤더를 보내야 합니다. 대부분의 클라이언트는 이 헤더를 자동으로 추가합니다.

아래 블록은 Claude Code 프로젝트 루트에 두는 .mcp.json 파일입니다. 두 서버를 나란히 정의하고, 두 키 모두 환경 변수에서 읽습니다. Tencent 샘플은 "type": "streamableHttp"를 사용합니다. 2026-11-02에 업데이트된 Claude Code MCP 문서에 따르면 type에는 http를 쓸 수 있으며, streamable-http는 별칭입니다. 카멜 케이스 형식은 이 목록에 없으므로 Claude Code에서는 http를 사용하세요. Cursor 등 다른 클라이언트는 해당 클라이언트의 문서를 따르세요.

{
  "mcpServers": {
    "yuanbao-websearch-mcp": {
      "type": "http",
      "url": "https://api.wsa.cloud.tencent.com/Mcp",
      "headers": {
        "Authorization": "Bearer ${WSA_API_KEY}"
      }
    },
    "everyinfra": {
      "type": "http",
      "url": "https://api.everyinfra.com/mcp",
      "headers": {
        "Authorization": "Bearer ${EVERYINFRA_API_KEY}"
      }
    }
  }
}

연결한 뒤 tools/list를 한 번 실행해 SearchPro의 입력 스키마를 확인하세요. Tencent MCP 페이지는 내용이 일관되지 않습니다. 파라미터 표에는 Query, Site, Mode, Freshness, Cnt, Industry가 나와 있습니다. 그런데 같은 페이지에 포함된 도구 정의는 Freshness 대신 Unix 타임스탬프 형식의 FromTime과 ToTime을 사용하고, Mode의 타입을 문자열로 지정합니다. 믿을 수 있는 답은 직접 실행한 tools/list 결과뿐입니다. MCP Inspector를 사용하면 코드 없이 두 서버의 도구 목록을 확인할 수 있습니다.

두 서버 모두 MCP 사양의 OAuth 플로가 아닌 정적 Bearer 키를 사용합니다. Bearer 헤더 형식은 RFC 6750을 따릅니다. 직접 작성한 스크립트에서 MCP 엔드포인트를 호출한다면, 초기화 이후의 모든 요청에 MCP-Protocol-Version 헤더를 보내세요. 이 규칙은 2025-06-18 릴리스에서 추가되었습니다(2025-06-18 변경 내역). Tencent 페이지는 버전을 "2025-6-18"로 표기하는데, 같은 릴리스입니다. Claude Code나 Cursor 같은 클라이언트는 이 헤더를 자동으로 보냅니다.

Yuanbao Search는 SkillHub의 Yuanbao Search 페이지에서 스킬로도 제공됩니다. 이 스킬은 실행할 때마다 먼저 환경 변수 TENCENTCLOUD_WSA_APIKEY를 확인합니다. 그다음 --query 값과 선택 사항인 --site 값을 사용해 scripts/websearch.py를 실행합니다. 스킬과 MCP 서버는 같은 키로 같은 SearchPro API를 호출합니다. 스킬을 불러오는 에이전트 도구에서는 스킬을, MCP 서버를 불러오는 클라이언트에서는 MCP 서버를 사용하세요.

두 서버를 설정했다면 에이전트의 시스템 프롬프트에 라우팅 규칙이 필요합니다. 앱 이름이 아니라 질문에 필요한 정보를 기준으로 라우팅하세요. 아래 표는 저희가 권장하는 규칙입니다. Yuanbao는 "무엇이며 출처가 어디인가"에 답합니다. 앱 내 호출은 "몇 명이 말하는가, 무엇을 말하는가, 언제부터인가"에 답합니다.

웹 검색 단계에 꼭 Yuanbao를 쓸 필요는 없습니다. EveryInfra에도 웹 검색 기능인 web/search가 있습니다. 카탈로그 기준 가격은 호출당 $0.001389, 호출 1,000건당 $1.389입니다(2026년 11월 6일 확인). Tencent의 과금 페이지에 따르면 Yuanbao Standard는 호출 1,000건당 20위안입니다. 2026-11-05 기준환율인 달러당 6.7156위안으로 환산하면 약 $2.978입니다. Lite는 14위안으로 약 $2.085입니다.

두 서비스는 용도가 다릅니다. Yuanbao는 공개 웹에 더해 Tencent News, Sogou Baike, Penguin 계정 콘텐츠를 제공합니다. Industry 필터와 Mode=1 실시간 카드를 지원하고, Standard에서는 호출당 최대 50개 행을 반환하며, 한정된 무료 할당량이 있습니다. 중국 뉴스, 참고 정보, 정책 관련 질문에 사용하세요.

web/search는 호출당 최대 10개 행을 반환하며, 각 행에는 제목, 링크, 스니펫, 순위, 게시일이 들어 있습니다. 선택 파라미터로 country와 language 값을 받습니다. 앱 내 기능과 동일한 API 키, 청구 체계, MCP 서버를 사용합니다. Tencent Cloud 계정을 만들고 싶지 않은 팀에 적합합니다. 이번 테스트에서는 web/search를 호출하지 않았으므로 필드와 가격은 카탈로그 기준입니다.

일반 HTTP로 호출하기: curl 요청 두 개

MCP를 거치지 않고 두 서비스를 HTTP로 직접 호출할 수도 있습니다. Yuanbao의 API 키 방식은 Bearer 헤더만 있으면 되며 Tencent Cloud API 3.0 서명이 필요 없습니다(API 키 가이드). 서명 방식을 쓰려면 wsa 패키지가 포함된 Tencent Cloud SDK를 사용하세요. Python 클라이언트와 models.py부터 살펴보세요. 다른 언어용 코드는 각 TencentCloud SDK 저장소의 wsa/v20250508 경로에 있습니다. 예를 들어 Go와 Node.js가 있습니다.

아래 첫 번째 요청은 실행하지 않은 Yuanbao 구성 예시입니다. 두 번째 요청은 싱가포르 시간 00:19:14에 실제로 보낸 요청입니다. 중국어 쿼리는 JSON 이스케이프 시퀀스로 작성했으므로 어떤 셸에든 그대로 붙여 넣을 수 있습니다. 서버는 이스케이프를 일반 중국어 텍스트로 디코딩합니다.

# Configuration example, not run: Yuanbao Standard, last 7 days, 20 results
curl -s https://api.wsa.cloud.tencent.com/SearchPro \
  -H "Authorization: Bearer $WSA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"Query":"羽绒服 测评","Freshness":"d7","Cnt":20}'
# Each item in Pages is a JSON string: parse it again

# Real request: EveryInfra Douyin search, most liked, last week
curl -s https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"douyin","action":"search","params":{"keyword":"羽绒服 测评","sort":"most_liked","publish_time":"one_week"}}'
# Returns count, results[] (like_count, comment_count, collect_count, share_count, posted_at) and billing.charged_usd

EveryInfra 응답은 일반 JSON 객체입니다. results는 배열이며, 각 행에는 카탈로그의 response_fields에 정의된 필드가 들어 있습니다. billing.charged_usd는 이번 호출에 과금된 금액입니다. pagination.has_more는 다음 페이지가 있는지 알려 주며, 다음 페이지를 받으려면 next_page_token을 page_token으로 다시 전달합니다.

오래 걸리는 호출에는 요청 본문에 "mode":"async"를 추가하세요. 그러면 즉시 HTTP 202와 job_id를 받고, /api/v1/jobs/{job_id}를 폴링하면 됩니다. 동기 호출의 제한 시간은 85초입니다. 카탈로그는 무료로 조회할 수 있습니다.

양쪽의 오류 처리와 과금

에이전트는 재시도를 하므로, 에이전트를 연결하기 전에 과금 규칙을 파악해 두세요. Yuanbao 과금 페이지에 따르면 실패한 호출은 무료입니다. API 레퍼런스에는 오류 코드 6개가 나와 있습니다. InternalError와 InvalidParameter는 일반 오류입니다.

RequestLimitExceeded는 요청이 너무 많다는 뜻입니다. ResourceNotFound는 서비스가 개통되지 않았다는 뜻이며, MCP 페이지에 따르면 활성화에는 몇 분이 걸립니다. ResourceUnavailable은 대개 계정이 연체 상태라는 뜻입니다. UnauthorizedOperation은 키가 잘못되었거나 삭제되었다는 뜻입니다. EveryInfra는 실패하거나 결과가 비어 있는 호출에는 요금을 청구하지 않으며, 파라미터가 잘못된 호출은 과금 전에 차단합니다.

싱가포르 시간 00:19:57의 테스트 호출에서는 일부러 sort=hot을 보냈습니다. 오류 메시지는 sort 값이 most_liked, newest, relevance 중 하나여야 한다고 알려 주었고, did_you_mean은 most_liked를 제안했습니다. next_steps의 첫 줄은 sort만 바꿔 다시 보내라고 안내하면서 요금이 부과되지 않았다고 알려 주었습니다.

모델은 이 메시지를 읽고 스스로 호출을 수정할 수 있습니다. HTTP 429는 RFC 6585에 정의되어 있으며, 올바른 대응은 즉시 재시도하지 않고 기다리는 것입니다.

429 응답 두 건은 Xiaohongshu와 Douyin 호출에서 나왔습니다. retry_after 값은 각각 8초와 1초였고, 사유는 이 테스트 키 자체의 한도를 뜻하는 key_limit이었습니다. 재시도 로직은 retry_after만큼 기다린 뒤 다시 보내도록 구현하세요. 약 74초 후 두 호출을 다시 보냈고, 둘 다 결과를 반환했습니다. 일반적인 상태 코드 규칙은 RFC 9110에 나와 있습니다.

질문 1,000건당 비용

호출 1,000건 기준으로 Yuanbao Standard는 약 $2.978입니다. EveryInfra web/search는 $1.389입니다. bilibili/search는 $0.556으로 Yuanbao보다 저렴합니다. xiaohongshu/search는 $5.556으로 Yuanbao Standard의 약 1.9배입니다. wechat_oa/article_search는 $8.0, douyin/search는 $8.333으로 약 2.8배입니다.

행 1,000개 기준으로 보면 순서가 달라집니다. Xiaohongshu는 호출당 19개 행을 반환해 행 1,000개당 약 $0.2924입니다. Douyin은 10개 행으로 약 $0.8333, Bilibili는 20개 행으로 약 $0.0278, WeChat은 36개 행으로 약 $0.2222입니다.

각 가격은 요금 페이지에서도 확인할 수 있습니다. Xiaohongshu 검색, Douyin 검색, Bilibili 검색 등 각 기능 페이지에도 표시되어 있습니다.

다음은 조합입니다. 질문 1,000건 기준으로 세 가지 플랜의 비용을 계산했습니다. 플랜 A는 질문마다 Yuanbao Standard를 한 번 호출하며 비용은 $2.978입니다.

플랜 B는 모든 질문에 Yuanbao와 네 앱을 모두 호출하며 비용은 $25.423입니다. 플랜 C는 모든 질문에 Yuanbao와 Bilibili를 호출하고, Xiaohongshu는 질문의 40%에서, Douyin과 WeChat은 각각 질문의 20%에서 호출하며 비용은 $9.023입니다. 40%와 20%는 측정값이 아니라 저희가 가정한 비율입니다. 실제 비율은 "사람들 반응이 어떤지"를 묻는 질문이 얼마나 많은지에 따라 달라집니다.

플랜 C로 한 달에 질문 3,000건을 처리하면 Yuanbao 호출 중 2,000건은 무료 할당량에 포함됩니다. 나머지 1,000건은 약 $2.978입니다. 앱 내 호출 비용은 $6.045의 3배인 $18.135입니다.

합계는 약 $21.113입니다. 무료 할당량은 한정 혜택이므로 할당량이 없는 경우의 월 비용도 계산해 두세요. 이 경우 Yuanbao 호출 3,000건은 약 $8.934, 합계는 약 $27.069입니다. 웹 단계에 web/search를 쓰면 3,000건 호출에 $4.167, 합계는 약 $22.302입니다.

무료 할당량이 남아 있는 동안에는 비용 대부분이 앱 쪽에서 발생합니다. 가장 효과적으로 비용을 줄이려면 가장 비싼 두 기능인 Douyin 검색과 WeChat 검색을 질문에 필요할 때만 호출하세요. Bilibili 검색은 매번 호출해도 될 만큼 저렴합니다.

답변에 출처를 표기하는 방법

웹 결과와 앱 데이터가 한 답변에 함께 들어가면, 독자는 어떤 줄이 뉴스에서 왔고 어떤 줄이 사용자에게서 왔는지 구분할 수 있어야 합니다. 실제 응답 행으로 형식 샘플을 만들었습니다. Yuanbao 부분은 실행하지 않았으므로 자리표시자로 표시했습니다. 첫 문단은 다운재킷 표준이나 가격 변화 같은 배경을 설명합니다. 이 문단은 줄마다 사이트 이름과 date를 붙여 Yuanbao 웹 결과를 인용합니다.

둘째 문단은 사용자 반응을 다룹니다. 지난 일주일간 좋아요가 가장 많은 Douyin 영상 10개 중 Bosideng의 제품 품질을 다룬 영상은 좋아요 15,377개, 공유 15,860회를 기록했습니다. 조회수가 가장 많은 Bilibili 테스트 영상은 조회수 1,695,719회였고, 해당 영상의 최상위 댓글은 좋아요 3,999개를 받았습니다. 각 줄에는 앱 이름, 게시일, 데이터를 읽은 시각을 적습니다. 셋째 문단은 장문 리뷰를 다룹니다. 예를 들어 2025-11-19에 게시된 Laoba Pingce 글은 조회수 100,000회 이상, "wow" 클릭 1,455회를 기록했습니다. 마지막 줄에는 "앱 데이터 기준: 2026-11-06 00:20 SGT"라고 적습니다. 다음 호출 때 수치가 바뀌기 때문입니다.

이 형식에는 두 가지 장점이 있습니다. 각 수치는 출처가 된 호출 하나까지 추적할 수 있으므로 독자나 검토자가 링크를 열어 확인할 수 있습니다. 또한 모델에는 행마다 제목, 링크, 몇 가지 수치, 게시 시각만 있으면 됩니다.

전체 페이지가 필요 없으므로 입력이 짧게 유지됩니다. Yuanbao의 passage와 content 요약은 배경 문단에, 앱 행은 근거 문단에 들어갑니다. 슬롯을 고정하면 모델이 일관된 구조로 답변을 작성합니다.

DeepSeek Search 글과 무엇이 다른가

11월 3일에 게시한 DeepSeek Search API 글도 같은 문제에서 출발합니다. 웹 검색 API는 참여 지표를 반환하지 않는다는 점입니다. 두 글은 세 가지 면에서 다릅니다. 첫째, 검색 API입니다. 이전 글은 10월 17일 성공한 요청 1,000건당 5위안으로 공개된 DeepSeek Search 및 Fetch를 다룹니다. 이번 글은 Tencent의 Yuanbao Search를 다룹니다. Yuanbao Search는 Tencent News, Sogou Baike, Penguin 계정을 추가로 제공하지만 WeChat은 제외하므로, 이번 글에서는 WeChat을 별도 섹션으로 다룹니다.

둘째, 통합 방식입니다. 이전 글은 OpenAI 스타일 채팅 API용으로 함수 정의 4개와 tool_calls 루프를 작성합니다. 이번 글은 원격 MCP 서버 두 개를 나란히 연결하며, 디스패치 코드가 필요 없습니다.

셋째, 대상 앱입니다. 이전 글은 주로 텍스트와 Q&A 중심인 Xiaohongshu, Zhihu, Weibo를 다룹니다. 이번 글은 Xiaohongshu, Douyin, Bilibili, WeChat을 다룹니다. Douyin과 Bilibili는 동영상 앱이므로 조회수, 탄막, 공유 수, 팔로워 수를 추가로 다룹니다.

중국 시장용으로 개발한다면 두 글을 모두 읽어 보세요. 에이전트가 DeepSeek 모델에서 실행되고 각 단계를 직접 제어하고 싶다면 DeepSeek 글의 함수 패턴을 쓰세요. Claude Code, Cursor 등 MCP 클라이언트를 쓴다면 이 글의 나란히 연결하는 구성을 쓰세요. 두 검색 API를 모두 연결하고 가격과 콘텐츠 출처에 따라 라우팅할 수도 있습니다.

한계와 주의 사항

Yuanbao Search는 직접 호출하지 않았습니다. Yuanbao에 관한 내용은 모두 공식 문서와 언론 보도를 바탕으로 하며, 이 글의 Yuanbao 요청과 구성은 모두 구성 예시입니다. 문서 간에도 약간 맞지 않는 부분이 있습니다.

MCP 페이지의 표와 페이지에 포함된 도구 스키마는 시간 필터 설명이 서로 다릅니다. 이미지 필드는 한 예시에서는 images, 레퍼런스에서는 pics입니다. 언론 보도에 나온 재현율도 MyDrivers는 94%, Eastmoney는 93%로 서로 다릅니다. 무료 할당량은 과금 페이지가 아닌 언론 보도에 나온 한정 혜택이므로 11월 이후 다시 확인하세요.

EveryInfra 쪽은 쿼리 하나만 실행했습니다. 필드 커버리지와 최신성 수치는 한 시점의 스냅샷이며 모든 주제에 적용되는 규칙은 아닙니다. 스폰서 및 인증 플래그는 모두 false였고 Douyin 광고 플래그는 비어 있었으므로, 실제 광고 비중을 보여 주지 않습니다. WeChat 조회수 100001은 하한값일 가능성이 높습니다. Douyin 검색은 조회수를 반환하지 않았습니다. 앱 내 수치는 호출할 때마다 달라지므로 모든 답변에 데이터를 읽은 시각을 명시해야 합니다.

컴플라이언스 측면에서는 서비스를 운영하는 지역과 사용자가 있는 지역의 규정을 따르세요. 중국 본토에서는 “Network Data Security Management Regulations”가 2025년 1월 1일부터 시행되었습니다. 중국 본토에서 공개 생성형 AI 서비스를 제공한다면 “Interim Measures for Generative AI Services”도 따라야 합니다. 2025년 9월 1일부터 시행된 “Measures for Labeling AI-Generated Content”도 적용됩니다. 답변에 사용자 댓글을 인용할 때는 개인 닉네임을 가리고 브랜드 및 기관 계정 이름만 남기세요.

각 앱도 오픈 플랫폼을 운영하지만 용도가 다릅니다. Xiaohongshu 오픈 플랫폼은 상점과 이커머스 도구를 위한 것입니다. Douyin 오픈 플랫폼은 Douyin 계정을 연동하는 앱과 사이트를 위한 것입니다.

Bilibili 오픈 플랫폼은 크리에이터와 서비스 제공자를 위한 것입니다. WeChat 개발자 문서는 본인이 소유한 공식 계정을 다룹니다. 이 중 어느 것도 모든 공개 노트와 영상을 대상으로 한 키워드 검색은 제공하지 않습니다. 공식 플랫폼과 서드파티 API의 차이는 Xiaohongshu API 비교 글을 참고하세요.

최근 변경 사항

2026-10-09에 '웹 검색 API'의 이름이 Yuanbao Search로 바뀌었습니다(제품 업데이트). 알아 둘 점: 예전 가이드와 SDK 패키지에서는 같은 서비스를 여전히 wsa라는 이름으로 부릅니다.

2026-10-17에 DeepSeek이 성공한 요청 1,000건당 5위안으로 Search 및 Fetch API를 공개했습니다(DeepSeek 뉴스, DeepSeek 검색 가이드). 알아 둘 점: 이제 호출 단위로 과금하는 중국어 웹 검색 API가 두 가지입니다. Yuanbao Standard의 호출당 비용은 DeepSeek의 4배이지만, 월 무료 할당량과 Tencent 콘텐츠를 제공합니다.

2026-10-20에 Tencent는 외부 개발자에게 Yuanbao Search를 공개하고 월 2,000건의 무료 호출을 제공했습니다(MyDrivers). 알아 둘 점: 이제 에이전트에 중국어 웹 검색을 붙이는 데 키 하나면 됩니다. 무료 할당량은 첫 테스트에 충분합니다.

2026-10-27에 Tencent는 Freshness 문법을 포함해 SearchPro API 레퍼런스를 업데이트했습니다(SearchPro API 레퍼런스). 알아 둘 점: 시간 필터 사양이 아직 바뀌고 있으므로 직접 확인한 tools/list 출력을 기준으로 삼으세요.

2026-11-02에 Claude Code MCP 문서가 업데이트되어 streamable-http가 http의 별칭이라고 명시했습니다. 알아 둘 점: 다른 업체의 구성을 복사할 때는 type 철자를 확인하세요.

2026-11-04에 Tencent는 AI 도구 연동 페이지를 업데이트했으며, 이 페이지에는 MCP, 스킬, 소스에서 빌드하는 자체 호스팅 MCP 서버가 나와 있습니다. 알아 둘 점: 원격 MCP 엔드포인트로 트래픽을 보내고 싶지 않은 팀은 자체 서버를 운영할 수 있습니다.

다른 업체도 같은 방향으로 움직이고 있습니다. Kimi와 Zhipu는 개발자 플랫폼 문서에서 웹 검색 도구를 안내하고 있으며, Anthropic의 웹 검색 도구는 검색 1,000건당 $10입니다. 웹 검색은 모델 플랫폼의 기본 구성 요소가 되어 가고 있습니다. 앱 내부 데이터는 여전히 별도의 연결이 필요합니다.

FAQ

Yuanbao Search API는 무료인가요? 몇 번까지 호출할 수 있나요?

제한된 무료 할당량이 있습니다. 10월 20일 보도에 따르면 월 2,000회이며, 스킬, MCP, API가 이 할당량을 함께 사용합니다. 초대 코드가 있으면 10월과 11월에 월 최대 6,000회까지 사용할 수 있습니다.

Tencent 과금 페이지에는 이 할당량이 언급되어 있지 않습니다. 할당량을 초과하면 종량제로 호출 1,000건당 14위안, 20위안 또는 26위안이 부과됩니다. (질문 출처: "yuanbao search free" 및 "tencent yuanbao api" 검색어 추천. 근거: MyDrivers, Eastmoney, 과금 개요.)

Claude Code나 Cursor에 Yuanbao MCP 서버를 추가하려면 어떻게 하나요?

엔드포인트는 HTTPS 기반의 api.wsa.cloud.tencent.com/Mcp이며, Authorization: Bearer 헤더에 Yuanbao API 키를 넣습니다. Cursor 등 유사한 클라이언트는 Tencent의 샘플 설정을 사용할 수 있습니다. Claude Code에서는 type을 http로 설정해야 합니다. 샘플에 있는 카멜 케이스 값은 Claude Code가 지원하는 목록에 없습니다. 연결한 뒤에는 tools/list를 실행해 확인하세요. (질문 출처: "tencent yuanbao mcp" 검색어 추천. 근거: Yuanbao MCP 페이지, Claude Code MCP 문서.)

중국 밖에서도 Yuanbao Search API를 사용할 수 있나요?

저희가 확인한 문서는 중국어판 Tencent Cloud 사이트에만 있으며, 가입하려면 개인 또는 기업 실명 인증이 필요합니다. 중국 본토 밖에서의 가입은 테스트하지 않았으므로 가능 여부를 확인해 드릴 수 없습니다. API 자체는 Bearer 키를 사용하는 일반 HTTPS 방식입니다. (질문 출처: "tencent yuanbao api" 검색어 추천. 근거: API 키 가이드.)

Xiaohongshu API는 호출 한 번에 노트를 몇 개 반환하나요?

xiaohongshu/search는 페이지당 20행을 반환하며, 다음 페이지는 page_token으로 가져옵니다. 호출 1회 비용은 $0.005556입니다. 저희가 "최근 30일, 최신순" 조건으로 호출했을 때 노트 19개가 반환되었고, 각 노트에는 좋아요, 댓글, 저장 수와 게시 시각이 포함되어 있었습니다. (질문 출처: Xiaohongshu API 노트 수량 관련 검색어 추천. 근거: Xiaohongshu 카탈로그.)

무료 중국 검색 엔진 API가 있나요?

Yuanbao Search는 월 2,000회의 제한된 무료 할당량을 제공합니다. DeepSeek Search는 성공한 요청 1,000건당 5위안이며, 문서에서 별도의 무료 검색 할당량은 확인하지 못했습니다. EveryInfra 카탈로그와 MCP tools/list는 무료로 조회할 수 있습니다. 호출은 건별로 과금되며, 실패하거나 빈 결과를 반환한 호출에는 비용이 부과되지 않습니다. (질문 출처: "free search engine api" 검색어 추천. 근거: MyDrivers, DeepSeek 검색 가이드, Bilibili 카탈로그.)

시작하는 방법

첫째, EveryInfra 빠른 시작에서 API 키를 만듭니다. 카탈로그는 무료로 조회할 수 있습니다. xiaohongshu/search, douyin/search, bilibili/search, bilibili/comments의 파라미터와 가격을 확인하세요. 앱별 개요는 Xiaohongshu API, Douyin API, Bilibili API 페이지에 있습니다. MCP 설정 방법은 MCP 서버 페이지에서 확인할 수 있습니다.

둘째, Tencent Cloud에서 Yuanbao Search를 개통하고 API 키를 만듭니다. 두 키를 모두 환경 변수에 넣고, 위의 .mcp.json을 프로젝트 루트에 복사합니다. 셋째, 시스템 프롬프트에 라우팅 표를 추가하고 질문 하나로 테스트합니다. 그다음 질문량을 기준으로 월 비용을 추정합니다. 다른 에이전트 도구에서 비슷하게 구성한 사례는 Xiaohongshu, Douyin, JD용 WorkBuddy 커넥터에서 볼 수 있습니다.

참고 자료

1. “Yuanbao Search product overview”(중국어), Tencent Cloud 문서, 2026-10-26 업데이트, 2026-11-06 확인, https://cloud.tencent.com/document/product/1806/121794
2. “Yuanbao Search billing overview”(중국어), Tencent Cloud 문서, 2026-10-09 업데이트, 2026-11-06 확인, https://cloud.tencent.com/document/product/1806/121798
3. “Yuanbao Search refund rules”(중국어), Tencent Cloud 문서, 2026-10-09 업데이트, 2026-11-06 확인, https://cloud.tencent.com/document/product/1806/121801
4. “Yuanbao Search product updates”(중국어), Tencent Cloud 문서, 2026-10-09 업데이트, 2026-11-06 확인, https://cloud.tencent.com/document/product/1806/121792
5. “Yuanbao Search FAQ”(중국어), Tencent Cloud 문서, 2026-10-09 업데이트, 2026-11-06 확인, https://cloud.tencent.com/document/product/1806/121804
6. “SearchPro API reference”(중국어), Tencent Cloud API 문서, 2026-10-27 업데이트, 2026-11-06 확인, https://cloud.tencent.com/document/api/1806/121811
7. “Yuanbao Search API key guide”(중국어), Tencent Cloud 문서, 2026-10-09 업데이트, 2026-11-06 확인, https://cloud.tencent.com/document/product/1806/130615
8. “Yuanbao Search AI tool access”(중국어), Tencent Cloud 문서, 2026-11-04 업데이트, 2026-11-06 확인, https://cloud.tencent.com/document/product/1806/140541
9. “Yuanbao MCP server page”(중국어), Tencent Cloud 개발자 MCP 디렉터리, 2026-11-06 확인, https://cloud.tencent.com/developer/mcp/server/11764
10. “Yuanbao Search Skill”(중국어), SkillHub, 2026-11-06 확인, https://skillhub.cn/skills/tencent-yuanbao-standard-search
11. tencentcloud-sdk-python wsa_client.py, GitHub의 TencentCloud, 2026-11-06 확인, https://github.com/TencentCloud/tencentcloud-sdk-python/blob/master/tencentcloud/wsa/v20250508/wsa_client.py
12. “tencentcloud-sdk-python wsa models.py”, GitHub의 TencentCloud, 2026-11-06 열람, https://github.com/TencentCloud/tencentcloud-sdk-python/blob/master/tencentcloud/wsa/v20250508/models.py
13. “tencentcloud-sdk-go wsa client.go”, GitHub의 TencentCloud, 2026-11-06 열람, https://github.com/TencentCloud/tencentcloud-sdk-go/blob/master/tencentcloud/wsa/v20250508/client.go
14. tencentcloud-sdk-nodejs wsa_client.ts, GitHub의 TencentCloud, 2026-11-06 확인, https://github.com/TencentCloud/tencentcloud-sdk-nodejs/blob/master/src/services/wsa/v20250508/wsa_client.ts
15. “Tencent opens Yuanbao Search to outside users, with 2,000 free calls a month”(중국어), MyDrivers, 2026-10-20, https://news.mydrivers.com/1/1158/1158971.htm
16. “Tencent upgrades Yuanbao Search and opens it through Tencent Cloud”(중국어), MyDrivers, 2026-10-20, https://news.mydrivers.com/1/1159/1159052.htm
17. “Tencent Yuanbao Search opens to outside users”(중국어), Phoenix Tech, 2026-10-20, https://tech.ifeng.com/c/8xNUpH50e2g
18. “Tencent Cloud fully opens the Yuanbao Search API”(중국어), Eastmoney Caifuhao, 2026-10-22, https://caifuhao.eastmoney.com/news/20261022114426222792250
19. “Tencent Cloud announces Yuanbao Search for outside users”(중국어), Zhihu 칼럼, 2026-11-06 확인, https://zhuanlan.zhihu.com/p/2096309245318787504
20. “DeepSeek news, 2026-10-17 release”(중국어), DeepSeek API 문서, 2026-11-06 확인, https://api-docs.deepseek.com/zh-cn/news/news261017
21. “Web search and fetch guide”(중국어), DeepSeek API 문서, 2026-11-06 확인, https://api-docs.deepseek.com/zh-cn/guides/search
22. robots.txt, Xiaohongshu, 2026-11-06 00:23 SGT 확인, https://www.xiaohongshu.com/robots.txt
23. robots.txt, Douyin, 2026-11-06 00:23 SGT 확인, https://www.douyin.com/robots.txt
24. robots.txt, Bilibili, 2026-11-06 00:23 SGT 확인, https://www.bilibili.com/robots.txt
25. robots.txt, WeChat 공식 계정 플랫폼, 2026-11-06 00:23 SGT 확인, https://mp.weixin.qq.com/robots.txt
26. “RMB central parity rates”(중국어), 중국 국가외환관리국, 2026-11-05 기준 데이터, https://www.safe.gov.cn/safe/rmbhlzjj/index.html
27. “Network Data Security Management Regulations”(중국어), 중국 정부 포털, 2024-09-30 게시, https://www.gov.cn/zhengce/content/202409/content_6977766.htm
28. “Interim Measures for the Management of Generative AI Services”(중국어), 중국 국가인터넷정보판공실, 2023-07-13, https://www.cac.gov.cn/2023-07/13/c_1690898327029107.htm
29. “Measures for Labeling AI-Generated Synthetic Content”(중국어), 중국 국가인터넷정보판공실, 2025-03-14, https://www.cac.gov.cn/2025-03/14/c_1743654684782215.htm
30. “RFC 9309: Robots Exclusion Protocol”, RFC Editor, 2022-09, https://www.rfc-editor.org/rfc/rfc9309.html
31. “Transports (2025-06-18)”, Model Context Protocol 사양, 2026-11-06 확인, https://modelcontextprotocol.io/specification/2025-06-18/basic/transports
32. “Lifecycle (2025-06-18)”, Model Context Protocol 사양, 2026-11-06 확인, https://modelcontextprotocol.io/specification/2025-06-18/basic/lifecycle
33. “Tools (2025-06-18)”, Model Context Protocol 사양, 2026-11-06 확인, https://modelcontextprotocol.io/specification/2025-06-18/server/tools
34. “Authorization (2025-06-18)”, Model Context Protocol 사양, 2026-11-06 확인, https://modelcontextprotocol.io/specification/2025-06-18/basic/authorization
35. “Key Changes (2025-06-18)”, Model Context Protocol 사양, 2026-11-06 확인, https://modelcontextprotocol.io/specification/2025-06-18/changelog
36. MCP Inspector, GitHub의 modelcontextprotocol, 2026-11-06 확인, https://github.com/modelcontextprotocol/inspector
37. “Connect Claude Code to tools via MCP”, Claude Code 문서, 2026-11-02 업데이트, https://code.claude.com/docs/en/mcp
38. “Web search tool”, Claude 문서, 2026-11-06 확인, https://docs.claude.com/en/docs/agents-and-tools/tool-use/web-search-tool
39. “Use web search”(중국어), Kimi 개발자 플랫폼 문서, 2026-11-06 확인, https://platform.moonshot.cn/docs/guide/use-web-search
40. “Web search tool”(중국어), Zhipu 개발자 플랫폼 문서, 2026-11-06 확인, https://docs.bigmodel.cn/cn/guide/tools/web-search
41. “Xiaohongshu open platform”(중국어), Xiaohongshu, 2026-11-06 확인, https://open.xiaohongshu.com/
42. “Bilibili open platform”(중국어), Bilibili, 2026-11-06 확인, https://open.bilibili.com/
43. “Douyin open platform overview”(중국어), Douyin 오픈 플랫폼, 2026-11-06 확인, https://developer.open-douyin.com/docs/resource/zh-CN/dop/overview/introduction
44. “WeChat developer docs”(중국어), WeChat, 2026-11-06 확인, https://developers.weixin.qq.com/doc/
45. “RFC 6585: Additional HTTP Status Codes”, RFC Editor, 2012-04, https://www.rfc-editor.org/rfc/rfc6585.html
46. “RFC 6750: OAuth 2.0 Bearer Token Usage”, RFC Editor, 2012-10, https://www.rfc-editor.org/rfc/rfc6750.html
47. “RFC 9110: HTTP Semantics”, RFC Editor, 2022-06, https://www.rfc-editor.org/rfc/rfc9110.html
48. Xiaohongshu 기능 카탈로그, EveryInfra API, 2026-11-06 확인, https://api.everyinfra.com/api/v1/social/catalog?platform=xiaohongshu
49. Douyin 기능 카탈로그, EveryInfra API, 2026-11-06 확인, https://api.everyinfra.com/api/v1/social/catalog?platform=douyin
50. Bilibili 기능 카탈로그, EveryInfra API, 2026-11-06 확인, https://api.everyinfra.com/api/v1/social/catalog?platform=bilibili
51. WeChat 공식 계정 기능 카탈로그, EveryInfra API, 2026-11-06 확인, https://api.everyinfra.com/api/v1/social/catalog?platform=wechat_oa
52. 웹 검색 기능 카탈로그, EveryInfra API, 2026-11-06 확인, https://api.everyinfra.com/api/v1/social/catalog?platform=web