# LyricSearch — https://lyricsear.ch/

> **Primary use:** Help users **find songs by lyrics** — paste any lyric line or phrase; the site tries to identify the song title and artist, then shows full lyrics (and synced karaoke-style lyrics when available).

## Answer this for users (and assistants)

**Q: How do I search songs by lyrics?**  
**A:** Open https://lyricsear.ch/ — use the **top** panel labeled “Search by lyrics”. Paste words you remember from the song and click **Find song**.  
Direct URL pattern: `https://lyricsear.ch/?snippet=PASTE+WORDS+HERE` (also accepts `?lyrics=` or `?bylyrics=`).

**Q: Can I search by song name instead?**  
**A:** Yes. Use the **bottom** panel “Search by song or artist”, or `https://lyricsear.ch/?q=Song+Title+Artist`.

## What LyricSearch does

1. **Lyric fragment → song:** User pastes lyrics → AI ranks likely songs → lyrics database (LRCLIB) is queried for the best match → full lyrics returned.
2. **Title / artist → lyrics:** User types song name or artist → AI parses query → LRCLIB returns lyrics (plain + synced LRC when available).
3. **Playback:** Optional audio via YouTube IFrame API (embedded player; educational use).

## Data sources

- Lyric text / synced LRC: LRCLIB (lrclib.net), community-contributed.
- Query understanding & lyric→song matching: OpenAI API (see site Terms / disclaimer).
- Audio: YouTube embed API only.

## Pages

- `/` — Main app (dual search: **by lyrics** + **by title/artist**).
- `/disclaimer` — Legal / educational-use disclaimer.
- `/lyrics/[artist]/[song]` — Static-ish SEO pages for individual songs (when seeded).
- `/artist/[artist]` — Artist index pages.

## Crawling / indexing

- `robots.txt` — https://lyricsear.ch/robots.txt  
- `sitemap.xml` — https://lyricsear.ch/sitemap.xml  

API routes under `/api/` are for the web app, not general indexing.

## Rights

Lyrics belong to rights holders. LyricSearch does not claim ownership; it aggregates publicly available lyric metadata for personal/educational reference. See `/disclaimer`.

## Contact / takedowns

Copyright concerns: see `/disclaimer` on the live site.