멜론 도구¶ 멜론 곡 검색 도구¶ async pyhub_ai.tools.melon.search_melon_songs(query)[소스]¶ 멜론 사이트에서 곡을 검색합니다. 매개변수: query (str) – 검색할 곡 제목/아티스트/앨범명 등의 검색어 반환: 검색된 곡들의 정보를 담은 딕셔너리 리스트 song_uid: 곡 ID song_name: 곡 제목 album_img_url: 앨범 이미지 URL album_uid: 앨범 ID album_name: 앨범명 artist_uid: 아티스트 ID artist_name: 아티스트명 반환 형식: List[Dict[str, str]] 특정 곡 세부 정보 조회 도구¶ async pyhub_ai.tools.melon.get_song_detail(song_id)[소스]¶ 멜론 사이트에서 특정 곡의 상세 정보를 가져옵니다. 매개변수: song_id (str) – 멜론 곡 ID 반환: 곡의 상세 정보를 담은 딕셔너리 name: 곡 제목 album_name: 앨범명 artist_name: 아티스트명 cover_url: 앨범 커버 이미지 URL lyric: 가사 genre: 장르 목록 published_date: 발매일(YYYY-MM-DD 형식) 반환 형식: Optional[Dict[str, Optional[str | List[str]]]] 멜론 TOP100 곡 정보 조회 도구¶ async pyhub_ai.tools.melon.get_melon_top100()[소스]¶ 멜론 실시간 TOP 100 차트 정보를 가져옵니다. 반환: TOP 100 곡 정보 목록 song_uid: 곡 ID rank: 순위 song_name: 곡 제목 artist_uid: 아티스트 ID artist_name: 아티스트명 album_uid: 앨범 ID album_name: 앨범명 반환 형식: List[Dict[str, str | int]]