2f99e3044d
- Image fetch/search from anime booru sites - yande.re tested and working - Supports: Danbooru, yande.re, Konachan, Gelbooru - Tag-based search (lace, lingerie, etc.) - Rating filters (explicit/questionable/safe) - Integration with lettabot-message for Matrix delivery
101 lines
2.0 KiB
Markdown
101 lines
2.0 KiB
Markdown
---
|
|
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.*
|