曲库筛选词表 / Faceted vocabulary

列出曲库全部可用的筛选值(流派/情绪/乐器/速度/适用场景/厂牌)。 Lists every filterable facet value in the catalog (genre, mood, instrumentation, tempo, music-for, label).

何时用 / When: 在 km_search 里使用任何 include*/exclude* 筛选之前,先用本工具确认取值。 Call this BEFORE using any include*/exclude* filter in km_search.

入参 / Args: field(可选,facet 字段名子串,如 "genre"/"mood"/"library");query(可选,对取值与中文名做不区分大小写的子串过滤,中文也能查,如 query="悲伤")。

返回 / Returns: 每个 facet 字段的 { param, values },values 里每项是 { value, labelZh, count }。param 就是 km_search 里该字段对应的入参名。 顶层另有 labels[]:320 个厂牌的 { library_name, library_type, company, album_count, track_count },可用来判断某个厂牌值不值得单独收窄。 ⚠️ value 必须原样回填到 km_search,不要翻译、改大小写或去掉 "Parent;Leaf" 里的分号;改动过的值一律匹配不上。labelZh 只供你把中文 brief 映射到 canonical 值,不要回填。 count 用来防过度收窄:候选值 count < 200 时考虑放宽或换父级(例:sad 有 8.6 万首,而叶子 sad;breakup 只有 38 首,直接用叶子会把结果掐死)。

post/agent/v1/km_vocabulary

Request

  • Base URL: https://share.kindlemusic.cn
  • URL: https://share.kindlemusic.cn/agent/v1/km_vocabulary
  • Auth: one of:
    • none
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://share.kindlemusic.cn/oauth/authorize, token URL https://share.kindlemusic.cn/oauth/token)

Request body

fieldstring

Substring of a facet field name, e.g. "genre", "mood", "instrumentation", "library".

querystring

Case-insensitive substring filter applied to the facet values and their Chinese labels.

Response

tool 结果(与 MCP tools/call 返回的 JSON 相同)

object required

Changes

No recorded changes to this operation across all 1 revision of this API.