# search_catalog

> Tìm bản phát hành và track theo tên, nghệ sĩ, hãng đĩa, ISRC hoặc UPC, có thể lọc thêm theo trạng thái.

<!-- Generated from openapi/hills-mcp.json by scripts/mcp-reference.mjs. Edit the operation in hills-music (server/lib/ops), not this page. -->

Công cụ `search_catalog` · Chỉ đọc · Mọi tài khoản có quyền truy cập MCP · Quyền vai trò: `releases.view`

Tìm bản phát hành và track theo tên, nghệ sĩ, hãng đĩa, ISRC hoặc UPC, có thể lọc thêm theo trạng thái. Trả về id bản phát hành để dùng với release_status và streams_and_revenue, cùng các track khớp. Để trống query để liệt kê các bản phát hành được cập nhật gần đây nhất.

<a id="arguments"></a>

## Tham số

| Tham số | Kiểu | Bắt buộc | Mô tả |
| --- | --- | --- | --- |
| `query` | string | Không | Tên, nghệ sĩ, hãng đĩa, ISRC (ví dụ USRC17607839) hoặc UPC. Để trống sẽ liệt kê các bản phát hành gần đây. |
| `status` | `draft` \| `in_review` \| `changes_requested` \| `approved` \| `live` \| `archived` \| `taken_down` \| `rejected` | Không | Chỉ các bản phát hành ở trạng thái này. in_review = đã gửi, đang chờ kiểm duyệt; live = đã duyệt và đã lên kệ ở ít nhất một nền tảng; rejected = changes_requested (tên cũ). |
| `limit` | integer (1–50) | Không | Số kết quả mỗi trang (tối đa 50). Mặc định 20. |
| `offset` | integer (0–5000) | Không | Bỏ qua số kết quả này (lấy từ next_offset). Mặc định 0. |

<a id="example-call"></a>

## Ví dụ lệnh gọi

Trợ lý AI thực hiện lệnh gọi này thay bạn; đây là nội dung được gửi đến `https://mcp.hillsmusic.com` qua JSON-RPC.

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_catalog",
    "arguments": {
      "limit": 20,
      "offset": 0
    }
  }
}
```

<a id="result"></a>

## Kết quả

Một dòng tóm tắt dạng văn bản, sau đó là cùng dữ liệu đó dạng JSON trong `structuredContent`, với các trường sau:

| Trường | Kiểu | Mô tả |
| --- | --- | --- |
| `total` | number |  |
| `offset` | number |  |
| `next_offset` | number hoặc null |  |
| `releases` | mảng object |  |

Một lời từ chối (không có quyền, không tìm thấy, dữ liệu đầu vào sai) được trả về dưới dạng lỗi công cụ (`isError: true`), kèm văn bản giải thích lý do.

Nguồn: https://developer.hillsmusic.com/vi/mcp/search-catalog/