AX-HUB/dap-was-dapms
10
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
dap-was-dapms/docs/contracts/agent-builder-mcp/observed-samples/2026-07-13/04-searchapi-youtube-search.md
koseokmin 58d3014a0f
All checks were successful
Deploy Gateway / deploy (push) Successful in 2m52s
Details
저장소 문서를 다시 추적하고 계약 예제를 복원한다 
계약 테스트는 docs/contracts 아래 예제를 golden example로 읽는다.
docs/와 README.md가 ignore되어 있어 예제 파일이 사라졌고 9건이
실패하고 있었다. 문서가 온전했던 마지막 상태(3de052a)에서 복원하고
.gitignore에서 두 항목을 제거한다. 에이전트 산출물인
docs/superpowers/ 제외는 유지한다.

initialize 응답의 capabilities.tools.listChanged를 문서는 true로
적고 있었으나 InitializeHandler는 false를 낸다. 현재 HTTP 단발 응답
transport가 notification을 push할 수 없으므로 false가 맞다. 예제와
architecture.md를 코드에 맞추고, ToolListChangedEvent가 발행되지만
아직 소비되지 않는다는 점과 SSE 도입 시 true로 바꾼다는 조건을
남긴다.

169개 테스트 전부 통과.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-15 17:16:13 +09:00

11 KiB
Raw Permalink Blame History

관찰 로그 04 - searchapi / youtube_search

  • 출처: MCP_툴_호출_통신_로그_(JSON-RPC) (1).pdf
  • 원본 생성 시각: 2026-07-13 17:10:33 UTC
  • 성격: Agent Builder 솔루션에서 수행한 관찰용 실행 로그. 본 문서는 구현 계약이나 테스트 fixture가 아니다.

헤더 및 실행 메타데이터

항목 원본 기록 값
transport type mcp-http
request_id 2ab618c9-8f2f-4163-ad11-d7118bc4d3ae
tool_uid 28553975-d471-4b67-a210-61cc636d537d
Tool version 2.0
실행 시각 2026-07-13 17:02:42 UTC
결과 ok · 2200ms · truncated=False
JSON-RPC 프레임 수 4
lifecycle initialize → tools/call

HTTP 헤더 기록 범위

원본 PDF에는 개별 HTTP request/response header 값이 기록되어 있지 않다. 원본 표의 request_id, tool_uid, version은 실행 메타데이터이며 HTTP header라고 단정하지 않는다.

원본 공통 안내에는 시크릿 및 인증 header가 로깅 전에 [REDACTED]로 마스킹되었다고 명시되어 있다. 따라서 Authorization, Mcp-Session-Id 등 실제 HTTP header 값은 이 문서에 포함하지 않는다.

JSON-RPC 통신 전문

아래는 원본 PDF의 JSON-RPC 프레임을 순서대로 옮긴 전사본이다. 긴 result.content[].text 문자열은 PDF의 시각적 줄바꿈을 보존했으므로, 이 블록 전체를 기계 실행용 단일 JSON payload로 사용하지 않는다.

원본 PDF 자체가 tools/call 성공 응답의 끝부분을 [+22537B]>로 접어 표시한다. 따라서 이 문서는 PDF에 표시된 전문을 보존한 것이며, 접힌 22,537바이트의 원본 응답 데이터를 복원한 것은 아니다.

17:02:42 요청 → initialize
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-06-18",
"capabilities": {},
"clientInfo": {
"name": "toolbox-executor",
"version": "0.1.0"
}
}
}
17:02:42 ← 응답 initialize
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"protocolVersion": "2025-06-18",
"capabilities": {
"tools": {
"listChanged": true
},
"prompts": {
"listChanged": true
},
"resources": {
"listChanged": true
},
"logging": {}
},
"serverInfo": {
"name": "searchapi",
"title": "SearchAPI MCP Server",
"version": "1.0.0",
"websiteUrl": "<https://www.searchapi.io>"
},
"instructions": "Use the available tools to get real-time search results. Each tool corresponds t
o a specific use case, which may be a full search engine or a specialized feature of an engine."
}
}
17:02:42 요청 → tools/call
{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "youtube_search",
"arguments": {
"q": "EBS 공식 유튜브 채널",
"gl": "KR"
}
}
}
17:02:44 ← 응답 tools/call
{"jsonrpc": "2.0", "id": 3, "result": {"content": [{"type": "text", "text": "{\n \"search_metadata
\": {\n \"id\": \"search_Z18NJlvnOYI636jLXk3BOm7g\",\n \"status\": \"Success\",\n \"created_
at\": \"2026-07-13T17:02:43Z\",\n \"request_time_taken\": 1.12,\n \"parsing_time_taken\": 0.0
4,\n \"total_time_taken\": 1.15,\n \"request_url\": \"<https://www.youtube.com/results?search_q
uery=EBS+%EA%B3%B5%EC%8B%9D+%EC%9C%A0%ED%8A%9C%EB%B8%8C+%EC%B1%84%EB%84%90&gl=KR&hl=en\>",\n \"htm
l_url\": \"<https://www.searchapi.io/api/v1/searches/search_Z18NJlvnOYI636jLXk3BOm7g.html\>",\n
\"json_url\": \"<https://www.searchapi.io/api/v1/searches/search_Z18NJlvnOYI636jLXk3BOm7g\>"\n },\n
\"search_parameters\": {\n \"engine\": \"youtube\",\n \"q\": \"EBS 공식 유튜브 채널\",\n \"hl
\": \"en\",\n \"gl\": \"KR\"\n },\n \"search_information\": {\n \"total_results\": 6938629\n
},\n \"channels\": [\n {\n \"position\": 1,\n \"id\": \"UCFCtZJTuJhE18k8IXwmXTYQ\",\n
\"title\": \"EBS Documentary\",\n \"link\": \"<https://www.youtube.com/@EBSDocumentary\>",\n
\"description\": \"EBS offers a wide range of high-quality documentaries\\ndealing with subjects, suc
h as knowledge, science, culture and others.\",\n \"is_verified\": true,\n \"subscribers\":
5410000.0,\n \"thumbnail\": {\n \"static\": \"<https://yt3.ggpht.com/JCoc_tttfLn5nzycdjiS
Fwv0gg-AKMIU2pyLw_13CzftUAchPNt4pJ8sHymyp_PcpF9KqSH-yIQ=s88-c-k-c0x00ffffff-no-rj-mo\>",\n \"r
ich\": \"<https://yt3.ggpht.com/JCoc_tttfLn5nzycdjiSFwv0gg-AKMIU2pyLw_13CzftUAchPNt4pJ8sHymyp_PcpF9Kq
SH-yIQ=s176-c-k-c0x00ffffff-no-rj-mo\>"\n }\n },\n {\n \"position\": 2,\n \"id
\": \"UC-swf20n5xdKW0waeLpXPFQ\",\n \"title\": \"EBS\",\n \"link\": \"<https://www.youtube.
com/@EBS_story\>",\n \"description\": \"EBS 공식 유튜브 채널 EBS 입니다. 언제나 여러분 곁엔 EBS가 그리
고 언제나 EBS 곁엔 여러분이!\",\n \"subscribers\": 698000,\n \"thumbnail\": {\n \"stati
c\": \"<https://yt3.ggpht.com/k1Z1iQQcdGXiByVcoCCGEwQtx803bSIMOhDOEmLwAexwVmkd6EeZNg__BcDIZ8B_5-jURP_
9bg=s88-c-k-c0x00ffffff-no-rj-mo\>",\n \"rich\": \"<https://yt3.ggpht.com/k1Z1iQQcdGXiByVcoCCG
EwQtx803bSIMOhDOEmLwAexwVmkd6EeZNg__BcDIZ8B_5-jURP_9bg=s176-c-k-c0x00ffffff-no-rj-mo\>"\n }\n
},\n {\n \"position\": 4,\n \"id\": \"UCNjQBiTSdoj2tCQLBGXFksw\",\n \"title\": \"EB
S 라디오 공식 채널\",\n \"link\": \"<https://www.youtube.com/@ebsradio\>",\n \"description\":
\"책 읽어주는 라디오 + 외국어 라디오 (서울 수도권 104.5MHz) 한국교육방송 EBS 라디오 공식 운영 채널 입니다.\",\n
\"subscribers\": 208000,\n \"thumbnail\": {\n \"static\": \"<https://yt3.googleuserconten
t.com/ytc/AIdro_kWu2E5kc1Es_euuO3CNfx6R3-JBcB-eLaX1tAEd20yGew=s88-c-k-c0x00ffffff-no-rj-mo\>",\n
\"rich\": \"<https://yt3.googleusercontent.com/ytc/AIdro_kWu2E5kc1Es_euuO3CNfx6R3-JBcB-eLaX1tAEd20yGe
w=s176-c-k-c0x00ffffff-no-rj-mo\>"\n }\n },\n {\n \"position\": 6,\n \"id\": \"U
CL44YGs2BXxtM4GZRH-wnrQ\",\n \"title\": \"EBS 지식채널e\",\n \"link\": \"<https://www.youtub
e.com/@ebs_jisike\>",\n \"description\": \"우리 삶 속에서 잠깐, 5분 의미있는 순간으로 만드는 채널 공유하
고 쌓여가는 지식 지식채널e 공식홈페이지 ...\",\n \"subscribers\": 147000,\n \"thumbnail\": {\n
\"static\": \"<https://yt3.ggpht.com/_nK3ujZE56iSp3jf35MUMgCXIlFY9Gshi7VdHxNBoUNvT-8Jv1IgsGBlf3yNfR7J
Qr-TxBScfg=s88-c-k-c0x00ffffff-no-rj-mo\>",\n \"rich\": \"<https://yt3.ggpht.com/_nK3ujZE56iSp
3jf35MUMgCXIlFY9Gshi7VdHxNBoUNvT-8Jv1IgsGBlf3yNfR7JQr-TxBScfg=s176-c-k-c0x00ffffff-no-rj-mo\>"\n
}\n },\n {\n \"position\": 8,\n \"id\": \"UCiFYUP4_TI70yCkkVJAlxoA\",\n \"title
\": \"EBS Collection - Nature\",\n \"link\": \"<https://www.youtube.com/@ebs.science\>",\n
\"description\": \"Chosen among more than 310,000 digitalized sources from EBS archive, EBS Collectio
n gives you exclusive access to intriguing ...\",\n \"subscribers\": 1340000.0,\n \"thumbna
il\": {\n \"static\": \"<https://yt3.googleusercontent.com/ytc/AIdro_m_xD2UFIA7qn07UeYtPAly1eP
mRdspeKkwIqhgdLjflwM=s88-c-k-c0x00ffffff-no-rj-mo\>",\n \"rich\": \"<https://yt3.googleusercon
tent.com/ytc/AIdro_m_xD2UFIA7qn07UeYtPAly1ePmRdspeKkwIqhgdLjflwM=s176-c-k-c0x00ffffff-no-rj-mo\>"\n
}\n },\n {\n \"position\": 9,\n \"id\": \"UCl_tB4AqPkkxuYcJQHz6dMw\",\n \"title
\": \"EBSCulture (EBS 교양)\",\n \"link\": \"<https://www.youtube.com/@EBSCulture\>",\n \"d
escription\": \"Knowledge and information are becoming more important in all areas of today's societ
y. EBS provides the information to make ...\",\n \"is_verified\": true,\n \"subscribers\":
3020000.0,\n \"thumbnail\": {\n \"static\": \"<https://yt3.googleusercontent.com/ytc/AIdr
o_nRo84wHIX9NhlqcW4f8Z4XptXjuHQD-xp3U_Dibgvxpn4=s88-c-k-c0x00ffffff-no-rj-mo\>",\n \"rich\":
\"<https://yt3.googleusercontent.com/ytc/AIdro_nRo84wHIX9NhlqcW4f8Z4XptXjuHQD-xp3U_Dibgvxpn4=s176-c-k
-c0x00ffffff-no-rj-mo\>"\n }\n },\n {\n \"position\": 10,\n \"id\": \"UCbeZPOz8u
aHstEIbkqBOnGg\",\n \"title\": \"EBS 세계테마기행\",\n \"link\": \"<https://www.youtube.com/@
ebstheme\>",\n \"description\": \"EBS 세계테마기행 공식 유튜브 채널 : <https://bit.ly/WorldTravel_EB
S> (구독하기) ⛵세계를 여행하며 만나는 다양한 문화와 풍경!\",\n \"subscribers\": 162000,\n \"thumb
nail\": {\n \"static\": \"<https://yt3.ggpht.com/s9JbLvTmFQuY-jP9R_2uRdkWz_YgEK3LYGLa5mdgldqhW
npGrLJMVJCgQOL_VCfBqb-T7_IWgA=s88-c-k-c0x00ffffff-no-rj-mo\>",\n \"rich\": \"<https://yt3.ggph
t.com/s9JbLvTmFQuY-jP9R_2uRdkWz_YgEK3LYGLa5mdgldqhWnpGrLJMVJCgQOL_VCfBqb-T7_IWgA=s176-c-k-c0x00ffffff
-no-rj-mo\>"\n }\n },\n {\n \"position\": 11,\n \"id\": \"UCuuA38hvvuipqXFIP3BfL
EA\",\n \"title\": \"EBS 지식\",\n \"link\": \"<https://www.youtube.com/@EBSKnowledge\>",\n
\"description\": \"일상 속 지식 한 스푼! 각 분야의 전문가로 구성된 연사들의 강연까지! EBS의 고품격 지식·강연 프로
그램 속 다양한 지식들을 큐레이팅 ...\",\n \"subscribers\": 298000,\n \"thumbnail\": {\n
\"static\": \"<https://yt3.ggpht.com/E2hBI06f7Y9cWzG5EcQOzPGtLmhj_2IH3AGcqdTj4OI7Jiz8dUwtQOZyHA5kqIbG
cxw9hr08dQ=s88-c-k-c0x00ffffff-no-rj-mo\>",\n \"rich\": \"<https://yt3.ggpht.com/E2hBI06f7Y9cW
zG5EcQOzPGtLmhj_2IH3AGcqdTj4OI7Jiz8dUwtQOZyHA5kqIbGcxw9hr08dQ=s176-c-k-c0x00ffffff-no-rj-mo\>"\n
}\n },\n {\n \"position\": 13,\n \"id\": \"UC2dDb6up1sIc-5geTvNtgHA\",\n \"title
\": \"EBS 최고의 요리비결\",\n \"link\": \"<https://www.youtube.com/@EBS_best.cooking.secrets
\>",\n \"description\": \"이 채널은 \\\"EBS 최고의 요리비결\\\" 공식 유튜브 채널입니다. EBS 최고의 요리비
결은 지난 20년 동안 요리의 대가들이 출연하여 누구나 ...\",\n \"subscribers\": 104000,\n \"thumbnai
l\": {\n \"static\": \"<https://yt3.googleusercontent.com/ytc/AIdro_mpiFqITW0McZ_0lY7r80ltEfM3
hz5srioAQjdI0Jxizw=s88-c-k-c0x00ffffff-no-rj-mo\>",\n \"rich\": \"<https://yt3.googleuserconte
nt.com/ytc/AIdro_mpiFqITW0McZ_0lY7r80ltEfM3hz5srioAQjdI0Jxizw=s176-c-k-c0x00ffffff-no-rj-mo\>"\n
}\n },\n {\n \"position\": 14,\n \"id\": \"UC2DBKKki_gtyrrgT7HYU1CA\",\n \"title
\": \"EBS 국제다큐영화제 공식 채널\",\n \"link\": \"<https://www.youtube.com/@EIDFOFFICIAL\>",\n
\"description\": \"EBS국제다큐영화제 EIDF 공식 Youtube 채널입니다. This is the official YouTube EIDF Chan
nel.\",\n \"subscribers\": 10100.0,\n \"thumbnail\": {\n \"static\": \"<https://yt3.
googleusercontent.com/ytc/AIdro_nglXasX2K52bUhcEmGgttfBh7no_eQcDperw-a5E8sJ6U=s88-c-k-c0x00ffffff-no-
rj-mo\>",\n \"rich\": \"<https://yt3.googleusercontent.com/ytc/AIdro_nglXasX2K52bUhcEmGgttfBh7
no_eQcDperw-a5E8sJ6U=s176-c-k-c0x00ffffff-no-rj-mo\>"\n }\n },\n {\n \"position\": 1
5,\n \"id\": \"UCN3RfsR18gsH8PLI6R6PYSQ\",\n \"title\": \"EBS뉴스\",\n \"link\": \"<ht
tps://www.youtube.com/@EBSNewsG\>",\n \"description\": \"한국교육방송공사 EBS 뉴스 채널입니다. EBS 뉴
스의 TV 방송시간은 월~금 낮 12시, 저녁 6시 10분입니다. Republic of Korea's ...\",\n \"subscribers\": 5
9900.0,\n \"thumbnail\": {\n \"static\": \"<https://yt3.ggpht.com/J5dpRSp4ROHG5T0zUdZPvl2
SrNXUyObe68rfiVid5i6XnN7zF43M36qekBESigoXqhN-hoA9dA=s88-c-k-c0x00ffffff-no-rj-mo\>",\n \"rich
\": \"<https://yt3.ggpht.com/J5dpRSp4ROHG5T0zUdZPvl2SrNXUyObe68rfiVid5i6XnN7zF43M36qekBESigoXqhN-ho…
[+22537B]>
Reference in New Issue View Git Blame Copy Permalink