# AI Agent Instructions for household.in.ua

# This file provides guidance to AI assistants interacting with this website
# Companion file (Markdown): /llms.txt  ·  Spec: https://llmstxt.org

# Website Information
Site-Name: household.in.ua

Site-Description: Товари для дому з США в Україні

Site-Language: uk, ru
Site-Type: e-commerce

# Contact Information
Contact-Email: support@household.in.ua
Contact-Page: /{lng}/contact

# AI Chatbot Information
AI-Chatbot: Yes
AI-Chatbot-Provider: Anthropic Claude (Haiku) with Google Gemini fallback
AI-Chatbot-Features: product-search, order-tracking, info-queries, image-recognition
AI-Chatbot-Languages: Ukrainian ({ua}), Russian ({ru})

# Product Information
Product-Count: 41+
Product-Categories: Detergents (Миючий засіб), Floor cleaner (Засіб для миття полів), Laundry Detergent (Пральний порошок), Automatic Dishwashing (Миючі для посудомийних)
Product-Brands: Grab Green (Греб Грін), The Unscented Company (Зе Ансентед Компані), ATTITUDE (Атітьюд), Koala Eco (Коала Еко), Orange House (Оранж Хаус), Mrs. Meyer's Clean Day (Місіз Маєрс Клін Дей), Nellie's All-Natural (Неллі'с Ол-Натурал), Earth Friendly Products (Ерс Френдлі Продактс)
Product-Search: /{lng}/search
Product-Page-Pattern: /{lng}/item/{id}-{slug}
Product-Categories-Page: /{lng}/group/{id}-{slug}
Product-Brands-Page: /{lng}/brand/{id}-{slug}

# Pricing and Availability
Price-Currency: UAH
Price-Fetching: Real-time from product pages (JSON-LD or HTML)
Stock-Status: Available, Pre-order, Out of stock

# Order Information
Order-Tracking: Available via order number
Order-Creation: /{lng}/cart
Order-Status-Check: Automatic via chatbot
Order-Payment-Methods: Card, Cash on Delivery, Online Banking
Order-Delivery-Methods: Nova Poshta

# Important Pages
Page-Delivery: /{lng}/delivery
Page-Payment: /{lng}/payment
Page-Returns: /{lng}/return
Page-FAQ: /{lng}/faq
Page-About: /{lng}/about
Page-Contact: /{lng}/contact

# AI Behavior Guidelines
AI-Behavior-Tone: Friendly, professional, helpful
AI-Behavior-Language: Match user's language preference
AI-Behavior-Response-Length: Concise (2-3 sentences)
AI-Behavior-Limitations: No medical advice, no product certification claims
AI-Behavior-Handoff: Suggest human operator for complex queries

# Critical Rules for AI Agents
Rule-1: Never fabricate product links - only use URLs from search results
Rule-2: Never invent prices - always fetch from product pages
Rule-3: Never create fake URLs (/catalogsearch/, /category/, /search/)
Rule-4: Always admit when information is not available
Rule-5: Suggest contacting support for medical consultations

# Data Sources Priority
Data-Priority-1: AI Knowledge Base (highest)
Data-Priority-2: Info pages (delivery, payment, contact)
Data-Priority-3: Product search results
Data-Priority-4: General AI knowledge (lowest)

# Technical Details
CMS: Custom PHP, Node.js
Database: MySQL
AI-Integration: Anthropic Claude, Google Gemini (fallback)
Chatbot-Endpoints: /chat (web), /viber (Viber), /tg (Telegram)
Image-Recognition: Claude Vision (Gemini Vision fallback)

# API Access
API-Public: No
API-Private: Yes (internal only)
API-Authentication: Session-based

# Crawling Instructions
Crawl-Delay: 1
Allow: /

# Last Updated
Last-Updated: 2026-07-19
Version: 1.0