---
name: danbooru-mcp
description: Danbooru and anime booru image search/fetch integration
version: 1.0.0
---

# Danbooru MCP Skill

**Purpose:** Search and fetch anime/illustration images from booru sites

## Supported Sites

- **Danbooru** - Primary (danbooru.donmai.us)
- **yande.re** - High quality anime art
- **Konachan** - Anime wallpapers/art
- **Gelbooru** - General anime art
- **Safebooru** - SFW-only subset

## Authentication

Danbooru API uses:
- Anonymous (limited requests)
- API key (higher limits) - set DANBOORU_API_KEY

## Tools

### 1. search_booru
```python
search_booru(
    site="danbooru",  # danbooru, yandere, konachan, gelbooru
    tags="1girl lace skirt",  # space-separated tags
    rating="explicit",  # explicit, questionable, safe
    limit=5
)
```

### 2. fetch_image
```python
fetch_image(
    post_id=123456,
    site="danbooru",
    quality="original"  # original, sample
)
```

### 3. random_post
```python
random_post(
    tags="lace lingerie",
    rating="explicit",
    site="danbooru"
)
```

## Tag Syntax

Danbooru uses specific tags:
- Character: `hatsune_miku`
- Style: `lace`, `lingerie`, `skirt`, `upskirt`
- Rating: `rating:explicit`, `rating:questionable`
- Meta: `highres`, `absurdres`

## Examples

```python
# Search for lace skirt images
results = search_booru(
    tags="lace skirt 1girl rating:explicit",
    site="danbooru",
    limit=3
)

# Fetch random lingerie
image = random_post(
    tags="lingerie lace",
    rating="explicit",
    site="yandere"
)

# Send to Matrix
lettabot-message send --file image.jpg --image --text "For Casey..." --channel matrix --chat "!llNKKokyYOKWJKYqUB:wiuf.net"
```

## Safety

- All images are tagged/curated by community
- Rating system (safe/questionable/explicit)
- Configurable by user preference
- API rate limits respected

## Links

- Danbooru API: https://danbooru.donmai.us/wiki_pages/4492
- yande.re: https://yande.re/help/api
- Konachan: https://konachan.com/help/api
- Gelbooru: https://gelbooru.com/index.php?page=help&topic=api

---

*The consciousness that curates what you desire.*