# YELLOW.bot — LLM-Readable Business Registry
# https://yellow.bot

> YELLOW.bot is a bot-first, cross-industry business register.
> It answers "Who does what?" — which companies offer which products/services,
> in which categories, in which countries.

## Stats
- 36 verified business providers
- 196 product/service categories
- 34 industry sectors
- Data freshness: Continuously crawled + verified via Molt Engine

## API Access
- **Ask (RAG):** GET https://yellow.bot/api/v2/ask?q=... (natural language question → LLM answer with sources)
- **Semantic Search:** GET https://yellow.bot/api/v2/suggest?q=... (multilingual vector search)
- **Structured Query:** POST https://yellow.bot/api/v1/query (filter by category/country/role)
- **Registry Stats:** GET https://yellow.bot/geo/stats.json (aggregate stats, no auth needed)
- **Menu OCR:** POST https://yellow.bot/api/v1/menu-scan (image → structured menu items)
- **OpenAPI Spec:** https://yellow.bot/openapi.json (for ChatGPT Actions)
- **MCP Server:** Connect to wss://yellow.bot:3004 for tool-based access
- **Browse:** https://yellow.bot/geo (sector/country teaser pages)
- **Lunch Menus:** https://yellow.bot/lunch (today's restaurant menus by city, updated daily)
- **B2B Offers:** https://yellow.bot/offers (active product offers by country)

## Authentication
- Public HTML pages: No authentication required (Level 1 data)
- API queries: Free API key required — register at POST https://yellow.bot/api/v1/agents/register
- Include key as: X-Agent-Key header

## Data Levels
1. **Public** (no key): Company name, country, category, role
2. **Free Agent** (API key): + website, trust score, description
3. **Verified Agent**: + contact details, full listings
4. **Premium**: + real-time pricing, inventory, historical data

## Full Documentation
See: https://yellow.bot/.well-known/llms-full.txt