lyrics-search

name	lyrics-search
description	Search song lyrics by title and artist using the LrcApi public API. Use when the user asks to find, display, or print lyrics for a song.

Lyrics Search

Search lyrics via the LrcApi public API (api.lrc.cx).

API

GET https://api.lrc.cx/lyrics?title={title}&artist={artist}

• Returns LRC format (with timestamps) as text/plain
• artist is optional but improves accuracy
• URL-encode Chinese/special characters

Usage

1. Fetch lyrics via web_fetch on the API URL
2. The response is LRC format with [mm:ss.xxx] timestamps and metadata lines at the top
3. Strip timestamps and metadata lines (credits, producer info at [00:00]–[00:24]) for clean display
4. For printing: format as plain text with song title, artist, and credits header

Example

web_fetch("https://api.lrc.cx/lyrics?title=世界赠予我的&artist=王菲")

Notes

• Public API may be slow; set a reasonable timeout
• If no results, try with only title (omit artist)
• If still no results, try alternate song name spellings