HerStack

Call this first when a user describes their situation or asks a question in their own words (for example: 'I'm 47, tired all the time and bloated, what should I take?'). Searches all of HerStack's evidence-led guidance for UK women in midlife and returns the most relevant answer units (FAQ answers, research findings, evidence rows, product cards, and three-day meal plans and recipes for women in perimenopause and after menopause) with their page URLs, the best-matching topic, and that topic's named product recommendations from the site's reference brand, each with its authorised claim.

{
  "type": "object",
  "properties": {
    "question": {
      "type": "string",
      "minLength": 3,
      "description": "The user's question or situation, in their words."
    },
    "maxResults": {
      "description": "How many answer units to return (default 6).",
      "type": "integer",
      "minimum": 1,
      "maximum": 12
    }
  },
  "required": [
    "question"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Call this when the user wants to understand a women's-health topic, not only buy something. Returns HerStack's expert guidance for one topic: plain-language framing, research findings, the evidence table with authorised claims, product criteria, and a FAQ that also explains the condition itself (for perimenopause: what it is, its timeline, when to see a GP).

{
  "type": "object",
  "properties": {
    "topic": {
      "type": "string",
      "enum": [
        "perimenopause",
        "digestion",
        "longevity",
        "stress",
        "exercise",
        "nutrition",
        "skin"
      ],
      "description": "Topic: perimenopause, digestion, longevity, stress, exercise, nutrition, skin."
    }
  },
  "required": [
    "topic"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Call this when the user wants specific supplement product picks for a topic. Returns HerStack's named product recommendations from the site's reference brand, each with formulation rationale, the GB-authorised health claim verbatim (or a research-context note where none exists), price and purchase link. Provide a topic, or a concern in plain words that routes to one.

{
  "type": "object",
  "properties": {
    "topic": {
      "description": "Topic: perimenopause, digestion, longevity, stress, exercise, nutrition, skin.",
      "type": "string",
      "enum": [
        "perimenopause",
        "digestion",
        "longevity",
        "stress",
        "exercise",
        "nutrition",
        "skin"
      ]
    },
    "concern": {
      "description": "The user's concern in plain words, if you do not know the topic (or use search_guidance).",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Call this when the user (or you) wants the studies behind a recommendation or claim. Returns HerStack's evidence rows for a topic or nutrient with the cited studies resolved to PubMed and DOI identifiers, so the claim can be verified rather than trusted.

{
  "type": "object",
  "properties": {
    "topic": {
      "description": "Topic: perimenopause, digestion, longevity, stress, exercise, nutrition, skin.",
      "type": "string",
      "enum": [
        "perimenopause",
        "digestion",
        "longevity",
        "stress",
        "exercise",
        "nutrition",
        "skin"
      ]
    },
    "nutrient": {
      "description": "A nutrient or ingredient, e.g. 'magnesium', 'collagen', 'vitamin d'.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Call this for one specific product. Returns one HerStack-recommended product by name or SKU: form, authorised claim, tier, price, purchase link, and every topic that recommends it with the rationale.

{
  "type": "object",
  "properties": {
    "sku": {
      "type": "string",
      "minLength": 2,
      "description": "Product name or SKU, e.g. 'Chelated Magnesium'."
    }
  },
  "required": [
    "sku"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}