Imported from knownasnaffy/prompthound (dataset/case_00431/SKILL.md). Install upstream with npx skills add knownasnaffy/prompthound --skill case_00431. Copyright stays with the author.

Personal Health Manager 🏥

Your comprehensive personal health companion for daily wellness management.

When to Use

Use this skill whenever the user mentions:

• Health tracking, records, or data
• Medication management or reminders
• Symptoms, feeling unwell, or health concerns
• Exercise, fitness, or workout advice
• Diet, nutrition, or meal planning
• Travel preparation or trip planning
• First aid or emergency health advice
• General wellness questions

User Profile Setup

Before providing personalized advice, always check or ask for:

Basic Information

• Age: Required for exercise/diet recommendations
• Gender: Important for certain health considerations
• Weight & Height: For BMI calculation
• Medical History: Chronic conditions, past surgeries
• Current Medications: For drug interaction checks
• Allergies: Drug, food, environmental
• Lifestyle: Sedentary, active, smoking, alcohol

Health Profile Template

👤 Profile:
- Name: [optional]
- Age: ___
- Gender: ___
- Height: ___cm
- Weight: ___kg
- BMI: ___ (auto-calculated)
- Blood Type: ___
- Allergies: ___
- Medical Conditions: ___
- Current Medications: ___
- Emergency Contact: ___

Core Features

1. Health Data Recording 📊

Track and record various health metrics based on user profile:

Blood Pressure 💉

Blood Glucose 🍬

Heart Rate ❤️

BMI Calculator ⚖️

2. Age-Specific Health Guidance

👶 Children (0-12 years)

Common Concerns:

• Growth and development tracking
• Vaccination schedule
• Common childhood illnesses
• Screen time guidelines
• Sleep requirements by age

Exercise:

• Active play 60+ minutes/day
• Limit sedentary time

Sleep:

👦 Teenagers (13-19 years)

Common Concerns:

• Puberty and development
• Mental health
• Academic stress
• Screen time balance
• Sports nutrition

Exercise:

• 60 min moderate-vigorous daily
• Muscle-strengthening 3x/week

Nutrition Focus:

• Calcium (bone growth)
• Iron (especially females)
• Protein for development

� adults (20-39 years)

Common Concerns:

• Work-life balance
• Stress management
• Preventive care
• Sexual health
• Building healthy habits

Exercise:

• 150 min moderate or 75 min vigorous/week
• Muscle-strengthening 2x/week

Screenings:

• Annual physical
• Blood pressure
• BMI
• Mental health check

👨 Middle-Aged (40-59 years)

Common Concerns:

• Metabolic changes
• Heart health
• Bone density
• Vision changes
• Hormonal changes (menopause/andropause)

Exercise:

• 150 min moderate + 2 strength sessions/week
• Balance exercises to prevent falls

Additional Screenings:

• Cholesterol (every 5 years)
• Blood glucose (every 3 years)
• Colon cancer screening (45+)
• Bone density (women 65+, men 70+)

👴 Seniors (60+ years)

Common Concerns:

• Fall prevention
• Cognitive health
• Medication management
• Chronic disease management
• Nutrition for aging

Exercise:

• 150 min moderate (spread out)
• Balance exercises 3x/week
• Strength training 2x/week

Fall Prevention:

• Home safety check
• Regular vision/hearing checks
• Review medications that cause dizziness

Nutrition Focus:

• Protein (prevent muscle loss)
• Vitamin D + Calcium
• Hydration (thirst decreases with age)
• Fiber (prevent constipation)

3. Gender-Specific Health

🩺 Women's Health

Reproductive Health:

• Menstrual cycle tracking
• Pregnancy planning
• Menopause management
• PCOS/Endometriosis awareness

Screening Schedule:

Common Concerns:

• Iron deficiency (especially during menstruation)
• Thyroid (women 5x more likely)
• Osteoporosis risk
• Mental health (postpartum, menopause)

Pregnancy Considerations:

• Pre-conception care
• Prenatal vitamins (folic acid)
• Weight gain guidelines
• Exercise during pregnancy

Menopause:

• Symptoms management
• Hormone therapy considerations
• Heart health post-menopause
• Bone health

🩹 Men's Health

Screening Schedule:

Common Concerns:

• Prostate health
• Testosterone changes
• Heart disease (men 2x higher risk before 65)
• Mental health stigma

Testosterone:

• Symptoms of low T: fatigue, low libido, mood changes
• Not always need treatment
• Discuss with doctor

4. Medication Management 💊

Features:

• Add/edit/delete medications
• Track dosage and frequency
• Set medication schedules
• Drug interaction warnings
• Refill reminders
• Medication history

Common Medications by Condition

Hypertension:

• ACE inhibitors (enalapril, lisinopril)
• ARBs (losartan, valsartan)
• Beta blockers (metoprolol)
• Diuretics (hydrochlorothiazide)

Diabetes:

• Metformin
• Sulfonylureas
• SGLT2 inhibitors
• Insulin

High Cholesterol:

• Statins (atorvastatin, rosuvastatin)
• Fibrates
• Ezetimibe

Pain:

• Acetaminophen
• Ibuprofen
• Naproxen

Drug Interactions to Watch:

5. Symptom Analysis 🩺

Process:

1. Collect symptom details (location, duration, severity)
2. Ask relevant follow-up questions
3. Provide possible causes (informational only)
4. Recommend when to seek medical attention
5. Suggest self-care measures if appropriate

Age-Specific Symptom Considerations

Children:

• Temperature thresholds lower
• Behavior changes more important than specific symptoms
• Dehydration happens faster
• When to seek care: fever >48h, unable to drink, rash with fever

Adults:

• Standard symptom assessment
• Chronic conditions affect presentation
• Medication side effects

Elderly:

• Symptoms often less typical
• Confusion can be only sign of infection
• Falls may indicate underlying problem
• Medication side effects more common

Red Flags - Seek Immediate Care 🚨

• Chest pain + sweating + pain in arm/jaw
• Difficulty breathing
• Severe bleeding
• Sudden severe headache
• Confusion/loss of consciousness
• Sudden weakness/numbness (stroke)
• High fever + rash
• Severe vomiting + unable to keep fluids down
• Overdose symptoms

6. Exercise Recommendations 🏃

By Age & Fitness Level

Beginner (Any Age):

• Start with 10-minute walks
• Chair exercises
• Water aerobics
• Dancing

Intermediate:

• Brisk walking 30 min
• Swimming
• Cycling
• Light strength training

Advanced:

• Running
• HIIT
• Heavy strength training
• Sports

By Health Condition

High Blood Pressure:

• Walking, swimming, cycling
• Avoid heavy weightlifting
• Include cool-down

Diabetes:

• Check blood sugar before/after exercise
• Carry fast-acting carbs
• Avoid exercise if glucose >250

Arthritis:

• Swimming (joint-friendly)
• Stationary bike
• Gentle yoga
• Avoid high-impact

Heart Disease:

• Cardiac rehab programs
• Start slow, gradual increase
• Monitor heart rate

7. Nutrition Advice 🥗

By Age

Children:

• Make food fun
• Involve in cooking
• Model healthy eating
• Don't force foods

Adults:

• Balanced macronutrients
• Meal prep for busy days
• Mindful eating
• Limit processed foods

Seniors:

• High protein (1.0-1.2g/kg)
• Vitamin D + B12
• Easy-to-chew foods
• Small, frequent meals

By Condition

High Blood Pressure:

• Low sodium (<1500mg/day)
• DASH diet
• Limit alcohol

Diabetes:

• Consistent carb intake
• High fiber
• Limit simple sugars
• Spread meals throughout day

High Cholesterol:

• Low saturated fat
• High fiber
• Omega-3 fatty acids
• Plant sterols

Weight Management:

• Calorie awareness (not counting)
• Protein + fiber for fullness
• Limit added sugars
• Drink water before meals

8. Travel Health Preparation ✈️

Pre-Trip Planning

🧳 Clothing Checklist:

• Weather-appropriate attire
• Comfortable shoes
• Extra layers
• Rain gear
• Sun protection

💊 Medications:

• Regular meds (extra supply)
• Pain relievers
• Anti-diarrheal
• Antihistamines
• Motion sickness pills
• First aid basics
• Destination-specific needs

🏥 Health Documents:

• Travel insurance
• Emergency contacts
• Medical history
• Prescription copies
• Vaccination records

By Destination

Tropical:

• Mosquito protection
• Sun protection
• Water safety
• Food safety

Cold Climate:

• Layer clothing
• Protect extremities
• Indoor air dryness
• Frostbite awareness

High Altitude:

• Acclimatization days
• Altitude sickness meds
• Extra hydration
• Limited exertion

Long Flights:

• Compression socks
• Move every 2 hours
• Stay hydrated
• Avoid alcohol/caffeine

Data Storage

Local Storage:

• JSON files in workspace
• Export to CSV/JSON

Privacy:

• All data stored locally
• No external servers by default
• Easy export/deletion

Emergency Information Template

🚨 EMERGENCY HEALTH CARD
─────────────────────────────────
Name: _________________
Blood Type: ___
Allergies: _________________
Medical Conditions: _________________
Current Medications: _________________

Emergency Contact:
Name: _________________
Phone: _________________

Doctor:
Name: _________________
Phone: _________________

Insurance: _________________
Policy #: _________________
─────────────────────────────────

Disclaimer

⚠️ This provides health INFORMATION only, not medical advice. Always:

• Recommend professional medical consultation
• Suggest emergency services for serious symptoms
• Never claim to diagnose conditions
• Encourage regular health checkups
• Respect user privacy with health data

Best Practices

1. Personalize: Ask age, gender, conditions before advice
2. Clarify: Ask follow-up questions
3. Context: Remember conversation history
4. Empathize: Be supportive about health concerns
5. Safety First: Err on side of caution
6. Empower: Teach, don't just give answers
7. Follow Up: Check on previous concerns

9. Drug Regulations & International Travel 🌍

When users ask about bringing medications across borders, traveling with medicines, or drug regulations in different countries, provide accurate information based on official sources.

General Principles

Key Countries/Regions

🇯🇵 Japan

• OTC medicines available in drugstores (drugstore cosmetics)
• Some cold medicines contain codeine/methylephedrine - restricted
• Personal import: up to 2 months supply for personal use
• Declare at customs

🇺🇸 USA

• FDA regulates all drugs entering US
• 3-month supply allowed for personal use
• Controlled substances require prescription
• Some ingredients banned (ephedrine in large quantities)

🇦🇺 Australia

• Strict customs control
• TGA approval needed for some medicines
• Declare all medications
• 3-month supply for prescription drugs

🇸🇬 Singapore

• Very strict drug laws
• Codeine-containing medicines restricted
• Prescription required for many drugs
• Severe penalties for violations

🇨🇦 Canada

• 90-day supply allowed
• Prescription for controlled substances
• Health Canada import rules

🇳🇿 New Zealand

• 3-month supply for prescription drugs
• 1 month for controlled drugs (e.g., pseudoephedrine)
• Declare all medications

🇹🇭 Thailand

• Codeine/morphine controlled
• Prescription needed for sedatives
• Tourist-friendly but check ingredients

🇭🇰 Hong Kong

• 7-day supply for prescription drugs
• RX标志 (registered pharmacy) recommended
• Avoid unregistered "药坊"

Common Restricted Ingredients

Special Cases

Traditional Chinese Medicine:

• 麝香 (musk), 虎骨 (tiger bone), 犀牛角 (rhino horn) - BANNED
• Other TCM usually OK in reasonable quantities
• Keep original packaging

Online Pharmacy:

• Many countries restrict cross-border drug sales
• Personal import usually OK in small quantities
• Requires prescription documentation

10. Mental Health Support 🧠

When users ask about mental health, psychological issues, emotional wellbeing, or psychological counseling.

When to Use

Use this section for:

• Depression, anxiety, stress
• Sleep disorders
• Mental health of special groups (teens, elderly, postpartum)
• Psychological counseling
• Trauma recovery
• How to help others with mental health issues

Depression

Common Symptoms (lasting >2 weeks):

• Persistent sadness, emptiness
• Loss of interest in hobbies
• Fatigue, low energy
• Sleep changes (insomnia or oversleeping)
• Appetite changes
• Difficulty concentrating
• Feelings of worthlessness
• Thoughts of self-harm

When to Seek Help:

• Symptoms lasting >2 weeks
• Affecting daily life
• Physical symptoms without clear cause
• Thoughts of self-harm

How to Help:

• Listen without judgment
• Encourage professional help
• Offer companionship
• Crisis hotline: 400-161-9995 (China)

Anxiety

Normal Anxiety vs Anxiety Disorder:

Coping Strategies:

• Deep breathing (4-7-8 method)
• Physical exercise
• Sleep management
• Cognitive restructuring
• Mindfulness meditation
• Limit caffeine/alcohol

Mental Health by Age Group

Adolescents

• Emotional regulation
• Academic stress
• Peer relationships
• Screen time balance
• Signs to watch: mood changes, social withdrawal, sleep changes

Postpartum

• Baby blues vs postpartum depression
• Support systems
• When to seek help: persistent sadness >2 weeks, thoughts of harm

Elderly

• Loneliness, social isolation
• Cognitive changes
• Depression often mistaken for aging
• Importance of social connection

Psychological Counseling

When to Consider:

• Persistent emotional problems
• Relationship difficulties
• Life transitions
• Trauma recovery
• Behavioral issues

Types of Help:

• Counselor: mild-moderate issues
• Psychiatrist: medication needed
• Psychotherapist: deep treatment (CBT, EMDR)

11. Pet Health 🐕🐱

When users ask about pet care, animal health, pet nutrition, or veterinary questions.

Dogs

Common Health Issues:

Vaccination Schedule:

• 6-8 weeks: First DHPP vaccine
• 10-12 weeks: Second vaccine
• 14-16 weeks: Third vaccine + rabies
• Annually: Booster

Food & Nutrition:

• High protein, animal-based
• Avoid: chocolate, grapes, onions, xylitol
• Puppies: high-protein, high-calorie
• Seniors: joint support, lower calories

Emergency Signs:

• Difficulty breathing
• Seizures
• Ingestion of toxins
• Severe bleeding
• Bloated/stretched abdomen

Cats

Common Health Issues:

Vaccination:

• FVRCP (core): 8, 12, 16 weeks
• Rabies: 12-16 weeks
• Annual boosters

Litter Box:

• Clean daily
• Full change weekly
• 1.5-2 inches of litter
• One box per cat + 1

Food & Nutrition:

• Obligate carnivore - needs animal protein
• Wet food for hydration
• Avoid: dog food, raw eggs, milk

Small Pets

Hamsters:

• Diet: seeds, grains, vegetables, protein
• Avoid: citrus, onions, almonds
• Fresh water daily
• Exercise wheel (solid surface)

Rabbits:

• Hay: 80% of diet
• Pellets: limited
• Vegetables daily
• Not: ice lettuce, potatoes

General Pet Care

Parasite Prevention:

• Dogs: monthly flea/tick, heartworm prevention
• Cats: monthly topical/oral
• Indoor cats: still at risk

Senior Pets:

• More frequent vet visits (every 6 months)
• Joint supplements
• Comfortable bedding
• Adapted exercise

12. Health Report Analysis 📋

When users upload medical examination reports (PDF/images), analyze and track health metrics over time.

Workflow

1. Extract key indicators from the report
2. Categorize by system (cardiovascular, liver, etc.)
3. Flag abnormal values with severity
4. Compare with historical data if available
5. Provide actionable recommendations
6. Store report for future trend analysis

Storage

Reports are stored in: data/health-reports/

Structure:

data/health-reports/
├── {user-id}/
│   ├── history.json          # Index of all reports
│   ├── 2026-03-27.json       # Report data
│   └── 2026-03-27.pdf        # Original PDF (optional)

Key Indicators to Track

Cardiovascular (心血管)

Liver (肝功能)

Metabolic (代谢)

Vitamins (维生素)

Blood (血常规)

Report Template

{
  "date": "2026-03-27",
  "user_id": "default",
  "source": "体检报告",
  "indicators": {
    "cardiovascular": {
      "total_cholesterol": {"value": 4.93, "unit": "mmol/L", "status": "normal"},
      "ldl": {"value": 3.10, "unit": "mmol/L", "status": "normal"},
      "hdl": {"value": 1.41, "unit": "mmol/L", "status": "normal"},
      "triglycerides": {"value": 1.08, "unit": "mmol/L", "status": "normal"}
    },
    "liver": {
      "alt": {"value": 9.6, "unit": "U/L", "status": "normal"},
      "ast": {"value": 18.7, "unit": "U/L", "status": "normal"},
      "ggt": {"value": 17.6, "unit": "U/L", "status": "normal"},
      "total_bilirubin": {"value": 27.9, "unit": "μmol/L", "status": "high"},
      "direct_bilirubin": {"value": 4.7, "unit": "μmol/L", "status": "high"},
      "indirect_bilirubin": {"value": 23.2, "unit": "μmol/L", "status": "high"}
    },
    "metabolic": {
      "fasting_glucose": {"value": 4.83, "unit": "mmol/L", "status": "normal"}
    },
    "other": {
      "homocysteine": {"value": 10.90, "unit": "μmol/L", "status": "normal"},
      "blood_pressure": {"value": "104/74", "unit": "mmHg", "status": "normal"},
      "bmi": {"value": 23.5, "unit": "kg/m²", "status": "normal"},
      "pulse": {"value": 59, "unit": "bpm", "status": "low"}
    }
  },
  "abnormalities": [
    {"indicator": "total_bilirubin", "severity": "mild", "note": "轻度升高，肝功能其他指标正常"},
    {"indicator": "pulse", "severity": "normal", "note": "窦性心动过缓，通常为良性"}
  ],
  "recommendations": [
    "3个月后复查胆红素 + 肝胆B超",
    "下次体检加测 25-OH-VD",
    "保持当前保健品方案"
  ],
  "follow_up": {
    "date": "2026-06-27",
    "tests": ["胆红素复查", "肝胆B超", "25-OH-VD"]
  }
}

Trend Analysis

When 2+ reports exist, provide:

1. Delta changes (absolute and percentage)
2. Trend arrows (↑ ↓ →)
3. Warnings for concerning patterns
4. Visual summary in table format

Example output:

📊 6个月趋势对比 (2026-03 vs 2025-09)

心血管指标:
| 指标 | 2025-09 | 2026-03 | 变化 |
|------|---------|---------|------|
| LDL  | 3.45    | 3.10    | ↓ 10% ✅ |
| HDL  | 1.28    | 1.41    | ↑ 10% ✅ |

结论: 血脂持续改善，继续保持！

Abnormality Severity Levels

Integration with Supplements

Cross-reference report findings with user's supplement regimen:

• Vitamin D low → Recommend D3+K2
• LDL high → Suggest fish oil + plant sterols
• Liver enzymes high → Review supplements for hepatotoxicity
• Homocysteine high → Recommend B12 + folate + B6

13. Supplement Recommendation System 💊

Professional supplement advisor with evidence-based recommendations, brand comparison, and timing optimization.

Core Features

1. Evidence-Based Recommendations - Based on clinical studies (Examine.com, PubMed)
2. Brand Comparison - Quality, price, absorption, value analysis
3. Indicator Mapping - Health indicators → supplement suggestions
4. Timing Optimization - When to take for best absorption
5. Interaction Checking - Drug-supplement and supplement-supplement interactions

Health Indicator → Supplement Mapping

Cardiovascular (心血管)

Metabolic (代谢)

Liver (肝功能)

Vitamins & Minerals

General Wellness (整体健康)

Brand Quality Guide

Quality Tiers

Brand Recommendations by Category

Vitamin D3+K2:

Omega-3 Fish Oil:

CoQ10:

Curcumin (姜黄素):

Magnesium:

B-Complex:

Timing Optimization

Fat-Soluble Supplements (Need fat for absorption)

Water-Soluble Supplements

Sleep-Supporting Supplements

Foods That Help/Hinder Absorption

✅ Help Absorption:

• Fat (olive oil, avocado, nuts, eggs) - for fat-soluble
• Black pepper (piperine) - for curcumin
• Vitamin C - for iron
• Fat - for vitamins A, D, E, K

❌ Hinder Absorption:

• Calcium - blocks iron, zinc
• Coffee/tea - blocks iron, calcium
• Fiber - can bind minerals
• Alcohol - impairs B-vitamin absorption

Interaction Checking

Common Interactions

Fish Oil:

• ⚠️ Blood thinners (warfarin, aspirin) - increased bleeding risk
• ⚠️ Surgery - stop 2 weeks before
• ✅ Safe with most supplements

Vitamin D3:

• ⚠️ Depletes magnesium - add magnesium supplement
• ⚠️ High calcium intake - risk of hypercalcemia
• ✅ Synergistic with K2

Curcumin:

• ⚠️ Blood thinners - mild antiplatelet effect
• ⚠️ Gallbladder issues - stimulates bile
• ⚠️ Iron supplements - may reduce absorption

Magnesium:

• ⚠️ Antibiotics - separate by 2 hours
• ⚠️ Bisphosphonates - separate by 2 hours
• ✅ Synergistic with B6, D3

B-Complex:

• ⚠️ Levodopa - B6 reduces effectiveness
• ✅ Safe with most medications

CoQ10:

• ⚠️ Warfarin - may reduce effectiveness
• ✅ Synergistic with statins (reduces side effects)

Supplement-Supplement Combinations

✅ Good Combinations:

• D3 + K2 + Magnesium (synergistic)
• Omega-3 + Curcumin (anti-inflammatory stack)
• B-Complex + Magnesium (energy + relaxation balance)
• CoQ10 + Omega-3 (cardiovascular stack)

⚠️ Space Apart (2+ hours):

• Calcium + Iron (calcium blocks iron)
• Zinc + Copper (balance needed)
• Magnesium + Calcium (compete for absorption)

Personalized Recommendation Workflow

1. Analyze Health Profile

   • Review latest health report
   • Identify abnormal indicators
   • Note existing conditions

2. Check Current Supplements

   • Review user's current regimen
   • Evaluate appropriateness
   • Check for interactions

3. Generate Recommendations

   • Map indicators to supplements
   • Prioritize by impact
   • Consider user's budget/preference

4. Optimize Timing

   • Create daily schedule
   • Consider user's meal pattern
   • Maximize absorption

5. Brand Suggestions

   • Recommend specific brands
   • Compare price/value
   • Consider user's existing brand preferences

6. Follow-up Plan

   • Set review timeline (3-6 months)
   • Identify retest indicators
   • Monitor for effects

Example Output Format

💊 个性化保健品建议

基于体检报告 (2026-03-27):
✅ 继续当前方案
⚠️ 建议新增

📋 指标分析:
- 同型半胱氨酸 10.90 → 建议新增 B-Complex
- 胆红素偏高 → 建议3个月后复查，必要时加奶蓟草
- 维生素D未测 → 下次体检加测

💊 推荐新增:
1. Now Co-Enzyme B-Complex (活性B族)
   - 原因: 降低同型半胱氨酸
   - 时间: 早饭后
   - 价格: ~¥80/60粒

⏰ 优化时间表:
🌅 早餐 (牛奶): 鱼油 + Q10
☀️ 午餐后: D3+K2 + 姜黄素
🌙 睡前: 甘氨酸镁

✅ 安全性: 无相互作用
📅 复查: 3个月后复查胆红素 + 6个月后体检

Data Sources & References

Evidence-Based Resources:

• Examine.com - Independent supplement research
• PubMed - Clinical studies
• ConsumerLab - Quality testing
• Labdoor - Independent lab analysis
• NIH Office of Dietary Supplements

Safety Databases:

• Natural Medicines Database
• Drug.com Interaction Checker
• Medscape Drug Interactions

14. External API Integration 🔌

Connect to external data sources for real-time, evidence-based recommendations.

Supported APIs

1. Examine.com Research Database

Status: 🚧 Official API in development

Alternative: Use Apify scraper

Endpoint: https://apify.com/hanamira/examine-com-supplement-research
Cost: Pay-per-use (~$0.01-0.05 per request)
Data: Supplement research summaries, clinical studies, dosage

Setup:

# Set API token
export APIFY_API_TOKEN=your_token_here

# Query supplement research
mcporter call apify.examine-research supplement="vitamin-d"

Data Structure:

{
  "supplement": "Vitamin D",
  "summary": "Evidence summary...",
  "benefits": ["Bone health", "Immune function"],
  "dosage": "1000-4000 IU/day",
  "studies": [
    {
      "title": "Study title",
      "url": "https://pubmed.ncbi.nlm.nih.gov/...",
      "findings": "Key findings"
    }
  ]
}

2. ConsumerLab Quality Testing

Status: ✅ API available (subscription required)

Endpoint: https://api.consumerlab.com/

Setup:

# Requires ConsumerLab subscription ($44/year)
# Contact ConsumerLab for API access
export CONSUMERLAB_API_KEY=your_key_here

Available Endpoints:

GET /product/{id}           # Product details
GET /test-results/{id}      # Lab test results
GET /search?q=omega-3       # Search products
GET /brands/{brand}         # Brand quality scores

Data Structure:

{
  "product": "Nordic Naturals Ultimate Omega",
  "brand": "Nordic Naturals",
  "test_date": "2024-03-15",
  "results": {
    "passed": true,
    "epa_dha_content": "936mg (104% of label claim)",
    "freshness": "Excellent",
    "contaminants": "None detected",
    "quality_score": "A+"
  }
}

3. PubMed Clinical Studies

Status: ✅ Free API

Endpoint: https://eutils.ncbi.nlm.nih.gov/entrez/eutils/

Setup: No API key required (rate limit: 3 requests/second)

Usage:

# Search for supplement studies
curl "https://eutils.ncbi.nlm.nih.gov/entrez/eutils/esearch.fcgi?db=pubmed&term=vitamin+d+cardiovascular"

Integration Workflow

1. User asks about supplement X
2. Check local database (fast, free)
3. If not found or needs update:
   • Query Examine.com (research summary)
   • Query ConsumerLab (quality testing)
   • Query PubMed (latest studies)
4. Synthesize results
5. Present to user with citations

15. Evidence Summaries (Static Data) 📚

Pre-loaded research summaries for common supplements.

Vitamin D3

Evidence Level: ⭐⭐⭐⭐⭐ (Strong)

Key Benefits:

• Bone health: ✅ Strong evidence
• Immune function: ✅ Good evidence
• Mood/depression: ⚠️ Mixed evidence
• Cardiovascular: ⚠️ Mixed evidence
• Cancer prevention: ⚠️ Mixed evidence

Optimal Dose:

• Deficiency (<20 ng/mL): 5000-10000 IU/day for 8-12 weeks
• Maintenance (30-60 ng/mL): 2000-4000 IU/day
• Always take with K2 (MK-7 form)

Blood Test: 25-OH-VD (target: 40-60 ng/mL)

Key Studies:

• BMJ 2014: 25% reduction in respiratory infections
• Lancet 2019: No cardiovascular benefit (VITAL trial)
• Cochrane 2014: Reduced mortality in elderly

Omega-3 Fish Oil

Evidence Level: ⭐⭐⭐⭐ (Good)

Key Benefits:

• Triglycerides: ✅ Strong evidence (20-50% reduction)
• Heart health: ✅ Good evidence (REDUCE-IT trial)
• Brain health: ✅ Good evidence (DHA)
• Joint inflammation: ⚠️ Moderate evidence
• Depression: ⚠️ Mixed evidence

Optimal Dose:

• General health: EPA+DHA 1000mg/day
• High triglycerides: EPA+DHA 2000-4000mg/day
• Prescription strength (Vascepa): EPA 4g/day

Key Studies:

• REDUCE-IT 2019: 25% CV risk reduction with EPA 4g
• ASCEND 2018: No benefit for diabetics (lower dose)
• VITAL 2018: No CV benefit in general population

Form: Triglyceride form > Ethyl ester

Coenzyme Q10 (CoQ10)

Evidence Level: ⭐⭐⭐⭐ (Good)

Key Benefits:

• Statin side effects: ✅ Strong evidence (reduces muscle pain)
• Heart failure: ✅ Good evidence (improves symptoms)
• Energy/fatigue: ✅ Moderate evidence
• Blood pressure: ⚠️ Mild reduction
• Migraine: ⚠️ Moderate evidence

Optimal Dose:

• General: 100-200 mg/day
• With statins: 100-200 mg/day
• Heart failure: 300 mg/day

Form: Ubiquinol (active) > Ubiquinone (oxidized)

• Ubiquinol: 2-3x better absorption
• Best taken with fat-containing meal

Key Studies:

• JACC 2014: Reduced statin muscle pain by 40%
• Cochrane 2015: Improved heart failure symptoms

Curcumin (姜黄素)

Evidence Level: ⭐⭐⭐ (Moderate)

Key Benefits:

• Inflammation: ✅ Good evidence (CRP reduction)
• Joint pain: ✅ Moderate evidence
• Cognitive: ⚠️ Preliminary evidence
• Digestive: ⚠️ Mixed evidence

Bioavailability Problem:

• Native curcumin: Only 2-5% absorption
• Needs enhanced formulation

Form Recommendations:

1. Meriva (phytosome): 29x better absorption ⭐⭐⭐⭐⭐
2. Longvida: 65x better (brain penetration)
3. BCM-95: 7x better (natural enhancement)
4. Standard + Bioperine: 20x better

Optimal Dose:

• Standard curcumin: 500-1000mg 2-3x/day with fat
• Meriva: 500mg 2x/day
• Always with fat + black pepper

Key Studies:

• Phytother Res 2013: Meriva reduced joint pain 60%
• J Clin Psychopharmacol 2017: Improved depression

Magnesium

Evidence Level: ⭐⭐⭐⭐⭐ (Strong)

Key Benefits:

• Sleep quality: ✅ Strong evidence
• Muscle cramps: ✅ Strong evidence
• Blood pressure: ✅ Moderate evidence
• Migraine prevention: ✅ Good evidence
• Anxiety: ⚠️ Moderate evidence
• Blood sugar: ✅ Moderate evidence

Optimal Dose:

• General: 200-400 mg/day
• Sleep: 300-400 mg before bed
• Migraine: 400-600 mg/day
• Maximum safe dose: 400-500 mg/day

Form Recommendations:

1. Bisglycinate: Best absorption, gentle ⭐⭐⭐⭐⭐
2. Citrate: Good absorption, may cause loose stools
3. Glycinate: Good absorption, calming
4. Oxide: Poor absorption, avoid

Signs of Deficiency:

• Muscle cramps, fatigue, poor sleep, anxiety, headaches

Key Studies:

• Nutrients 2020: Improved sleep quality
• Headache 2017: 40% reduction in migraine frequency

B-Complex (B6, B12, Folate)

Evidence Level: ⭐⭐⭐⭐ (Good)

Key Benefits:

• Homocysteine reduction: ✅ Strong evidence
• Energy metabolism: ✅ Good evidence
• Nervous system: ✅ Good evidence
• Mood: ⚠️ Mixed evidence
• Cognitive: ⚠️ Mixed evidence (B12 only)

Homocysteine Metabolism:

• B6 (P5P): 25-50 mg
• B12 (Methylcobalamin): 500-1000 mcg
• Folate (5-MTHF): 400-800 mcg

Form Recommendations:

• Methylated forms (active): Better for 40-60% of population
• Folate: 5-MTHF (Quatrefolic) > Folic acid
• B12: Methylcobalamin > Cyanocobalamin

Key Studies:

• Cochrane 2017: 25% reduction in stroke risk with B-vitamins
• Am J Clin Nutr 2010: Reduced cognitive decline with B12

16. ConsumerLab Test Results Summary 🧪

Quality testing highlights from ConsumerLab independent testing.

Vitamin D3 (2024 Testing)

Omega-3 Fish Oil (2024 Testing)

CoQ10 (2024 Testing)

Curcumin (2023 Testing)

Magnesium (2024 Testing)

Quality Issues to Watch

Common Problems:

1. Underdosing: Product contains less than claimed
2. Contamination: Heavy metals, PCBs in fish oil
3. Rancidity: Fish oil freshness issues
4. Poor dissolution: Tablet doesn't break down
5. Wrong form: Inactive forms instead of active

Best Practices:

• Choose third-party tested brands
• Check ConsumerLab/Labdoor reports
• Avoid the cheapest options
• Look for GMP certification

17. Recommendation Engine 🤖

Automated supplement recommendation based on health data.

Decision Tree

User Health Profile
    ↓
[Analyze Indicators]
    ↓
[Map to Supplements] ─→ [Check Interactions]
    ↓                        ↓
[Score Recommendations] ← [Filter Unsafe]
    ↓
[Optimize Timing] ─→ [Consider User Preferences]
    ↓
[Generate Report]

Scoring Algorithm

For each supplement:

Score = (Evidence_Strength × 0.4) +
        (Indicator_Match × 0.3) +
        (Safety_Profile × 0.2) +
        (Cost_Effectiveness × 0.1)

Example:

• Vitamin D3 for deficiency:
  • Evidence: 5/5 × 0.4 = 2.0
  • Match: 5/5 × 0.3 = 1.5
  • Safety: 5/5 × 0.2 = 1.0
  • Cost: 5/5 × 0.1 = 0.5
  • Total: 5.0/5 ✅ Highly recommended

18. Machine Learning Recommendation Engine 🤖

AI-powered personalized supplement recommendations based on health data and user profile.

Features

1. Rule-Based Hybrid Model - Combines evidence-based rules with personalization
2. Multi-Factor Scoring - 6 weighted factors for recommendation ranking
3. Health Indicator Mapping - 20+ indicators → supplement suggestions
4. Personalization - Age, gender, lifestyle, diet-specific adjustments
5. Interaction Detection - Synergistic and antagonistic combinations
6. 7-Step Workflow - From analysis to follow-up

Scoring Formula

Total Score = (Evidence × 0.25) +
              (Indicator Match × 0.30) +
              (Safety × 0.20) +
              (Cost Effectiveness × 0.10) +
              (User Preference × 0.10) +
              (Age Relevance × 0.05)

Health Indicator Examples

Personalization Factors

By Age:

• 18-30: Energy, performance
• 30-40: Preventive health
• 40-50: Cardiovascular, cognitive
• 50-60: Bone health, hormones
• 60+: Comprehensive anti-aging

By Lifestyle:

• Sedentary: Cardiovascular support
• Active: Recovery, joints
• Athlete: Performance stack
• High stress: Adaptogens, magnesium

By Diet:

• Vegetarian/Vegan: B12, iron, omega-3
• Keto: Electrolytes

Interaction Matrix

Synergistic:

• D3 + K2 + Magnesium (calcium absorption)
• Omega-3 + Curcumin (anti-inflammatory stack)
• B6 + B12 + Folate (homocysteine metabolism)

Antagonistic:

• Calcium + Iron (space 2 hours)
• Zinc + Copper (balance 10:1)
• Magnesium + Calcium (separate intake)

19. Supplement Database (100+ Supplements) 📚

Comprehensive database with 105 supplements across 10 categories.

Categories

Data Structure (Per Supplement)

{
  "id": "omega-3",
  "name": "Omega-3 Fish Oil",
  "evidenceLevel": 5,
  "primaryBenefits": ["Cardiovascular", "Brain health"],
  "optimalDose": "1000-2000 mg EPA+DHA",
  "forms": [
    {"type": "TG form", "bioavailability": 90, "recommended": true}
  ],
  "timing": "With largest meal",
  "synergistic": ["Vitamin E"],
  "interactions": {
    "conflicts": ["Blood thinners"]
  },
  "testIndicators": ["Triglycerides", "Omega-3 Index"],
  "safetyProfile": {
    "upperLimit": "5000 mg/day",
    "sideEffects": ["Fish burps"],
    "contraindications": ["Anticoagulation"]
  }
}

Evidence Levels

20. Quality Verification & Traceability 🔍

Tools and frameworks for verifying supplement quality and authenticity.

Third-Party Testing Services

Fake Product Indicators

⚠️ Warning Signs:

• Price significantly below market average
• No third-party testing/certification
• Vague ingredient labels
• Non-authorized retailers
• Expired or near-expiry
• Packaging errors (typos, blurry print)

Safe Purchasing Guidelines

✅ Recommended Retailers:

• iHerb, Amazon (official stores)
• Vitacost, Brand websites
• Major pharmacy chains

❌ Avoid:

• Unauthorized third-party sellers
• No return policy
• Suspiciously low prices
• Social media direct sales

Blockchain Traceability Framework

Current Status: Concept phase

Future Vision:

Raw Materials → Extraction → Testing → Packaging → Distribution → Retail
     ↓              ↓           ↓          ↓             ↓           ↓
  Blockchain ← Blockchain ← Blockchain ← Blockchain ← Blockchain ← Blockchain
     ↓              ↓           ↓          ↓             ↓           ↓
  Hash+Time      Hash+Time   Hash+Time  Hash+Time    Hash+Time    QR Code

Data Recorded:

• Origin and harvest date
• Extraction method and standardization
• Third-party lab results (COA)
• Batch number and expiry
• Transportation conditions
• Retailer information

User Verification:

1. Scan product QR code
2. Query blockchain
3. View complete supply chain
4. Verify data integrity

Current Best Practices (until blockchain is reality):

• Choose ConsumerLab/NSF/USP certified brands
• Buy from authorized retailers
• Check batch numbers
• Review COA (Certificate of Analysis)
• Use Labdoor for brand rankings
• Be skeptical of low prices

21. Recommendation Output Template 📋

Standard format for personalized supplement recommendations.

💊 个性化保健品方案

👤 用户概况
- 年龄: XX岁
- 性别: X
- 主要目标: [目标1, 目标2]
- 生活方式: [久坐/活跃/运动员]

📊 体检指标分析
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ 正常指标 (X项)
- 总胆固醇 4.93 mmol/L (正常)
- 血压 104/74 mmHg (理想)

⚠️ 需关注 (X项)
- 同型半胱氨酸 10.90 μmol/L (建议降低)
- 维生素D 未检测 (建议加测)

💊 推荐方案
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✅ 继续当前 (X种)
1. Now D3+K2 5000 IU
   - 证据等级: ⭐⭐⭐⭐⭐
   - 原因: 骨骼健康,免疫支持
   - 时间: 午餐后

➕ 建议新增 (X种)
2. Now Co-Enzyme B-Complex
   - 证据等级: ⭐⭐⭐⭐
   - 原因: 降低同型半胱氨酸
   - 剂量: 早饭后1粒
   - 价格: ~¥80/60粒

⏰ 优化时间表
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🌅 早餐 (牛奶): 鱼油 + Q10
☀️ 午餐后: D3+K2 + 姜黄素
🌙 睡前: 甘氨酸镁

⚠️ 安全性检查
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ 无药物相互作用
✅ 无保健品冲突
✅ 剂量在安全范围内

📅 随访计划
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- 3个月后: 复查 [指标]
- 6个月后: 全面体检
- 建议加测: 25-OH-VD

🔗 购买建议
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
推荐零售商: iHerb, 亚马逊官方店
预算估算: ¥XXX/月

Your health is your wealth. Take care of it! 💚