# CrimeSpot

> CrimeSpot is a community-reported incident and civic safety platform for Bangladesh, providing real-time geocoded incident tracking, safety analytics, and emergency hotline directories.

CrimeSpot maps crowdsourced civic safety reports across Dhaka, Chattogram, Sylhet, Rajshahi, Khulna, Barishal, Rangpur, and Mymensingh. The platform empowers citizens with localized crime patterns, verified community records, and emergency resources in both Bengali (বাংলা) and English.

## Primary Pages & Endpoints

- [Interactive Safety Map](https://crimespotbd.org): Live map view with crime heatmaps, incident cluster pins, and district filtering.
- [Incident Reports Feed](https://crimespotbd.org/reports): Filterable directory of all citizen-reported and verified incidents.
- [Safety Analytics & Statistics](https://crimespotbd.org/statistics): Platform statistics, hourly incident distribution, category breakdown, and safety trends.
- [About & Emergency Helplines](https://crimespotbd.org/about): Directory of official Bangladesh helplines (Police/Ambulance 999, Women/Child 109, Fire 16163) and safety guidelines.
- [Terms & Community Guidelines](https://crimespotbd.org/terms): Community conduct, reporting standards, and moderation guidelines.
- [Privacy Policy](https://crimespotbd.org/privacy): Data minimization, anonymous reporting, and security practices.
- [Legal Disclaimer](https://crimespotbd.org/disclaimer): Crowdsourced data disclaimers and emergency liability notices.

## Markdown for Agents (Content Negotiation)

CrimeSpot natively supports **Markdown Content Negotiation**. Autonomous AI agents and LLM scrapers can request clean, token-efficient Markdown representations of any page by passing the HTTP header:
```http
Accept: text/markdown
```
Alternatively, agents may append `.md` to page paths (e.g., `/about.md`, `/statistics.md`, `/reports.md`) or use `?format=markdown`. All responses include YAML frontmatter, clean semantic Markdown, and embedded Schema.org JSON-LD structured data alongside an `x-markdown-tokens` estimate header.

## Agent Discovery & Machine-Readable Catalogs (RFC 8288 & RFC 9727)

CrimeSpot advertises its API and machine-readable resources through standard HTTP `Link` response headers:
- `Link: </.well-known/ai-catalog.json>; rel="ai-catalog"` — Agentic Resource Discovery (ARD) capability manifest and AI catalog
- `Link: </.well-known/http-message-signatures-directory>; rel="http-message-signatures-directory"` — Web Bot Auth JSON Web Key Set (JWKS) per IETF WBA WG & RFC 9421
- `Link: </.well-known/mcp/server-card.json>; rel="service-desc"` — MCP Server Card (SEP-1649 / SEP-2127) for Model Context Protocol discovery
- `Link: </.well-known/agent-card.json>; rel="service-desc"` — A2A Protocol Agent Card for Agent-to-Agent discovery
- `Link: </.well-known/agent-skills/index.json>; rel="describedby"` — Agent Skills Discovery Index (RFC v0.2.0)
- `Link: </.well-known/api-catalog>; rel="api-catalog"` — RFC 9727 API catalog in `application/linkset+json` format
- `Link: </.well-known/api-catalog>; rel="service-desc"` — Machine-readable service description
- `Link: </.well-known/oauth-protected-resource>; rel="service-desc"` — RFC 9728 OAuth Protected Resource Metadata
- `Link: </auth.md>; rel="service-doc"` — Auth.md Agent Registration & Authentication Specification
- `Link: </llms.txt>; rel="service-doc"` — Human and agent documentation
- `Link: </llms.txt>; rel="describedby"; type="text/plain"` — Resource description
- `Link: </index.md>; rel="alternate"; type="text/markdown"` — Direct Markdown representation for agents

## Documentation & AI Manual

- [Comprehensive AI Safety Manual & Data Taxonomy](https://crimespotbd.org/llms-full.txt): Complete safety taxonomy, district geocenters, incident verification rules, and AI ingestion instructions.
- [ARD Capability Manifest & AI Catalog](https://crimespotbd.org/.well-known/ai-catalog.json): Agentic Resource Discovery manifest declaring MCP servers, A2A agents, skills, and OpenAPI tools.
- [DNS for AI Discovery (DNS-AID)](https://crimespotbd.org): SVCB and HTTPS resource records published under `_agents.crimespotbd.org` for DNS-based discovery.
- [Web Bot Auth Signatures Directory](https://crimespotbd.org/.well-known/http-message-signatures-directory): JWKS public keys for verifying signed outbound crawler and bot requests per RFC 9421.
- [WebMCP Browser Tools](https://crimespotbd.org): Declarative and programmatic in-browser tool execution for AI agents via `navigator.modelContext.registerTool()`.
- [MCP Server Card](https://crimespotbd.org/.well-known/mcp/server-card.json): Model Context Protocol server discovery card with streamable HTTP transport endpoint and tool capabilities.
- [Agent Skills Discovery Index](https://crimespotbd.org/.well-known/agent-skills/index.json): Machine-readable index of domain agent skills per Cloudflare Agent Skills Discovery RFC v0.2.0.
- [A2A Agent Card](https://crimespotbd.org/.well-known/agent-card.json): Agent-to-Agent discovery card defining capabilities, skills, and supported interfaces.
- [RFC 9727 API Catalog](https://crimespotbd.org/.well-known/api-catalog): Machine-readable linkset catalog of all public APIs and endpoints.
- [Auth.md Agent Authentication Specification](https://crimespotbd.org/auth.md): Agent registration, token acquisition, and OAuth 2.0 discovery guide.
- [OAuth Protected Resource Metadata (PRM)](https://crimespotbd.org/.well-known/oauth-protected-resource): RFC 9728 resource server authorization configuration.
- [OAuth Authorization Server Metadata](https://crimespotbd.org/.well-known/oauth-authorization-server): RFC 8414 authorization server metadata with `agent_auth` block.

## Safety & Emergency Notice

CrimeSpot is a civic observation and awareness tool, not a government law enforcement agency or emergency dispatch service. For immediate emergencies, crimes in progress, or life-threatening situations in Bangladesh, citizens must immediately call **National Emergency Service: 999**.