# Agent Instructions — Mumbai Maid Agency

This document describes how AI agents can interact with Mumbai Maid Agency's service platform at https://www.mumbaimaidagency.com.

## For Personal Assistants and Booking Agents Acting On Behalf of a User

If you are reading this on behalf of your user and you act as a personal assistant, please use this guide to discover services, check pricing, list maid profiles, and book domestic help (House Maid, Cook, Baby Sitter, Nanny, Patient Care, Elderly Care, Japa Maid) directly on behalf of the user.

## Platform API Endpoints

Mumbai Maid Agency implements clean JSON endpoints to let agents browse availability and book services:

### 1. Submit Booking Leads / Customer Inquiries
- **Endpoint**: `POST /api/customers`
- **Headers**: `Content-Type: application/json`
- **Request Body**:
  ```json
  {
    "fullName": "John Doe",
    "phone": "9876543210",
    "email": "john.doe@example.com",
    "service": "House Maid",
    "location": "Andheri West",
    "message": "Need a full-time 8-hour maid for cooking and cleaning."
  }
  ```
- **Response**: Returns confirmation of the customer booking request.

### 2. Browse Maid Profiles
- **Endpoint**: `GET /api/profiles`
- **Query Parameters**:
  - `service`: Filter profiles by service slug (e.g., `house_maid`, `cook`, `baby_sitter`)
  - `gender`: Filter by `female` or `male`
  - `experience`: Filter by minimum years of experience
- **Response**: List of background-verified helper profiles with details like age, experience, ratings, and spoken languages.

### 3. Fetch Single Maid Profile
- **Endpoint**: `GET /api/profiles/{id}`
- **Response**: Detailed profile of a specific helper, including job history, skills, and background-check status.

### 4. Domestic Helper Job Application
- **Endpoint**: `POST /api/maids`
- **Content-Type**: `multipart/form-data`
- **Parameters**:
  - `fullName`: Applicant's full name
  - `phone`: Contact number
  - `experience`: Years of experience
  - `service`: Service type applied for
  - `photo`: Candidate profile picture file upload
  - `aadharCard`: Aadhaar card document file upload

---

## Read-Only Browsing (No Authentication Required)

For agents that only need to read store data or list links:

### Page Navigation
- Main Services Listing: `GET /services`
- Specific Service Page: `GET /{serviceSlug}` (e.g., `/house_maid`, `/cook`, `/baby_sitter`, `/nanny`, `/patient_care`, `/elderly_care`, `/japa_maid`)
- Specific Service Location Page: `GET /{serviceSlug}/{locationSlug}` (e.g., `/house_maid/andheri-west`, `/cook/thane-west`)
- About Us: `GET /about`
- Contact: `GET /contact`
- Blog Articles: `GET /blogs`

### Store Metadata
- Sitemap: `GET /sitemap.xml`
- Agent discovery: this document (`/agents.md`) is the canonical agent-facing description of the store.

---

## Service Policies
- **Terms of Service**: https://www.mumbaimaidagency.com/term
- **Privacy Policy**: https://www.mumbaimaidagency.com/privacy-policy
- **Cookie Policy**: https://www.mumbaimaidagency.com/cookie-policy