Return every gallery source this server can query.

Call this first when you need a source id, a category slug, or to check whether a source supports search or latest listings.

List popular or latest galleries from one source.

Use search() when the user names a character, series, model, or tag. If query is set, this tool searches that one source instead of ranking. If only category is set, list that category with sort (not a keyword search). Pass each item's path to get_gallery to fetch image URLs.

Search galleries by character, series, model, or tag.

source="all" (default) queries every searchable source in parallel. Results are interleaved by source so one site cannot bury the rest. Failed sources appear in errors and do not fail the whole call. Pass a hit's source and path to get_gallery.

List galleries for one tag on one source.

Prefer this over search() when you already have a tag from get_gallery.

Find more galleries sharing a tag with the given set.

Fetches metadata only, then browses the first tag. The original set is omitted.

Open a gallery from a full post URL.

Picks the source from the URL host. Use this when the user pastes a link.

Fetch title, tags, and a window of image URLs for one gallery.

path is ListingItem.path / SearchHit.path, a relative path, or a full post URL. Does not download image files. AI galleries are returned with is_ai=true. If the user gave a full URL and you do not know the source, call open_url instead.