claudeers.
// Claude Skills

memecub

Meme search & auto meme placement for AI agents. Remote MCP server, Agent Skill, CLI and REST API that let Claude Code, Cursor and Codex find reaction memes,…

// Claude Skills[ cli ][ api ][ desktop ][ web ][ claude ]#claude#agent-skills#ai-agents#ai-writing#biaoqingbao#chinese#claude-code#claude-skills#skills◷ MIT$open-sourceupdated 21 days ago
Actively maintained
99/100
last commit 7 days ago
last release none
releases 0
open issues 0

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up memecub (git-clone project) into my current project.
Found on https://claudeers.com/memecub
Repo: https://github.com/liyupi/memecub
Homepage/docs: https://memecub.com
Detected install method: git-clone → git clone https://github.com/liyupi/memecub
Category: skills. Platforms: cli, api, desktop, web.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
active; community-verified: false. Confirm the source before running anything.
// or clone
git clone https://github.com/liyupi/memecub

// compatibility

Platformscli, api, desktop, web
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguageTypeScript

Get your FREE $2.50 API credits to access TickAtlas financial data ↗
memecub logo

memecub

Meme search and automatic meme placement for AI agents.

Give Claude Code, Cursor, Codex or Claude Desktop a meme library. Search reaction memes by feeling, or hand over an article and get it back with the right meme after the right sentence.

English · 简体中文

Paste an article, get it back with memes: real output of match_article

Real output of match_article. The model picks the moments; memecub finds the meme and inserts it as Markdown.

Why memecub

  • It places memes, not just finds them. match_article reads a whole post, picks the sentences worth a meme and returns the article with images inserted. Your agent doesn't have to guess where they go.
  • Search by feeling. Ask for facepalm, this is fine, it works on my machine, 无语 or 摸鱼 and get the reaction you meant, not a keyword lookalike.
  • English memes and Chinese 表情包 in one library. Drake, This Is Fine, Doge and Surprised Pikachu next to 熊猫头, 奶龙, 金馆长, 吗喽 and DeepSeek 鲸鱼娘. Chinese queries match whole phrases, so a character name returns that character.
  • Zero install. A remote MCP server over Streamable HTTP, or a plain-curl Agent Skill. Searching works without a key.
  • License-aware results. Every image says whether it is cleared for commercial use, links its source, and ships a ready Markdown snippet with the credit line when one is required. Ask for commercial-safe only and that's all you get.
  • Safe defaults for agents. Memes whose captions contain swearing are left out of agent results unless you ask for them.

Quick start

The server is https://memecub.com/mcp. Pick your client:

Claude Code

claude mcp add --transport http memecub https://memecub.com/mcp

Cursor (~/.cursor/mcp.json)

{ "mcpServers": { "memecub": { "url": "https://memecub.com/mcp" } } }

VS Code (.vscode/mcp.json)

{ "servers": { "memecub": { "type": "http", "url": "https://memecub.com/mcp" } } }

Claude Desktop / claude.ai: Settings → Connectors → Add custom connector → https://memecub.com/mcp

Codex and any agent that reads skills: use the Agent Skill below.

Then just ask:

Add 3 memes to draft.md where they fit.

Find me a facepalm meme, commercial use only.

给这篇文章配几张表情包。

MCP tools

ToolWhat it does
search_memesSearch by reaction, feeling or character. Filters: commercial_only, no_credit, kind (meme, gif, emoji, artwork, photo), min_size
match_articleRead an article, pick the spots that deserve a meme, return the article with images inserted (needs a key)
get_memeFull details for one image: license, source, author, credit line, tags
list_categoriesLibrary categories

You can try it without a key (20 searches a day per IP). Add Authorization: Bearer <key> (run npx memecub login, or create one at memecub.com/dashboard) to use your credits: a free account gets 1,000 a month, a search costs 1 and match_article costs 20 per image it places. Plans and credit packs: memecub.com/pricing.

Agent skill

skills/memecub/SKILL.md teaches an agent to place memes into writing with plain curl. No MCP, no dependencies, works in Claude Code, Codex and Cursor.

npx skills add liyupi/memecub

Or by hand:

# Claude Code: ~/.claude/skills   Codex: ~/.codex/skills   Cursor: ~/.cursor/skills
mkdir -p ~/.claude/skills/memecub
curl -s https://memecub.com/skill.md -o ~/.claude/skills/memecub/SKILL.md

REST API

curl -sG https://memecub.com/api/v1/search --data-urlencode "q=facepalm" -d limit=1
{
  "data": [{
    "title": "Facepalm",
    "url": "https://gpic.code-nav.cn/memecub/public/12vw20qg0awo.jpg",
    "page_url": "https://memecub.com/meme/12vw20qg0awo-facepalm",
    "width": 679, "height": 600, "kind": "meme",
    "license": { "code": "web", "commercial_use": false, "attribution_required": false },
    "markdown": "![Facepalm](https://gpic.code-nav.cn/memecub/public/12vw20qg0awo.jpg)"
  }]
}

All endpoints and limits: memecub.com/developers.

CLI and JS client

memecub on npm, source in cli/. Node 18+.

npx memecub search "facepalm" --limit 5
npm i -g memecub                                  # or install the `memecub` command
memecub search "facepalm" --limit 5
memecub search "mind blown" --commercial          # only images cleared for commercial use
memecub match ./article.md --count 4 > article.with-memes.md
import { MemecubClient } from "memecub";

const client = new MemecubClient("https://memecub.com", process.env.MEMECUB_API_KEY);
const { data } = await client.search({ q: "mind blown", limit: 5, commercialOnly: true });

The website

Everything the agent sees is also browsable at memecub.com: search, topic pages, one-click copy and download, and the article tool in the browser.

HomeTopic pageAgent setup
memecub home pageDrake memes topic pageSetup guide for AI agents

FAQ

Is it free? Browsing memecub.com is free, and so is light API use: 20 keyless searches a day, or 1,000 credits a month with a free account. Heavier use runs on plans and credit packs.

Can I use the images commercially? Check license.commercial_use on each result. Memes collected from the web are false: copyright belongs to their creators and the source link is kept. Openly licensed images (CC0, public domain, CC BY and similar) are true and come with the credit line when the license needs one. Pass commercial_only: true (MCP) or commercial=1 (REST) to get only those.

Is the website open source? No. This repository holds the integrations (MCP descriptor, Agent Skill, CLI and client). The site and its data pipeline are run by memecub.

Found a problem with an image? Use the report button on its page, or see memecub.com/dmca.

License

Code in this repository is MIT. Images are not covered by MIT; each result carries its own license.

If memecub saves your agent a trip to the image search, a ⭐ helps others find it.

// faq

What is memecub?

Meme search & auto meme placement for AI agents. Remote MCP server, Agent Skill, CLI and REST API that let Claude Code, Cursor and Codex find reaction memes, GIFs and Chinese 表情包 by feeling and insert them into articles. 表情包搜索 · AI 配图 · 斗图 MCP. It is open-source on GitHub.

Is memecub free to use?

memecub is open-source under the MIT license, so it is free to use.

What category does memecub belong to?

memecub is listed under skills in the Claudeers registry of Claude-compatible tools.

28 views
★ 36 stars
unclaimed
updated 21 days ago

// embed badge

memecub on Claudeers
[![Claudeers](https://claudeers.com/api/badge/memecub.svg)](https://claudeers.com/memecub)

// retro hit counter

memecub hit counter
[![Hits](https://claudeers.com/api/counter/memecub.svg)](https://claudeers.com/memecub)

// reviews

// guestbook

0/500

// related in Claude Skills

🔓

An agentic skills framework & software development methodology that works.

// skillsobra/⟨Shell⟩★ 314,126◷ MIT[ claude ]
🔓

Public repository for Agent Skills

// skillsanthropics/⟨Python⟩★ 188,182[ claude ]
🔓

AI coding assistant skill (Claude Code, Codex, OpenCode, Cursor, Gemini CLI, and more). Turn any folder of code, SQL schemas, R scripts, shell scripts, docs,…

// skillsGraphify-Labs/⟨Python⟩★ 149,064◷ MIT[ claude ]
🔓

💫 Toolkit to help you get started with Spec-Driven Development

// skillsgithub/⟨Python⟩★ 148,200◷ MIT[ claude ]
→ see how memecub connects across the ecosystem