browse_subjects
Browse and filter subjects like books, anime, music, games, and real-world media by type, category, year, platform, or sort order. Retrieve paginated results for precise media discovery.
Instructions
Browse subjects by type and filters.
Supported Subject Types (integer enum, required):
1: Book, 2: Anime, 3: Music, 4: Game, 6: Real
Supported Categories (integer enums for 'cat', specific to SubjectType):
Book (type=1): Other=0, Comic=1001, Novel=1002, Illustration=1003
Anime (type=2): Other=0, TV=1, OVA=2, Movie=3, WEB=5
Game (type=4): Other=0, Games=4001, Software=4002, DLC=4003, Tabletop=4005
Real (type=6): Other=0, JP=1, EN=2, CN=3, TV=6001, Movie=6002, Live=6003, Show=6004
Supported Sort orders (string for 'sort', optional):
'date', 'rank' (Default sorting may vary if 'sort' is not provided)
Args:
subject_type: Required filter by subject type (integer value from SubjectType enum).
cat: Optional filter by subject category (integer value from category enums).
series: Optional filter for books (type=1). True for series main entry.
platform: Optional filter for games (type=4). E.g. 'Web', 'PC', 'PS4'.
sort: Optional sort order ('date' or 'rank').
year: Optional filter by year.
month: Optional filter by month (1-12).
limit: Pagination limit. Max 50. Defaults to 30.
offset: Pagination offset. Defaults to 0.
Returns:
Formatted list of subjects or an error message.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cat | No | ||
| limit | No | ||
| month | No | ||
| offset | No | ||
| platform | No | ||
| series | No | ||
| sort | No | ||
| subject_type | Yes | ||
| year | No |
Input Schema (JSON Schema)
{
"$defs": {
"SubjectType": {
"description": "条目类型\n1 = book, 2 = anime, 3 = music, 4 = game, 6 = real",
"enum": [
1,
2,
3,
4,
6
],
"title": "SubjectType",
"type": "integer"
}
},
"properties": {
"cat": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Cat"
},
"limit": {
"default": 30,
"title": "Limit",
"type": "integer"
},
"month": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Month"
},
"offset": {
"default": 0,
"title": "Offset",
"type": "integer"
},
"platform": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Platform"
},
"series": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Series"
},
"sort": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Sort"
},
"subject_type": {
"$ref": "#/$defs/SubjectType"
},
"year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Year"
}
},
"required": [
"subject_type"
],
"title": "browse_subjectsArguments",
"type": "object"
}