{
  "name": "jachty-scrapper",
  "version": "1.0.0",
  "description": "Scraper API for phillipyachtsuncharter.com – yacht charter data for AI agent",
  "description_pl": "API scrapera danych z phillipyachtsuncharter.com – dane o czarterach jachtów dla agenta AI",
  "instructions_for_agent": {
    "pl": [
      "Ten API dostarcza dane o czarterze jachtów Phillip Yacht Sun Charter na Zanzibarze.",
      "WAŻNE: Ceny i specyfikacje techniczne są w OSOBNYCH endpointach!",
      "Jeśli klient pyta o cenę → użyj /api/yachts/prices",
      "Jeśli klient pyta o parametry jachtu → użyj /api/yachts/specs",
      "Jeśli klient pyta o procedury → użyj /api/procedures",
      "Jeśli klient pyta o warunki umowy → użyj /api/terms",
      "Jeśli klient pyta o FAQ → użyj /api/faq",
      "Jeśli klient pyta o firmę → użyj /api/about",
      "Dane są aktualizowane co tydzień w nocy (niedziela 3:00 UTC)."
    ],
    "en": [
      "This API provides yacht charter data for Phillip Yacht Sun Charter in Zanzibar.",
      "IMPORTANT: Prices and technical specs are in SEPARATE endpoints!",
      "If customer asks about price → use /api/yachts/prices",
      "If customer asks about yacht specs → use /api/yachts/specs",
      "If customer asks about procedures → use /api/procedures",
      "If customer asks about contract terms → use /api/terms",
      "If customer asks FAQ questions → use /api/faq",
      "If customer asks about the company → use /api/about",
      "Data is refreshed weekly (Sunday 3:00 AM UTC)."
    ]
  },
  "endpoints": {
    "data": {
      "GET /api/about": {
        "description": "Company information, team, services",
        "use_case": "RAG – general questions about the company",
        "example_questions": [
          "Who is Phillip Yacht Sun Charter?",
          "Where are you located?",
          "What services do you offer?"
        ]
      },
      "GET /api/yachts/specs": {
        "description": "Technical specifications & equipment for each yacht (NO PRICES)",
        "use_case": "Prompt context – yacht details, cabins, equipment questions",
        "example_questions": [
          "How long is the Lagoon 450?",
          "How many cabins does the Helia 44 have?",
          "What equipment is on the Leopard 48?",
          "Does the yacht have air conditioning?"
        ]
      },
      "GET /api/yachts/prices": {
        "description": "Prices, seasonal rates, mandatory fees, additional options, discounts (NO SPECS)",
        "use_case": "Prompt context – pricing questions, cost calculations",
        "example_questions": [
          "How much does a week charter cost?",
          "What are the mandatory fees?",
          "How much is a skipper?",
          "What discounts are available?",
          "What is the deposit?"
        ]
      },
      "GET /api/procedures": {
        "description": "Charter procedures: transfer, check-in, sailing rules, check-out",
        "use_case": "RAG – operational questions",
        "example_questions": [
          "What do I need for check-in?",
          "What time is embarkation?",
          "What are the sailing rules?",
          "How does check-out work?"
        ]
      },
      "GET /api/terms": {
        "description": "Charter Terms & Conditions (full legal document)",
        "use_case": "RAG – legal/contract questions",
        "example_questions": [
          "What is the cancellation policy?",
          "What does the insurance cover?",
          "What are the payment terms?",
          "What happens if I damage the yacht?"
        ]
      },
      "GET /api/faq": {
        "description": "Frequently Asked Questions with answers",
        "use_case": "RAG – common customer questions",
        "example_questions": [
          "Is it worth taking a skipper?",
          "How do I pay the deposit?",
          "What time is check-in?",
          "Where is the marina?"
        ]
      }
    },
    "admin": {
      "GET /api/status": "Health check, last scrape time, data freshness",
      "POST /api/scrape": "Trigger full scrape of all pages (requires auth if SCRAPE_SECRET is set)",
      "POST /api/scrape/:section": "Trigger scrape of specific section (about, yachts, procedures, terms, faq)"
    }
  },
  "source_website": "https://phillipyachtsuncharter.com",
  "data_refresh": "Weekly – every Sunday at 3:00 AM UTC",
  "contact": "Phillip Yacht Sun Charter: office@phillipyachtsuncharter.com | +255 714 705 077"
}