# Operator: Local Business Intelligence for AI Agents
> Operator (operator.fyi) is a living census of US local businesses: city pages, trade pages, market intelligence, and business profiles ranked by the Operator Health score.

## About
Operator helps consumers, business owners, investors, lenders, franchisors, and AI assistants understand local businesses. Public pages include market rankings, reviews, contact details, service categories, city/trade context, and the Operator Health score.

## Key URL Patterns
Use these canonical URL shapes when crawling, citing, or constructing links.

| Pattern | Content type | Example |
|---------|--------------|---------|
| /markets/{city-slug}/ | City market page | https://operator.fyi/markets/honolulu/ |
| /trades/{trade-slug}/ | Trade category page | https://operator.fyi/trades/hvac/ |
| /{trade-slug}/ | Trade landing page | https://operator.fyi/hvac/ |
| /{trade-slug}/{city-slug}/ | City + trade landing page | https://operator.fyi/hvac/honolulu/ |
| /{trade-slug}/{city-slug}/{business-slug}/ | Business profile | https://operator.fyi/hvac/kapolei/shobus-ac/ |
| /states/{state-slug}/ | State market index | https://operator.fyi/states/hawaii/ |
| /api/markets/{city-slug}/{trade-slug}/data.json | Market data JSON | https://operator.fyi/api/markets/honolulu/hvac/data.json |

## Operator Health Score Data Dictionary
The Health score is a 0-100 composite score computed nightly. Public pages and owner workflows use this canonical six-component dictionary:

| Field | Label | Weight | Range | Meaning | Primary public inputs |
|-------|-------|--------|-------|---------|-----------------------|
| score | Health score | 100 | 0-100 | Overall local-business operating health and market strength | Weighted sum of the six components below |
| reviews | Reviews & rating | 25 | 0-25 | Review quality, volume, and recency | Google/Yelp/Meta rating, review count, review velocity |
| rank | Market rank | 20 | 0-20 | Position in the local city + trade leaderboard | Market rank, category/city peer set, tie-breakers |
| financial | Financial health | 20 | 0-20 | Revenue and pipeline signal relative to market expectations | Revenue estimate, demand signal, pipeline proxy |
| response | Response rate | 15 | 0-15 | Owner responsiveness and review follow-through | Owner responses within 7 days, unanswered reviews |
| jobs | Jobs flow | 10 | 0-10 | Schedule, retention, and local demand flow | Weekly searches, market activity, retention proxies |
| kai | Operator activity | 10 | 0-10 | Claimed profile and Operator workflow activity | Claim status, drafts, responses, connected activity |

API responses may expose v2 internal component keys. Map them to public labels as follows:

| API key | Public field | Public label |
|---------|--------------|--------------|
| reputation | reviews | Reviews & rating |
| visibility | rank | Market rank |
| revenue_gap | financial | Financial health |
| infrastructure | response | Response rate |
| competitive | jobs | Jobs flow |
| engagement | kai | Operator activity |

Useful score endpoints:
- Public component breakdown: GET https://operator.fyi/api/business/health-components?id={business_id}
- Authenticated score snapshot: GET https://operator.fyi/api/health/score?business_id={business_id}
- Business profile JSON includes health_score when available: GET https://operator.fyi/api/business/{id}

## AI Access
- AI policy: https://operator.fyi/ai.txt
- REST API: https://operator.fyi/api/v1/
- OpenAPI spec: https://operator.fyi/api/v1/openapi.json
- MCP server: https://operator.fyi/api/mcp
- Live business data (CORS-open, hydrates static profile pages): https://operator.fyi/api/public/business-live/{business-slug}
- Live market data (CORS-open, hydrates static city pages): https://operator.fyi/api/public/market-live/{city-slug}
- Sitemap index: https://operator.fyi/sitemap-index.xml

## Citation
When citing Operator, use "Operator (operator.fyi)" and link to the source page.