jjalbot

CLI and MCP server for searching jjals (Korean meme images) on JjalBot.

Quick Start

No installation required — use npx:

npx jjalbot search "웃긴"

Or install globally:

npm install -g jjalbot
jjalbot search "대박"

Commands

search

Search for jjals by Korean keyword.

jjalbot search <keyword> [--thumbnail] [--nsfw]

Note: Keywords must be in Korean. NSFW jjals are excluded by default; use --nsfw to include them.

random

Get random jjal(s).

jjalbot random [--size <n>] [--text <keyword>] [--nsfw]

get

Fetch a specific jjal by its short ID.

jjalbot get <shortId>

mcp

Start the MCP (Model Context Protocol) server for AI assistants.

jjalbot mcp

MCP Server

JjalBot includes a built-in MCP server that lets AI assistants like Claude search for jjals directly.

Claude Code

claude mcp add jjalbot -- npx -y jjalbot

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "jjalbot": {
      "command": "npx",
      "args": ["-y", "jjalbot", "mcp"]
    }
  }
}

Cursor / Windsurf

Add to your MCP configuration:

{
  "mcpServers": {
    "jjalbot": {
      "command": "npx",
      "args": ["-y", "jjalbot", "mcp"]
    }
  }
}

Available MCP Tools

| Tool | Description | |------|-------------| | search_jjals | Search jjals by Korean keyword | | random_jjal | Get random jjal(s), optionally filtered by keyword | | get_jjal | Fetch a single jjal by its short ID |

Output

All CLI commands output JSON to stdout, making it easy to pipe into other tools:

# Get the image URL of the first search result
jjalbot search "엄지척" | jq '.[0].imageUrl'

# Download a random jjal
jjalbot random | jq -r '.[0].imageUrl' | xargs curl -O

Requirements

• Node.js >= 18 (uses native fetch)

API Documentation

Full API docs: https://jjalbot.com/docs