zerochan_search
Read-onlyIdempotent
Search Zerochan anime images by tags, with options for multi-tag queries, strict primary tag filtering, and results sorting by recent or popular content.
Instructions
Search Zerochan entries by one or more tags.
Supports single-tag, multi-tag, and strict-mode queries. Zerochan tag names
use Title Case with spaces (e.g. 'Hatsune Miku', not 'hatsune_miku').
Multi-tag example: tags=['Hatsune Miku', 'Flower'] → /Hatsune+Miku,Flower?json
Strict mode: tags=['Rem'] + strict=True → /Rem?json&strict (only entries where Rem is primary tag)
Note: Strict mode only works with a single tag. Passing multiple tags with strict=True
will ignore the strict flag.
Args:
params (SearchByTagInput): Input parameters including:
- username (str): Your Zerochan username (required)
- tags (list[str]): One or more tag names (Title Case preferred)
- strict (bool): If True and single tag, use strict mode (default: False)
- page (int): Page number (default: 1)
- limit (int): Results per page, 1–250 (default: 20)
- sort (SortOrder): 'id' for recent, 'fav' for popular (default: 'id')
- dimensions (Optional[Dimensions]): Filter by image shape
- color (Optional[str]): Filter by dominant color name
- response_format (ResponseFormat): 'markdown' or 'json' (default: 'markdown')
Returns:
str: Matching entries in the requested format.
Markdown: formatted table with ID, tags, dimensions, favorites, links.
JSON: raw API response with all available fields.Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |