Agent skill

Yelp Search

Search Yelp for local businesses, get contact info, ratings, and hours.

Install Yelp Search

skills CLI

$ npx skills add letta-ai/skills --skill yelp-search -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install letta-ai/skills yelp-search --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/letta-ai/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/tools/yelp-search .claude/skills/yelp-search && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "yelp-search" agent skill from https://github.com/letta-ai/skills/tree/main/tools/yelp-search into .claude/skills/yelp-search/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "yelp-search", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/letta-ai/skills/tree/main/tools/yelp-search

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add letta-ai/skills --skill yelp-search -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install letta-ai/skills yelp-search --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/letta-ai/skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/tools/yelp-search .agents/skills/yelp-search && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "yelp-search" agent skill from https://github.com/letta-ai/skills/tree/main/tools/yelp-search into .agents/skills/yelp-search/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "yelp-search", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add letta-ai/skills --skill yelp-search -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install letta-ai/skills yelp-search --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/letta-ai/skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/tools/yelp-search .cursor/skills/yelp-search && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "yelp-search" agent skill from https://github.com/letta-ai/skills/tree/main/tools/yelp-search into .cursor/skills/yelp-search/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "yelp-search", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/letta-ai/skills.git --path tools/yelp-search

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add letta-ai/skills --skill yelp-search -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install letta-ai/skills yelp-search --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/letta-ai/skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/tools/yelp-search .gemini/skills/yelp-search && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "yelp-search" agent skill from https://github.com/letta-ai/skills/tree/main/tools/yelp-search into .gemini/skills/yelp-search/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "yelp-search", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install letta-ai/skills yelp-search

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add letta-ai/skills --skill yelp-search -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/letta-ai/skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/tools/yelp-search .github/skills/yelp-search && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "yelp-search" agent skill from https://github.com/letta-ai/skills/tree/main/tools/yelp-search into .github/skills/yelp-search/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "yelp-search", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add letta-ai/skills --skill yelp-search -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install letta-ai/skills yelp-search --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/letta-ai/skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/tools/yelp-search .opencode/skills/yelp-search && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "yelp-search" agent skill from https://github.com/letta-ai/skills/tree/main/tools/yelp-search into .opencode/skills/yelp-search/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "yelp-search", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: yelp-search
GitHub stars: 149
Token cost: ~1.4k tokens
SKILL.md length: 492 words
Files: 7 (incl. scripts)
Skills in repo: 22
Repo updated: Oct 1, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Search Yelp for local businesses, get contact info, ratings, and hours.

Works in 2 steps: Yelp API Key (Required) → Browser-Use for Reviews (Optional)
Finding services (cleaners
SKILL.md covers Setup, Scripts, Best Practices and Response Data, plus 1 more section
Runs Python scripts from its folder; calls uv; reaches yelp.com; needs YELP_API_KEY and OPENAI_API_KEY

What it does

Yelp Search is an agent skill from letta-ai/skills. Search Yelp for local businesses, get contact info, ratings, and hours. Use when finding services (cleaners, groomers, restaurants, etc.), looking up business phone numbers to text, or checking ratings before booking. Triggers on queries about finding businesses, restaurants, services, or "look up on Yelp".

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including scripts (for example `scripts/details.py`, `scripts/get_reviews.py` and `scripts/phone_search.py`).

It sits in Data & Analytics, covering Web scraping. It works with Browserbase. The repository describes itself as: A shared repository for skills. Intended to be used with Letta Code, Claude Code, Codex CLI, and other agents that support skills. The licence is MIT.

When your agent uses it

Finding services (cleaners
Looking up business phone numbers to text
Checking ratings before booking
Queries about finding businesses

Example prompts

“look up on Yelp”
“/yelp-search”

Requirements

Python 3
A credential in YELP_API_KEY
A credential in OPENAI_API_KEY

Workflow steps

2 steps, taken from the step headings in SKILL.md.

Yelp API Key (Required)
Browser-Use for Reviews (Optional)

What it can do on your machine

Read from SKILL.md and the folder at commit 6785511. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 5 files in scripts/ (Python), which the agent can run.
Shell commands in SKILL.md call:
- uv
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
- yelp.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
- YELP_API_KEY
- OPENAI_API_KEY
- BROWSERBASE_API_KEY
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Yelp Search loads about 1.4k tokens when it runs. Until then it costs about 80 tokens; SKILL.md has 492 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~80
When it runs · the whole SKILL.md, loaded when a task matches: ~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

NoteMentions a .env fileSKILL.md:19
```
Add to your `.env` file:
```
NoteMentions a .env fileSKILL.md:34
```
**Add to `.env`:**
```

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from letta-ai/skills at commit 6785511, republished under its MIT licence (© letta-ai). 492 words, ~1,374 tokens.

Download SKILL.mdSave it as .claude/skills/yelp-search/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.

name: yelp-search
description: Search Yelp for local businesses, get contact info, ratings, and hours. Use when finding services (cleaners, groomers, restaurants, etc.), looking up business phone numbers to text, or checking ratings before booking. Triggers on queries about finding businesses, restaurants, services, or "look up on Yelp".

Yelp Search Integration

Search for local businesses on Yelp to find services, get contact information, check ratings, and retrieve hours of operation.

Setup

1. Yelp API Key (Required)

Go to https://www.yelp.com/developers
Create an account or sign in
Click "Create App" and fill out the form
Copy your API Key

Add to your .env file:

YELP_API_KEY=your_api_key_here

2. Browser-Use for Reviews (Optional)

Only needed if you want to extract review text (slow, ~30-60s per request).

Install dependencies:

bash

uv add browser-use playwright langchain-openai
uv run playwright install chromium

Add to .env:

OPENAI_API_KEY=your_openai_key_here

Note: Review extraction uses browser-use to search DuckDuckGo (since Yelp blocks direct scraping). For most use cases, the rating + review_count from the API is sufficient.

Scripts

All scripts are in tools/yelp-search/scripts/ and should be run with uv run python.

search.py - Find Businesses (Primary Tool)

bash

uv run python tools/yelp-search/scripts/search.py "search term" --location "City, State"

Options:

Flag	Description	Example
`--location`, `-l`	City, address, or zip	`"San Francisco"` or `"94123"`
`--latitude/--longitude`	GPS coordinates	`--latitude 37.78 --longitude -122.41`
`--limit`, `-n`	Number of results (default: 5)	`-n 10`
`--sort-by`	Sort order	`rating`, `distance`, `review_count`, `best_match`
`--price`	Price filter (1-4)	`--price 1,2` for $ and $$ only
`--json`	Output raw JSON

Examples:

bash

# Find top-rated dog groomers
uv run python tools/yelp-search/scripts/search.py "dog groomer" -l "San Francisco" --sort-by rating

# Find cheap restaurants nearby
uv run python tools/yelp-search/scripts/search.py "restaurants" -l "94123" --price 1,2 --sort-by distance

# Search near a specific address
uv run python tools/yelp-search/scripts/search.py "laundry pickup" -l "123 Main St, San Francisco"

details.py - Get Business Hours & Info

bash

uv run python tools/yelp-search/scripts/details.py "business-alias"

The business alias is in the Yelp URL (e.g., the-laundry-corner-san-francisco).

phone_search.py - Reverse Lookup

bash

uv run python tools/yelp-search/scripts/phone_search.py "+14155551234"

get_reviews.py - Extract Review Text (Slow)

bash

uv run python tools/yelp-search/scripts/get_reviews.py "Business Name" -l "City" -n 3

Note: Uses browser-use which is slow (~30-60s). Yelp blocks direct scraping, so it searches DuckDuckGo for cached reviews as a workaround.

scrape_reviews.py - Direct Yelp Scraping (Alternative)

bash

uv run python tools/yelp-search/scripts/scrape_reviews.py "https://www.yelp.com/biz/business-alias" -n 5

Requires Browserbase credentials:

BROWSERBASE_API_KEY=your_key_here
BROWSERBASE_PROJECT_ID=your_project_id

Note: Uses Browserbase with proxies to bypass Yelp's CAPTCHA. More reliable than get_reviews.py but requires a Browserbase account.

Best Practices

Evaluating Quality Without Review Text

The API provides rating + review_count which is usually sufficient:

Rating	Review Count	Interpretation
4.5+	50+	Excellent, reliable data
4.5+	<20	Promising but limited data
4.0-4.4	100+	Good, well-established
<4.0	any	Proceed with caution

Show full SKILL.md (206 more words)Show less

Finding Services with Specific Needs

When looking for services with specific requirements (weekend hours, pickup/delivery, etc.):

Search with --sort-by rating to get best options
Get details on top candidates to check hours
Filter for businesses open when you need them
Contact directly to confirm specific services (pickup, delivery, etc.) since Yelp doesn't always have this info

Search Tips

Use specific terms: "laundry pickup" not just "laundry"
Search near an address for accurate distance: -l "123 Main St, City"
Sort by rating first, then check distance on results
Check review_count - high ratings with few reviews may be unreliable

Response Data

Each business result includes:

name - Business name
phone - Phone number (use for texting/calling)
rating - Yelp rating (1-5 stars)
review_count - Number of reviews
price - Price level ($ to $$$$)
location - Full address
hours - Operating hours by day (in details)
distance - Distance from search location
categories - Business categories
is_open_now - Current open/closed status

Limitations

Feature	Status	Notes
Business search	✅ Works	Fast, reliable
Business details	✅ Works	Includes hours
Phone lookup	✅ Works	Reverse search
Review text (API)	❌ Paid only	Requires enterprise tier
Review text (scraping)	⚠️ Slow	browser-use workaround via DuckDuckGo

Free API tier: 500 calls/day
Results limited to 50 per request
Some business info (pickup/delivery) not in API - contact directly

Files

SKILL.md and 6 other files (scripts) in tools/yelp-search of letta-ai/skills.

SKILL.md
LICENSE
scripts/details.py
scripts/get_reviews.py
scripts/phone_search.py
scripts/scrape_reviews.py
scripts/search.py

Open the folder on GitHubat commit 6785511

Compare with similar skills

Yelp Search next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Yelp Search compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Yelp Search this skillletta-ai/skills	149	—	~1.4k	Automated safety check: Notes	MIT	9 days ago
Browserbase SessionsLeoYeAI/openclaw-master-skills	2.2k	—	~6k	Automated safety check: Pass	MIT	2 mo ago
Tmuxtrpc-group/trpc-agent-go	1.9k	23 repos	~868	Automated safety check: Pass	Apache-2.0	yesterday
Ketch1broseidon/ketch	702	1 repos	~3.9k	Automated safety check: Pass	MIT	2 days ago
Boss Zhipin Scrapereatmoreduck/boss-zhipin-scraper	1.5k	—	~2.6k	Automated safety check: Pass	MIT	today
Crawl4AI Web Scrapingsmallnest/goclaw	599	1 repos	~2.5k	Automated safety check: Pass	MIT	6 mo ago

Similar skills

Browserbase Sessions
LeoYeAI/openclaw-master-skills
Create and manage persistent Browserbase cloud browser sessions with authentication persistence.
2.2k GitHub stars~6k tokensUpdated 2 mo ago
Data & AnalyticsAuto-check passed
Tmux
trpc-group/trpc-agent-go
Remote-control tmux sessions for interactive CLIs by sending keystrokes and scraping pane output.
1.9k GitHub starsUsed in 23 repos~868 tokens
Data & AnalyticsAuto-check passed
Ketch
1broseidon/ketch
Research skill for ketch — a fast stateless CLI for web search, OSS code search, curated library docs, page scraping, and site crawling; an optional MCP server exists for operators who want it, but…
702 GitHub starsUsed in 1 repo~3.9k tokens
Data & AnalyticsAuto-check passed
Boss Zhipin Scraper
eatmoreduck/boss-zhipin-scraper
Scrape BOSS直聘 (job listing site) via Chrome CDP. An agent skill from eatmoreduck/boss-zhipin-scraper.
1.5k GitHub stars~2.6k tokensUpdated today
Data & AnalyticsAuto-check passed
Crawl4AI Web Scraping
smallnest/goclaw
Scrapes sites, handles JavaScript-heavy pages and extracts structured data with Crawl4AI, through its crwl CLI or Python SDK, including schema-based extraction without an LLM.
599 GitHub starsUsed in 1 repo~2.5k tokens
Data & AnalyticsAuto-check passed
Ax
yusukebe/ax
Use the ax CLI instead of curl + throwaway parsing scripts whenever you fetch a URL, explore an unknown web page, or extract structured data from HTML.
719 GitHub starsUsed in 1 repo~918 tokens
Data & AnalyticsAuto-check passed

Questions about Yelp Search

What does Yelp Search do?

Search Yelp for local businesses, get contact info, ratings, and hours. Yelp Search is an agent skill from letta-ai/skills. Search Yelp for local businesses, get contact info, ratings, and hours.

When should I use Yelp Search?

Yelp Search fits situations like: finding services (cleaners; looking up business phone numbers to text; checking ratings before booking; queries about finding businesses.

How do I install Yelp Search in Claude Code?

Run `npx skills add letta-ai/skills --skill yelp-search -a claude-code`. Or copy the skill folder (tools/yelp-search in letta-ai/skills) into .claude/skills/yelp-search in your project. Claude Code loads it when a task matches its description.

How do I install Yelp Search in Codex?

Run `npx skills add letta-ai/skills --skill yelp-search -a codex`. Or copy the skill folder (tools/yelp-search in letta-ai/skills) into .agents/skills/yelp-search in your project. Codex loads it when a task matches its description.

Can I use Yelp Search in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add letta-ai/skills --skill yelp-search -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/yelp-search, .gemini/skills/yelp-search, .github/skills/yelp-search and .opencode/skills/yelp-search in your project.

What does Yelp Search need to run?

Going by SKILL.md and its folder, Yelp Search needs Python for the scripts in its folder, the command-line tools its instructions call (uv) and credentials named YELP_API_KEY, OPENAI_API_KEY and BROWSERBASE_API_KEY. Our summary lists: Python 3; A credential in YELP_API_KEY; A credential in OPENAI_API_KEY.

Does Yelp Search access the network?

SKILL.md names 1 domain. In commands or code: yelp.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Yelp Search safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Yelp Search use?

Yelp Search is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Yelp Search use?

About 1.4k tokens (SKILL.md is roughly 5.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Yelp Search?

Skills that share tags, products or a category with Yelp Search: Browserbase Sessions (LeoYeAI/openclaw-master-skills, 2.2k stars), Tmux (trpc-group/trpc-agent-go, 1.9k stars), Ketch (1broseidon/ketch, 702 stars) and Boss Zhipin Scraper (eatmoreduck/boss-zhipin-scraper, 1.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Yelp Search?

letta-ai (a GitHub organization) maintains it in letta-ai/skills, which has 149 GitHub stars. The repository holds 22 skills in this directory. The repository was last updated on October 1, 2026.

Source: letta-ai/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Yelp Search

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Yelp Search Integration

Setup

1. Yelp API Key (Required)

2. Browser-Use for Reviews (Optional)

Scripts

search.py - Find Businesses (Primary Tool)

details.py - Get Business Hours & Info

phone_search.py - Reverse Lookup

get_reviews.py - Extract Review Text (Slow)

scrape_reviews.py - Direct Yelp Scraping (Alternative)

Best Practices

Evaluating Quality Without Review Text

Finding Services with Specific Needs

Search Tips

Response Data

Limitations

Files

Compare with similar skills

Similar skills

More from letta-ai/skills

Related

Questions about Yelp Search