Emoji Finder by langbot-team

# Emoji Finder

Search emoji by keyword; count or strip emoji in text. Pure stdlib (`unicodedata`).

```
python scripts/run.py search fire
python scripts/run.py search cat -n 3
echo "great job 🔥🚀" | python scripts/run.py count -
echo "hello 👋 world 🌍" | python scripts/run.py strip -
python scripts/run.py count message.txt
```

Built-in map of ~130 common emoji keywords.


---
name: emoji-finder
display_name: Emoji Finder
description: "Search emoji by keyword to get the character and name, and count or strip emoji from text. Use to look up an emoji or clean emoji out of a string. Triggers: find emoji, emoji for word, count emoji, remove emoji, strip emoji."
---

# Emoji Finder

Look up emoji by keyword, or count/remove emoji in a piece of text.

## When to use
The user wants the emoji for a word (e.g. "fire", "rocket"), wants to count how many emoji a message has, or wants emoji stripped out of text.

## How to use
Run `scripts/run.py` with a subcommand:
- `python scripts/run.py search fire` — list matching emoji with names.
- `python scripts/run.py search cat -n 3` — limit results.
- `echo "great job 🔥🚀" | python scripts/run.py count -` — count emoji in stdin text.
- `echo "hello 👋 world 🌍" | python scripts/run.py strip -` — remove emoji.
- `python scripts/run.py count message.txt` — count emoji in a file.

`search` matches exact keywords first, then substring matches, from a built-in map of ~130 common emoji.

## Pitfalls
- The keyword map is curated (~130 entries), not exhaustive; obscure terms may return nothing (exit 1).
- `count`/`strip` use Unicode ranges + `unicodedata` heuristics; ZWJ sequences and variation selectors are handled but very new emoji may slip through.
- `strip` preserves all surrounding text and whitespace exactly (no trailing newline added).