Xpersona
Claim this agent
agentCLAWHUBUnverified

Yelp API

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.

OpenClaw
View on ClawHubHomepage

Rank

62

Safety

84

Downloads

5.7k

Updated

Oct 9, 2026

Version

0.1.0

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 5.7K downloads reported by the source. Last updated 10/9/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor
Clawhubvendor · observed Oct 9, 2026
Protocol compatibility
OpenClawcompatibility · observed Oct 9, 2026
Adoption signal
5.7K downloadsadoption · observed Oct 9, 2026
Latest release
0.1.0release · observed Aug 21, 2026
Handshake status
UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s17dcnrbn2f5qhk65dscfdycw98cw0kk:yelp-api
  1. Install using `clawhub skill install s17dcnrbn2f5qhk65dscfdycw98cw0kk:yelp-api` in an isolated environment before connecting it to live workloads.
  2. No published capability contract is available yet, so validate auth and request/response behavior manually.
  3. Review the upstream CLAWHUB listing at https://clawhub.ai/fetcher-sh/yelp-api before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-fetcher-sh-yelp-api/snapshot"

Documentation

CLAWHUB

8,088 characters of source documentation, loaded on request.

Extracted files

3 files captured from the source.

SKILL.md

---
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" \

_meta.json

{
  "ownerId": "kn72ajfa5w5c1jsrtjnz66f6nx8cwz9b",
  "slug": "yelp-api",
  "version": "0.1.0",
  "publishedAt": 1787305596177
}

skill-card.md

## Description:

A Yelp API alternative on fetcher.sh for searching local businesses, retrieving business details by ID or Yelp URL handle, and fetching business reviews through paid JSON HTTP endpoints.

This skill is ready for commercial/non-commercial use.

## Publisher:

[fetcher-sh](https://clawhub.ai/user/fetcher-sh)

### License/Terms of Use:

MIT-0

## Use Case:

External developers and agents use this skill to search Yelp-style local business data, retrieve business details, and fetch reviews without using the Yelp Fusion API approval flow.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: The skill sends search queries, location inputs, business identifiers, and review requests to a third-party service.

Mitigation: Use only when the user or deployment policy permits sharing those request details with fetcher.sh.

Risk: API use is paid through prepaid bearer-key credits or x402 pay-per-call payment, and the artifact notes that refunds are not provided on upstream failures.

Mitigation: Review fetcher.sh pricing and payment mechanics before enabling the skill, and avoid exposing credentials in shared logs or prompts.

## Reference(s):

- [ClawHub skill page](https://clawhub.ai/fetcher-sh/skills/yelp-api)
- [Server-resolved GitHub provenance](https://github.com/fetcher-sh/fetcher-skills/tree/main/skills/yelp)
- [Full agent setup](https://yelp.fetcher.sh/skill.md)
- [OpenAPI 3.1 contract](https://yelp.fetcher.sh/openapi.json)
- [Condensed catalog](https://yelp.fetcher.sh/llms.txt)
- [Yelp Fetcher site](https://yelp.fetcher.sh)

## Skill Output:

**Output Type(s):** [guidance, shell commands, configuration, code]

**Output Format:** [Markdown with inline bash, JSON, and HTTP endpoint examples]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Guides agents to call third-party paid JSON endpoints for local business search, details, and reviews.]

## Skill Version(s):

0.1.0 (source: release evidence)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

Related agents

Same protocol, similar job.

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW
Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

Machine-readable data

The same record, as JSON, for agents and crawlers.

{
  "facts": [
    {
      "factKey": "vendor",
      "category": "vendor",
      "label": "Vendor",
      "value": "Clawhub",
      "href": "https://clawhub.ai/fetcher-sh/skills/yelp-api",
      "sourceUrl": "https://clawhub.ai/fetcher-sh/skills/yelp-api",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-09T03:48:25.283Z",
      "isPublic": true
    },
    {
      "factKey": "protocols",
      "category": "compatibility",
      "label": "Protocol compatibility",
      "value": "OpenClaw",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-fetcher-sh-yelp-api/contract",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-fetcher-sh-yelp-api/contract",
      "sourceType": "contract",
      "confidence": "medium",
      "observedAt": "2026-10-09T03:48:25.283Z",
      "isPublic": true
    },
    {
      "factKey": "traction",
      "category": "adoption",
      "label": "Adoption signal",
      "value": "5.7K downloads",
      "href": "https://clawhub.ai/fetcher-sh/yelp-api",
      "sourceUrl": "https://clawhub.ai/fetcher-sh/yelp-api",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-09T03:48:25.283Z",
      "isPublic": true
    },
    {
      "factKey": "latest_release",
      "category": "release",
      "label": "Latest release",
      "value": "0.1.0",
      "href": "https://clawhub.ai/fetcher-sh/yelp-api",
      "sourceUrl": "https://clawhub.ai/fetcher-sh/yelp-api",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-08-21T09:46:36.177Z",
      "isPublic": true
    },
    {
      "factKey": "handshake_status",
      "category": "security",
      "label": "Handshake status",
      "value": "UNKNOWN",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-fetcher-sh-yelp-api/trust",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-fetcher-sh-yelp-api/trust",
      "sourceType": "trust",
      "confidence": "medium",
      "observedAt": null,
      "isPublic": true
    }
  ],
  "events": [
    {
      "eventType": "release",
      "title": "Release 0.1.0",
      "description": "- Initial release of the yelp skill, providing a pay-per-call Yelp API alternative via fetcher.sh. - Supports business search by query and location, retrieving details by ID or Yelp URL handle/slug, and fetching business reviews. - No Yelp Fusion API app approval or daily call caps required; pay with USDC (x402) or prepaid credits. - All endpoints return clean JSON and cost $0.003 per call. - Includes full documentation for authentication, endpoints, error handling, and agent setup.",
      "href": "https://clawhub.ai/fetcher-sh/yelp-api",
      "sourceUrl": "https://clawhub.ai/fetcher-sh/yelp-api",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-08-21T09:46:36.177Z",
      "isPublic": true
    }
  ]
}

Record generated Oct 9, 2026.

Sponsored

Ads related to Yelp API and adjacent AI workflows.