← Back to Skills Marketplace
hone1983

Lyrics Search

by hone1983 · GitHub ↗ · v1.0.0
cross-platform ✓ Security Clean
606
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install 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.
README (SKILL.md)

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
Usage Guidance
This skill is internally consistent, but consider these practical points before installing: - Privacy: each lookup sends the song title/artist to a third-party public API (api.lrc.cx). If you need to keep queries private, avoid using it. - Copyright: displaying or printing full song lyrics may have copyright implications—verify you have the right to reproduce or distribute lyrics for your use case. - Reliability and rate limits: public APIs can be slow, rate-limited, or go offline; implement sensible timeouts and retries (as the SKILL.md suggests) and consider caching frequent queries. - Trustworthiness of API: the SKILL.md references api.lrc.cx but provides no homepage or publisher info — if provenance matters, validate the API service before heavy usage. - Autonomous calls: if you deploy this in an agent that operates autonomously, monitor usage to avoid unexpected repeated requests. If you need stronger guarantees, consider using a well-documented/official lyrics provider or hosting a vetted proxy/cache.
Capability Analysis
Type: OpenClaw Skill Name: lyrics-search Version: 1.0.0 The skill bundle is designed to search and display song lyrics using the public LrcApi (api.lrc.cx). The `SKILL.md` instructions clearly define the purpose, the API endpoint, and the steps for fetching and processing the lyrics. There are no instructions for data exfiltration, malicious execution, persistence, or prompt injection against the agent. The `web_fetch` call is explicitly for the stated purpose, and the instructions focus on text processing and display, indicating benign intent.
Capability Assessment
Purpose & Capability
The name/description (search song lyrics via LrcApi) aligns with the instructions: only a single GET to https://api.lrc.cx with title/artist parameters and simple text processing. No unrelated credentials, binaries, or paths are requested.
Instruction Scope
SKILL.md only instructs the agent to perform a web_fetch to the LrcApi endpoint, optionally retry with artist omitted, strip timestamps/metadata, and format results for display/printing. It does not instruct reading system files, other env vars, or contacting other endpoints.
Install Mechanism
There is no install spec and no code files (instruction-only), which is the lowest-risk model — nothing is written to disk or installed by the skill itself.
Credentials
The skill declares no required environment variables, credentials, or config paths. Its functionality does not require elevated access or secrets, so the requested scope is proportionate.
Persistence & Privilege
always:false and default autonomous invocation are set. Autonomous invocation is the platform default and is reasonable for this type of skill; the skill does not request permanent presence or modify other skills/config.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install lyrics-search
  3. After installation, invoke the skill by name or use /lyrics-search
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: search song lyrics via LrcApi public API
Metadata
Slug lyrics-search
Version 1.0.0
License
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Lyrics Search?

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. It is an AI Agent Skill for Claude Code / OpenClaw, with 606 downloads so far.

How do I install Lyrics Search?

Run "/install lyrics-search" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Lyrics Search free?

Yes, Lyrics Search is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Lyrics Search support?

Lyrics Search is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Lyrics Search?

It is built and maintained by hone1983 (@hone1983); the current version is v1.0.0.

💬 Comments