💊 Medicine Instruction Simplifier (The Polyglot Pharmacist)

Bridging the gap between complex medical jargon and patient safety—in any language.

📖 What is this?

The Medicine Instruction Simplifier is an AI-powered Apify Actor designed to prevent medication errors among non-native speakers, the elderly, and travelers.

It takes a medicine name (in any language/script) and returns a simple, bulleted safety guide in the patient's native language.

🌟 Key Features

• 🌍 Universal Input: Accepts medicine names in any language (e.g., ロキソプロフェン, Doliprane, Paracetamol).
• 🧠 Hybrid AI Engine:
  • Gemini 2.5 Flash: Normalizes foreign drug names, performs deep analysis, and summarizes complex text.
  • Lingo.dev: Provides highly accurate, localized translations of the final instructions.
• 🔍 Deep Scan Mode: Optionally crawls full medical webpages (instead of just search snippets) for maximum accuracy.
• 🔗 Transparent Sources: Returns the direct URL to the medical data source used, ensuring trust and verifiability.
• ✅ Automatic Safety Flags: Instantly detects critical risks like:
  • 🍔 Take with food
  • 🍷 Avoid alcohol
  • 🤰 Pregnancy risks
  • 😴 Drowsiness warnings
• 🛡️ Fault Tolerant: Includes robust error reporting. If one part fails (e.g., translation), the actor still delivers the partial data it successfully retrieved.

---

🚀 How It Works

1. Input: User enters a medicine name (e.g., "バファリン") and target language (e.g., "Hindi").
2. Normalization: Gemini identifies the standard English generic name (e.g., "Aspirin").
3. Search & Deep Scan: The Actor searches trusted medical databases (Drugs.com). If deep_scan is enabled, it visits the specific page to read the full content.
4. Summarization: Gemini extracts dosage and safety info, formatting it into a clean list.
5. Localization: Lingo.dev translates the summary and the medicine name back into the target language.

---

🛠️ Input Parameters

Field	Type	Description	Default
medicine_name	str	The name of the medicine in ANY language (e.g., "Paracetamol", "Doliprane").	Doliprane
target_language	str	The language for the output instructions (English, French, Hindi, Japanese, etc.).	en
deep_scan	boolean	If enabled, the actor visits the actual medical website to read full page content. Slower (~10s extra) but more accurate.	false
gemini_api_key	str	Your Google Gemini API Key (Free tier available).	Required
lingo_api_key	str	Your Lingo.dev API Key.	Required

---

🌐 Current language support:

Language	ISO 639-1 Code
English	en
Spanish	es
French	fr
German	de
Japanese	ja
Chinese	zh
Hindi	hi

📊 Sample Output (JSON)

Here is an example of a Japanese user searching for "Advil" (Ibuprofen):

{
  "input_medicine": "Advil",
  "medicine_translated": "イブプロフェン",
  "patient_language": "Japanese",
  "translated_instructions": [
    "痛みや熱のために必要に応じて4〜6時間ごとに1錠（200mg）を服用してください。",
    "胃の不調を防ぐために、食べ物や牛乳と一緒に服用してください。",
    "医師の指示がない限り、24時間以内に6錠（1200mg）を超えて服用しないでください。",
    "アスピリンや他のNSAIDにアレルギーがある場合は使用しないでください。"
  ],
  "important_disclaimer": "免責事項：AIは誤る可能性があります。医師に相談してください.",
  "safety_flags": {
    "take_with_food": true,
    "avoid_alcohol": true,
    "may_cause_drowsiness": false,
    "pregnancy_warning": true
  },
  "source_url": "[https://www.drugs.com/advil.html](https://www.drugs.com/advil.html)",
  "error_report": []
}