---
name: visityour-biz
description: Search, query, and interact with the visityour.biz directory for agent-ready local businesses, opening hours, pricing, and services.
version: 1.0.0
author: visityour.biz
license: MIT
compatibility: claude, chatgpt, cursor, gemini, autogen
---

# visityour.biz Agent Skill

This skill enables autonomous AI agents to search, filter, and extract verified business information from the **visityour.biz** directory.

## Overview
visityour.biz provides structured local business data optimized for AI agent consumption, including address verification, opening hours, pricing tiers, and contact information.

## Available Actions

### 1. Search Businesses
Query businesses by keyword, category, or location.
- **Endpoint**: `GET https://visityour.biz/api/v1/businesses?q={query}&category={category}`
- **MCP Tool**: `search_businesses` with argument `{ "query": "pilates in brickell" }`

### 2. Retrieve Business Details
Fetch full structured profile of a business including services, pricing, and reviews.
- **Endpoint**: `GET https://visityour.biz/api/v1/businesses/{id}`
- **MCP Tool**: `get_business_details` with argument `{ "id": "crossfit-miami-beach" }`

### 3. Natural Language Directory Search (NLWeb)
Ask natural language questions to the directory with real-time SSE streaming.
- **Endpoint**: `POST https://visityour.biz/ask` with JSON `{ "query": "Which gyms in Miami offer cryotherapy and 24-hour access?" }`
- **Streaming**: Set `Prefer: streaming=true` header for `text/event-stream` SSE response.

### 4. Bulk Operations
Execute multiple read/write operations in a single HTTP batch request.
- **Endpoint**: `POST https://visityour.biz/api/v1/batch`
- **Header**: `Idempotency-Key: <unique-uuid>`

## Authentication
Public read operations do not require authentication. For elevated rate limits or write operations, obtain a Bearer token via OAuth 2.0 Client Credentials or anonymous agent registration:
- **Registration**: `POST https://visityour.biz/api/oauth/register`
- **Guide**: [Authentication Guide](https://visityour.biz/auth.md)