---
name: memesite
description: Find memes, 表情包 / 斗图 and reaction images and place them into articles, newsletters, docs or video scripts. Use when the user asks to add memes / 表情包 / reaction images to a piece of writing, to "配图" with memes, or to find a meme for a feeling, reaction or character (熊猫头, 奶龙, 金馆长, 吗喽, Drake, This Is Fine…). Searches the memesite library over HTTP with curl.
---

# memesite: memes for writing

memesite covers trending memes: Chinese 表情包 / 斗图 (熊猫头, 奶龙, 金馆长, 吗喽…), English reaction memes and templates (Drake, This Is Fine, Doge…), plus openly licensed emoji and art.

## How to call it

Everything goes through one HTTP endpoint; `curl` is enough. No key is needed.

```bash
curl -sG http://localhost:3000/api/memes/search \
  --data-urlencode "q=无语" -d limit=8
```

The response is the standard API envelope: `{"code": 0, "message": "ok", "data": {"total": N, "data": [{id, title, url, image, thumb, kind, markdown}, …]}}`.

Query parameters:

| Parameter | Use |
|---|---|
| `q` | 1–3 words describing the reaction or character (Chinese queries work best as short 2–4 character phrases: `无语`, `裂开`, `震惊`, `摸鱼`, `打工人`, `崩溃`, `感动哭了`. English: `facepalm`, `mind blown`, `this is fine`, `side eye`) |
| `limit` | up to 50 (default 20) |

For a named character (熊猫头, 奶龙, Drake) or the user's own mascot, search the name too.

Each result carries a `markdown` field ready to paste:

```markdown
![熊猫头表情包](http://localhost:3000/memesite/gpic/full/1bgai56mt2tk.jpg)
```

## Placing memes into an article

Do the reading yourself; only call memesite for search. This keeps it cheap and gives better picks.

1. **Read the whole piece.** Note its language, tone, audience, and whether it is commercial (ads, sponsored posts, client work).
2. **Pick the spots.** Default to one image per 400–600 words (Chinese: per 600–1000 characters), at most one per section, never more than the user asked for. Good spots: a punchline, a surprise or reveal, a pain point the reader recognizes, a win, an ironic aside. Skip the title, the first sentence, code blocks, tables and anything solemn.
3. **Describe each spot as a reaction, not a topic.** Search for what the reader should *feel*.
4. **Search in the article's language first**, 2–3 phrasings per spot.
5. **Choose.** Prefer, in order: matches the reaction precisely; the caption (`title`) fits the sentence; visual variety across the article (don't use the same character twice in a row). Never reuse an image in one article.
6. **Insert** each image on its own line right after the paragraph it reacts to, with a blank line before and after, using the result's `markdown` field unchanged.
7. **Report back** with a short list: where each image went, which image, and any spot you skipped because nothing fit well. Don't invent images or URLs.

## Human-facing pages

- `/memes` — the full catalog
- `/search?q=…` — the same search in the browser
- `/meme/<id>` — one meme, with the full-size image
- `/licensing` — which images may be used commercially
