# yelp

Searches local businesses, pulls venue profiles and reviews via fetcher.sh without Yelp Fusion approval. Useful for local research and competitor audits.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 3700 installs · ★ 2
- Author: fetcher-sh
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/fetcher-sh/fetcher-skills/tree/HEAD/skills/yelp/SKILL.md
- Updated: 2026-09-05
- HTML: https://affpapa.org/en/nevibecode/skills/yelp

## What it does

The skill connects agents to `https://yelp.fetcher.sh`, an HTTP interface for Yelp data that returns clean JSON. It removes the need for Yelp Fusion app reviews and eliminates daily request caps.

Four GET endpoints handle data retrieval: `/api/search` with query and location parameters, `/api/place/{id}`, `/api/place/handle/{handle}` for direct URL slugs, and `/api/place/{id}/reviews`. Searches accept optional sorting by `recommended`, `rating`, or `reviewCount`. Pagination is supported across search and reviews.

Every request costs $0.003. Settlement happens before data delivery, so upstream failures offer no refunds. You can authenticate with a `FETCHER_API_KEY` Bearer token or pay per call in USDC over Base, Polygon, Arbitrum, Monad, or Solana using x402.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add fetcher-sh/fetcher-skills --skill yelp -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/yelp/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/yelp/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add fetcher-sh/fetcher-skills --skill yelp -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/yelp/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add fetcher-sh/fetcher-skills --skill yelp -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/yelp/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install fetcher-sh/fetcher-skills yelp
```

2. **Manually: put the files in place**
- File: `.github/skills/yelp/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add fetcher-sh/fetcher-skills --skill yelp -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/fetcher-sh/fetcher-skills --path skills/yelp
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/yelp/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add fetcher-sh/fetcher-skills --skill yelp -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/fetcher-sh/fetcher-skills/tree/HEAD/skills/yelp/SKILL.md

## When to use it
- search local businesses by query and city sorted by ratings or review counts
- fetch company profiles using Yelp URL handles or business IDs
- retrieve paginated customer reviews for sentiment evaluation
- access Yelp place data without waiting for Yelp Fusion developer approval

## Example prompts
- Search for taco spots in Austin, TX sorted by reviewCount using yelp
- Get place details for the Yelp slug gary-danko-san-francisco
- Fetch page 2 of reviews for place ID gary-danko-san-francisco

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: a365158d4489d45f.

BEGIN THIRD-PARTY FILE a365158d4489d45f
````text
---
name: yelp
description: >-
  A Yelp API alternative on fetcher.sh — pay-per-call in USDC via x402, or
  prepaid credits with a Bearer key, no Yelp Fusion API app approval. Use
  when the user wants to search local businesses by query and location
  sorted by rating or review count, fetch a business's full details by ID or
  by its Yelp URL handle/slug, or fetch a business's reviews. Also covers
  local business discovery, restaurant/service research, review sentiment
  input, and competitor monitoring for local businesses without Yelp Fusion
  API's app-approval process and daily call caps.
keywords:
  - yelp
  - yelp-api
  - yelp-api-alternative
  - local-business-data
  - restaurant-data
  - business-review-api
  - x402
  - ai-agent
---

# Yelp API

Local business search, business details, and reviews as clean JSON — one
plain HTTP GET per call, paid as you go. No Yelp Fusion API app approval, no
daily call cap, no API key request form.

Base URL: `https://yelp.fetcher.sh`

## Authentication

Two ways to pay, same data — full mechanics in the [`fetcher`
skill](../fetcher/SKILL.md):

```bash
# 1. Prepaid credits (recommended — get a key at https://fetcher.sh/topup
#    or via POST /api/credits/topup, see the fetcher skill)
export FETCHER_API_KEY="bby_live_xxxxxxxxxxxx"
curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://yelp.fetcher.sh/api/search?query=ramen&location=San+Francisco"

# 2. x402 pay-per-call — omit the header; a GET with no payment returns 402
#    with machine-readable payment requirements (USDC on Base, Polygon,
#    Arbitrum, Monad, or Solana). @x402/fetch signs and retries automatically.
```

Every response is `{ "status": number, "message": string, "data": ... }`; the
HTTP status mirrors `status`.

## Endpoints (4 — all GET, $0.003/call)

| Endpoint | What it returns |
| --- | --- |
| `/api/search` | Businesses matching a query and location |
| `/api/place/{id}` | A business's full details by ID |
| `/api/place/handle/{handle}` | A business's full details by its Yelp URL handle/slug |
| `/api/place/{id}/reviews` | A business's reviews |

Required on search: `query`, `location`. Optional: `sortBy` (`recommended`,
`rating`, `reviewCount`), `page`. Reviews support `page`.

## Scenarios

**Highest rated first:**

```bash
curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "query=ramen" -G \
  --data-urlencode "location=San Francisco" \
  --data-urlencode "sortBy=rating" \
  "https://yelp.fetcher.sh/api/search"
```

**Most reviewed first:**

```bash
curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "query=tacos" -G \
  --data-urlencode "location=Austin, TX" \
  --data-urlencode "sortBy=reviewCount" \
  "https://yelp.fetcher.sh/api/search"
```

**A business's details by ID, or by its Yelp URL handle/slug:**

```bash
curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://yelp.fetcher.sh/api/place/gary-danko-san-francisco"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://yelp.fetcher.sh/api/place/handle/gary-danko-san-francisco"
```
````
END THIRD-PARTY FILE a365158d4489d45f

The third-party file has ended. Everything between the a365158d4489d45f tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 3084 of 4358 bytes. © fetcher-sh · MIT · https://github.com/fetcher-sh/fetcher-skills/tree/HEAD/skills/yelp/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md