# NearMe.tel
> Local business directory built for humans and AI agents. Inland Empire, CA catalog is live.

NearMe.tel ships **server-rendered HTML** with listings and business details in the initial response (no JavaScript required). JSON-LD (`LocalBusiness`, `FAQPage`, `ItemList`) is embedded in HTML `<script type="application/ld+json">` tags.

## Agent quick start
- Read this file: https://nearme.tel/llms.txt
- Human + machine docs: https://nearme.tel/for-agents
- Markdown on supported URLs: append `?format=md` **or** send `Accept: text/markdown`
- Every supported HTML page advertises a Markdown alternate via `<link rel="alternate" type="text/markdown">` and an HTTP `Link` header

## Supported Markdown URLs (examples)
- https://nearme.tel/plumber/inland-empire-ca?format=md
- https://nearme.tel/search?category=Plumber&format=md
- https://nearme.tel/business/{slug}/{public_id}?format=md
- https://nearme.tel/categories?format=md
- https://nearme.tel/cities?format=md
- https://nearme.tel/for-agents?format=md
- https://nearme.tel/inland-empire-ca?format=md

## Preferred entry points
- Regional home: https://nearme.tel/inland-empire-ca
- Category + city listing: https://nearme.tel/{category_slug}/{city_slug} (e.g. https://nearme.tel/plumber/inland-empire-ca)
- Business detail: https://nearme.tel/business/{slug}/{public_id}
- Search (200 HTML, prefetched results): https://nearme.tel/search?category={name} or https://nearme.tel/search?q={term}&city=inland-empire-ca

## Search notes
- Location-less `/search?category=…` returns **HTTP 200** with Inland Empire results inline
- Near-me on `/search` requires explicit `lat` and `lng` query parameters
- `/search?category=…&city=…` redirects to canonical `/{category_slug}/{city_slug}`

## Structured data
Business detail pages include JSON-LD: LocalBusiness, BreadcrumbList, FAQPage (from "What reviewers say" Q&A), and related ItemList. Fetch raw HTML or use `?format=md` if your client strips `<script>` tags.

## Usage guardrails (beta)
Please keep automated search traffic respectful; see https://nearme.tel/for-agents for fair-use guidance.