search_prompts
Search booru image boards by tags and retrieve ready-to-use, cleaned AI-art prompts, each with category splits for appearance, clothing, pose, scenery, character, quality, and other.
Instructions
Search an image booru (Danbooru/AIBooru/e621/Gelbooru/Rule34) by TAG and return ready-to-use, cleaned AI-art prompts. Each result has the full prompt string plus its category split (appearance/clothing/pose/scenery/character/quality/other). This is the recommended tool for finding 'ready-to-use AI painting tags'.
== WHEN TO USE A DIFFERENT TOOL INSTEAD ==
'What does character X look like?' / 'list costume variants of X' / 'what tags describe X' -> use
danbooru_get_character_profile(one call: trait frequency table + wiki + bidirectional implications). It is built for describing a known character, whilesearch_promptsreturns sample images each turned into a prompt — different goals.'Find the canonical tag name for a Chinese/Japanese term or a misspelling' -> use
autocomplete_tags(alias/fuzzy/other_names aware).
== SEARCH SEMANTICS — read this before calling ==
This is NOT a keyword-search engine like Google. You query with one or more booru TAGS, and results are images ALL of whose tags are present.
A booru tag is a single token, multi-word tags use UNDERSCORE: 'blue_hair', 'hatsune_miku', 'sitting_on_chair' — never 'blue hair'.
MULTI-TAG SEARCH IS SUPPORTED but each provider caps how many plain tags you may combine per query: danbooru/aibooru/e621 = 2, gelbooru/rule34 = 10 (metatags like order:rank or rating:safe do not count). Exceeding the limit returns an error telling you how to fix it; you can also raise a provider's cap with the BOORU_MAX_TAGS_ env var (e.g. BOORU_MAX_TAGS_DANBOORU=6 for a Gold account).
STRONGLY PREFER A SINGLE TAG to start. 'hatsune_miku' returns thousands of well-tagged images; 'hatsune_miku blue_hair school_uniform smile' is treated as AND → dramatically fewer results (often zero). The cleaned prompt already contains far more detail than your search tag, so adding search tags is at best redundant and at worst returns nothing.
When you need a pure-quality / generalized set (no specific character or franchise yet), search '1girl' or '1boy' alone, or use 'random' order.
Do not write natural-language queries ('a girl with blue hair sitting in a classroom') — that is not supported. Translate to booru tags first.
Use
autocomplete_tagsif you are not sure how a concept is spelled as a booru tag (e.g. user said '法国女仆' → try 'french', 'maid' and let autocomplete return 'french maid', 'maid_uniform', etc.).Common useful single-tag starting points: a character tag ('hatsune_miku'), an artist tag, a copyright tag ('blue_archive'), a character + single qualifier ('2girls' for group shots), or 'order:rank' / 'random' for non-themed browsing via
orderparam.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | ||
| tags | Yes | ||
| limit | No | ||
| order | No | popular | |
| rating | No | all | |
| exclude | No | ||
| optimize | No | ||
| provider | No | danbooru | |
| added_tags | No | ||
| random_seed | No | ||
| min_tag_count | No | ||
| background_mode | No | keep | |
| include_preview | No | ||
| resolve_conflicts | No | ||
| include_characters | No | ||
| include_copyrights | No | ||
| simple_background_replacement_tags | No |