Sometrend

Social APP 서버의 도구들에 대한 상세한 사용 가이드를 제공합니다. Social APP를 처음 이용하는 경우에는 필수적으로 toolName을 지정하지 않은 상태로 이 도구를 호출하여 사용 방법을 숙지하세요. 개별 도구에 대한 상세 가이드를 알고 싶을 때에는 toolName을 지정하고 이 도구를 호출하세요.

guide

현재 API Key의 크레딧 잔액을 조회합니다. ### 응답 정보 - totalCredit: 총 부여된 크레딧 - usedCredit: 사용한 크레딧 - remainingCredit: 남은 크레딧 ### 사용 예시 - 크레딧 잔액 확인 - 사용량 모니터링 에러 발생 시 응답의 message 필드를 사용자에게 그대로 전달하세요.

usage

MCP 서버 상태를 확인합니다. ### 응답 정보 - status: 서비스 상태 (ok) - service: 서비스명 - timestamp: 확인 시각 ### 사용 예시 - 서버 상태 모니터링 - API 연결 확인 에러 발생 시 응답의 message 필드를 사용자에게 그대로 전달하세요.

health

keyword가 포함된 문서에서 나타난 `감성표현`들을 `감성표현`내의 `감성어`로 1차 그룹핑하고, `속성`으로 2차 그룹핑하여 집계한 결과를 Token-Oriented Object Notation (TOON) 형식으로 제공합니다. 모든 `감성표현`을 고려할 때에는 categoryList를 ["감성"]으로 지정하고, 긍정/부정/중립에 해당하는 `감성표현`만 고려할 때에는 ["감성 > 감성/감각/서술-부정"]과 같이 ["감성 > {감성중분류}"] 형태로 지정해야 합니다. 출력에 포함되는 속성과 감성어는 문서에서 keyword와 함께 출현하였지만, keyword에 대한 직접적인 감성표현으로 사용되었는지 여부가 보장되지는 않습니다. 속성이 "-"이면 속성이 없이 감성어가 단독으로 출현했음을 의미합니다. 에러 발생 시 응답의 message 필드를 사용자에게 그대로 전달하세요.

GetAssociationBySentiment

(keyword, include, exclude) 조건에 해당하는 문서의 목록을 추출하고, Token-Oriented Object Notation (TOON) 형식으로 제공합니다. 추출된 문서의 summaries 필드에는 keyword와 include에 들어있는 키워드가 출현한 스니펫들이 "..."으로 묶여서 들어있습니다. 연관어가 출현한 문서의 조회에도 이 도구를 사용할 수 있습니다. 분석 주제에 해당하는 (keyword, include, exclude) 조건 가운데 include에 "연관어1||연관어2||..."를 추가하여 분석 주제가 특정 연관어(들)과 함께 나타난 문서들을 조회할 수 있습니다. 사용자가 "원문 기반 분석"을 요청받는 경우에는 이 도구로 가져온 문서의 내용을 직접 분석하거나, 이 도구로 가져온 문서에서 전반적인 경향을 파악하여 심층 분석을 위한 파라메터 확장에 활용하여야 합니다. 에러 발생 시 응답의 message 필드를 사용자에게 그대로 전달하세요.

GetKeywordDocuments

keyword가 포함된 문서에서 나타난 `감성표현`들을 `감성표현`에 포함된 `속성`으로 1차 그룹핑하고, `감성어`로 2차 그룹핑하여 집계한 결과를 Token-Oriented Object Notation (TOON) 형식으로 제공합니다. categoryList는 반드시 ["속성"]이나 ["속성 > {속성중분류}"] 형태로 지정해야 합니다. 출력에 포함되는 속성과 감성어는 문서에서 keyword와 함께 출현하였지만, keyword에 대한 직접적인 감성표현으로 사용되었는지 여부가 보장되지는 않습니다. 감성어가 "-"이면 감성어가 없이 속성이 단독으로 출현했음을 의미합니다. 에러 발생 시 응답의 message 필드를 사용자에게 그대로 전달하세요.

GetAssociationByAttribute

keyword가 포함된 문서에서 함께 자주 언급되는 연관어들의 목록을 추출하여 Token-Oriented Object Notation (TOON) 형식으로 제공합니다. 이 도구는 감성 연관어 목록의 추출에도 사용될 수 있습니다. `감성표현` 단위의 감성 연관어를 조회하고 싶다면 이 도구에서 categoryList를 ["감성"]이나 ["감성 > {감성중분류}"] 형태로 지정하면 됩니다. `감성표현` 단위가 아닌 `감성어`와 `속성`을 나누어서 감성 분석을 하려면 GetAssociationBySentiment나 GetAssociationByAttribute를 사용해야 합니다. 에러 발생 시 응답의 message 필드를 사용자에게 그대로 전달하세요.

GetKeywordAssociation

(keyword, include, exclude) 조건에 해당하는 언급량(문서수)의 추이를 Token-Oriented Object Notation (TOON) 형식으로 제공합니다. '관심도', '문서수 추이', '언급량 추이', '키워드 추이', '문서량' 등과 같은 요청이 있을 시에는 이 도구를 사용하세요. 언급량의 피크 시점에 대한 원인 파악을 위해서는 다음의 방법들을 복합적으로 활용할 수 있습니다. - 피크 시점의 문서목록 조회 결과로부터 정성 분석 수행 - 피크 직전과 피크 시점의 연관어 목록 비교 - 웹 검색 앱을 활용하여 피크 시점에 keyword와 관련된 정보 파악 에러 발생 시 응답의 message 필드를 사용자에게 그대로 전달하세요.

GetKeywordTransitions