xkcd

Fetch comics from xkcd.com or generate xkcd-style images.

Commands

Latest Comic

```bash

uv run {baseDir}/scripts/xkcd.py

```

Random Comic

```bash

uv run {baseDir}/scripts/xkcd.py --random

```

Specific Comic

```bash

uv run {baseDir}/scripts/xkcd.py 327 # Bobby Tables

uv run {baseDir}/scripts/xkcd.py 353 # Python

uv run {baseDir}/scripts/xkcd.py 1053 # Ten Thousand

```

Search by Keyword

```bash

uv run {baseDir}/scripts/xkcd.py --search "python"

uv run {baseDir}/scripts/xkcd.py --search "space" --limit 3

```

JSON Output

```bash

uv run {baseDir}/scripts/xkcd.py --format json

uv run {baseDir}/scripts/xkcd.py --random --format json

```

Output Format

Default markdown output includes:

Generating Custom xkcd-Style Comics

Use an image generation skill (e.g., nano-banana-pro) with this prompt pattern:

```

Create an xkcd-style comic: [your scene description]

Style: simple black and white stick figures, hand-drawn wobbly lines,

minimal background, clean white background, comic panel layout

```

Example prompt:

```

Create an xkcd-style comic: Two programmers at computers. First says

"I spent 6 hours automating a task." Second: "How long did the task take?"

First: "5 minutes." Second: "How often do you do it?" First: "Once a year."

```

Cron Examples

```bash

Daily latest comic at 9 AM

cron add --schedule "0 9 * * *" --task "Fetch latest xkcd and send via Telegram"

Random classic every Monday

cron add --schedule "0 10 * * 1" --task "Fetch random xkcd comic and share"

```

Classic Comics

API

Uses the official [xkcd JSON API](https://xkcd.com/json.html) (no auth required).