[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7EP9S9RSE2684RYM57MPVW5":3,"skill-same:01M7EP9S9RSE2684RYM57MPVW5":82},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":14,"repositoryHtmlUrl":27,"repositoryHomepageUrl":28,"ownerHtmlUrl":29,"ownerBlogUrl":6,"ownerDescription":30,"updatedAt":31,"install":32,"resources":45},"01M7EP9S9RSE2684RYM57MPVW5","fda-database",null,"Query openFDA API for drugs, devices, adverse events, recalls, regulatory submissions (510k, PMA), substance identification (UNII), for FDA regulatory data analysis and safety research.","marnixGeerkens\u002Frocketlauncher-claude-code","marnixGeerkens","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F143275741?v=4","01M7EJY825SFPHDDZNFDAJHCA9","Marnix Geerkens","01M7EJY82TBA6ABXJ62JWR9B9F",0,"MIT","https:\u002F\u002Fgithub.com\u002FmarnixGeerkens\u002Frocketlauncher-claude-code\u002Fblob\u002Fmain\u002Fcomponents\u002Fskills\u002Fscientific\u002Ffda-database\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: fda-database\ndescription: \"Query openFDA API for drugs, devices, adverse events, recalls, regulatory submissions (510k, PMA), substance identification (UNII), for FDA regulatory data analysis and safety research.\"\n---\n\n# FDA Database Access\n\n## Overview\n\nAccess comprehensive FDA regulatory data through openFDA, the FDA's initiative to provide open APIs for public datasets. Query information about drugs, medical devices, foods, animal\u002Fveterinary products, and substances using Python with standardized interfaces.\n\n**Key capabilities:**\n- Query adverse events for drugs, devices, foods, and veterinary products\n- Access product labeling, approvals, and regulatory submissions\n- Monitor recalls and enforcement actions\n- Look up National Drug Codes (NDC) and substance identifiers (UNII)\n- Analyze device classifications and clearances (510k, PMA)\n- Track drug shortages and supply issues\n- Research chemical structures and substance relationships\n\n## When to Use This Skill\n\nThis skill should be used when working with:\n- **Drug research**: Safety profiles, adverse events, labeling, approvals, shortages\n- **Medical device surveillance**: Adverse events, recalls, 510(k) clearances, PMA approvals\n- **Food safety**: Recalls, allergen tracking, adverse events, dietary supplements\n- **Veterinary medicine**: Animal drug adverse events by species and breed\n- **Chemical\u002Fsubstance data**: UNII lookup, CAS number mapping, molecular structures\n- **Regulatory analysis**: Approval pathways, enforcement actions, compliance tracking\n- **Pharmacovigilance**: Post-market surveillance, safety signal detection\n- **Scientific research**: Drug interactions, comparative safety, epidemiological studies\n\n## Quick Start\n\n### 1. Basic Setup\n\n```python\nfrom scripts.fda_query import FDAQuery\n\n# Initialize (API key optional but recommended)\nfda = FDAQuery(api_key=\"YOUR_API_KEY\")\n\n# Query drug adverse events\nevents = fda.query_drug_events(\"aspirin\", limit=100)\n\n# Get drug labeling\nlabel = fda.query_drug_label(\"Lipitor\", brand=True)\n\n# Search device recalls\nrecalls = fda.query(\"device\", \"enforcement\",\n                   search=\"classification:Class+I\",\n                   limit=50)\n```\n\n### 2. API Key Setup\n\nWhile the API works without a key, registering provides higher rate limits:\n- **Without key**: 240 requests\u002Fmin, 1,000\u002Fday\n- **With key**: 240 requests\u002Fmin, 120,000\u002Fday\n\nRegister at: https:\u002F\u002Fopen.fda.gov\u002Fapis\u002Fauthentication\u002F\n\nSet as environment variable:\n```bash\nexport FDA_API_KEY=\"your_key_here\"\n```\n\n### 3. Running Examples\n\n```bash\n# Run comprehensive examples\npython scripts\u002Ffda_examples.py\n\n# This demonstrates:\n# - Drug safety profiles\n# - Device surveillance\n# - Food recall monitoring\n# - Substance lookup\n# - Comparative drug analysis\n# - Veterinary drug analysis\n```\n\n## FDA Database Categories\n\n### Drugs\n\nAccess 6 drug-related endpoints covering the full drug lifecycle from approval to post-market surveillance.\n\n**Endpoints:**\n1. **Adverse Events** - Reports of side effects, errors, and therapeutic failures\n2. **Product Labeling** - Prescribing information, warnings, indications\n3. **NDC Directory** - National Drug Code product information\n4. **Enforcement Reports** - Drug recalls and safety actions\n5. **Drugs@FDA** - Historical approval data since 1939\n6. **Drug Shortages** - Current and resolved supply issues\n\n**Common use cases:**\n```python\n# Safety signal detection\nfda.count_by_field(\"drug\", \"event\",\n                  search=\"patient.drug.medicinalproduct:metformin\",\n                  field=\"patient.reaction.reactionmeddrapt\")\n\n# Get prescribing information\nlabel = fda.query_drug_label(\"Keytruda\", brand=True)\n\n# Check for recalls\nrecalls = fda.query_drug_recalls(drug_name=\"metformin\")\n\n# Monitor shortages\nshortages = fda.query(\"drug\", \"drugshortages\",\n                     search=\"status:Currently+in+Shortage\")\n```\n\n**Reference:** See `references\u002Fdrugs.md` for detailed documentation\n\n### Devices\n\nAccess 9 device-related endpoints covering medical device safety, approvals, and registrations.\n\n**Endpoints:**\n1. **Adverse Events** - Device malfunctions, injuries, deaths\n2. **510(k) Clearances** - Premarket notifications\n3. **Classification** - Device categories and risk classes\n4. **Enforcement Reports** - Device recalls\n5. **Recalls** - Detailed recall information\n6. **PMA** - Premarket approval data for Class III devices\n7. **Registrations & Listings** - Manufacturing facility data\n8. **UDI** - Unique Device Identification database\n9. **COVID-19 Serology** - Antibody test performance data\n\n**Common use cases:**\n```python\n# Monitor device safety\nevents = fda.query_device_events(\"pacemaker\", limit=100)\n\n# Look up device classification\nclassification = fda.query_device_classification(\"DQY\")\n\n# Find 510(k) clearances\nclearances = fda.query_device_510k(applicant=\"Medtronic\")\n\n# Search by UDI\ndevice_info = fda.query(\"device\", \"udi\",\n                       search=\"identifiers.id:00884838003019\")\n```\n\n**Reference:** See `references\u002Fdevices.md` for detailed documentation\n\n### Foods\n\nAccess 2 food-related endpoints for safety monitoring and recalls.\n\n**Endpoints:**\n1. **Adverse Events** - Food, dietary supplement, and cosmetic events\n2. **Enforcement Reports** - Food product recalls\n\n**Common use cases:**\n```python\n# Monitor allergen recalls\nrecalls = fda.query_food_recalls(reason=\"undeclared peanut\")\n\n# Track dietary supplement events\nevents = fda.query_food_events(\n    industry=\"Dietary Supplements\")\n\n# Find contamination recalls\nlisteria = fda.query_food_recalls(\n    reason=\"listeria\",\n    classification=\"I\")\n```\n\n**Reference:** See `references\u002Ffoods.md` for detailed documentation\n\n### Animal & Veterinary\n\nAccess veterinary drug adverse event data with species-specific information.\n\n**Endpoint:**\n1. **Adverse Events** - Animal drug side effects by species, breed, and product\n\n**Common use cases:**\n```python\n# Species-specific events\ndog_events = fda.query_animal_events(\n    species=\"Dog\",\n    drug_name=\"flea collar\")\n\n# Breed predisposition analysis\nbreed_query = fda.query(\"animalandveterinary\", \"event\",\n    search=\"reaction.veddra_term_name:*seizure*+AND+\"\n           \"animal.breed.breed_component:*Labrador*\")\n```\n\n**Reference:** See `references\u002Fanimal_veterinary.md` for detailed documentation\n\n### Substances & Other\n\nAccess molecular-level substance data with UNII codes, chemical structures, and relationships.\n\n**Endpoints:**\n1. **Substance Data** - UNII, CAS, chemical structures, relationships\n2. **NSDE** - Historical substance data (legacy)\n\n**Common use cases:**\n```python\n# UNII to CAS mapping\nsubstance = fda.query_substance_by_unii(\"R16CO5Y76E\")\n\n# Search by name\nresults = fda.query_substance_by_name(\"acetaminophen\")\n\n# Get chemical structure\nstructure = fda.query(\"other\", \"substance\",\n    search=\"names.name:ibuprofen+AND+substanceClass:chemical\")\n```\n\n**Reference:** See `references\u002Fother.md` for detailed documentation\n\n## Common Query Patterns\n\n### Pattern 1: Safety Profile Analysis\n\nCreate comprehensive safety profiles combining multiple data sources:\n\n```python\ndef drug_safety_profile(fda, drug_name):\n    \"\"\"Generate complete safety profile.\"\"\"\n\n    # 1. Total adverse events\n    events = fda.query_drug_events(drug_name, limit=1)\n    total = events[\"meta\"][\"results\"][\"total\"]\n\n    # 2. Most common reactions\n    reactions = fda.count_by_field(\n        \"drug\", \"event\",\n        search=f\"patient.drug.medicinalproduct:*{drug_name}*\",\n        field=\"patient.reaction.reactionmeddrapt\",\n        exact=True\n    )\n\n    # 3. Serious events\n    serious = fda.query(\"drug\", \"event\",\n        search=f\"patient.drug.medicinalproduct:*{drug_name}*+AND+serious:1\",\n        limit=1)\n\n    # 4. Recent recalls\n    recalls = fda.query_drug_recalls(drug_name=drug_name)\n\n    return {\n        \"total_events\": total,\n        \"top_reactions\": reactions[\"results\"][:10],\n        \"serious_events\": serious[\"meta\"][\"results\"][\"total\"],\n        \"recalls\": recalls[\"results\"]\n    }\n```\n\n### Pattern 2: Temporal Trend Analysis\n\nAnalyze trends over time using date ranges:\n\n```python\nfrom datetime import datetime, timedelta\n\ndef get_monthly_trends(fda, drug_name, months=12):\n    \"\"\"Get monthly adverse event trends.\"\"\"\n    trends = []\n\n    for i in range(months):\n        end = datetime.now() - timedelta(days=30*i)\n        start = end - timedelta(days=30)\n\n        date_range = f\"[{start.strftime('%Y%m%d')}+TO+{end.strftime('%Y%m%d')}]\"\n        search = f\"patient.drug.medicinalproduct:*{drug_name}*+AND+receivedate:{date_range}\"\n\n        result = fda.query(\"drug\", \"event\", search=search, limit=1)\n        count = result[\"meta\"][\"results\"][\"total\"] if \"meta\" in result else 0\n\n        trends.append({\n            \"month\": start.strftime(\"%Y-%m\"),\n            \"events\": count\n        })\n\n    return trends\n```\n\n### Pattern 3: Comparative Analysis\n\nCompare multiple products side-by-side:\n\n```python\ndef compare_drugs(fda, drug_list):\n    \"\"\"Compare safety profiles of multiple drugs.\"\"\"\n    comparison = {}\n\n    for drug in drug_list:\n        # Total events\n        events = fda.query_drug_events(drug, limit=1)\n        total = events[\"meta\"][\"results\"][\"total\"] if \"meta\" in events else 0\n\n        # Serious events\n        serious = fda.query(\"drug\", \"event\",\n            search=f\"patient.drug.medicinalproduct:*{drug}*+AND+serious:1\",\n            limit=1)\n        serious_count = serious[\"meta\"][\"results\"][\"total\"] if \"meta\" in serious else 0\n\n        comparison[drug] = {\n            \"total_events\": total,\n            \"serious_events\": serious_count,\n            \"serious_rate\": (serious_count\u002Ftotal*100) if total > 0 else 0\n        }\n\n    return comparison\n```\n\n### Pattern 4: Cross-Database Lookup\n\nLink data across multiple endpoints:\n\n```python\ndef comprehensive_device_lookup(fda, device_name):\n    \"\"\"Look up device across all relevant databases.\"\"\"\n\n    return {\n        \"adverse_events\": fda.query_device_events(device_name, limit=10),\n        \"510k_clearances\": fda.query_device_510k(device_name=device_name),\n        \"recalls\": fda.query(\"device\", \"enforcement\",\n                           search=f\"product_description:*{device_name}*\"),\n        \"udi_info\": fda.query(\"device\", \"udi\",\n                            search=f\"brand_name:*{device_name}*\")\n    }\n```\n\n## Working with Results\n\n### Response Structure\n\nAll API responses follow this structure:\n\n```python\n{\n    \"meta\": {\n        \"disclaimer\": \"...\",\n        \"results\": {\n            \"skip\": 0,\n            \"limit\": 100,\n            \"total\": 15234\n        }\n    },\n    \"results\": [\n        # Array of result objects\n    ]\n}\n```\n\n### Error Handling\n\nAlways handle potential errors:\n\n```python\nresult = fda.query_drug_events(\"aspirin\", limit=10)\n\nif \"error\" in result:\n    print(f\"Error: {result['error']}\")\nelif \"results\" not in result or len(result[\"results\"]) == 0:\n    print(\"No results found\")\nelse:\n    # Process results\n    for event in result[\"results\"]:\n        # Handle event data\n        pass\n```\n\n### Pagination\n\nFor large result sets, use pagination:\n\n```python\n# Automatic pagination\nall_results = fda.query_all(\n    \"drug\", \"event\",\n    search=\"patient.drug.medicinalproduct:aspirin\",\n    max_results=5000\n)\n\n# Manual pagination\nfor skip in range(0, 1000, 100):\n    batch = fda.query(\"drug\", \"event\",\n                     search=\"...\",\n                     limit=100,\n                     skip=skip)\n    # Process batch\n```\n\n## Best Practices\n\n### 1. Use Specific Searches\n\n**DO:**\n```python\n# Specific field search\nsearch=\"patient.drug.medicinalproduct:aspirin\"\n```\n\n**DON'T:**\n```python\n# Overly broad wildcard\nsearch=\"*aspirin*\"\n```\n\n### 2. Implement Rate Limiting\n\nThe `FDAQuery` class handles rate limiting automatically, but be aware of limits:\n- 240 requests per minute\n- 120,000 requests per day (with API key)\n\n### 3. Cache Frequently Accessed Data\n\nThe `FDAQuery` class includes built-in caching (enabled by default):\n\n```python\n# Caching is automatic\nfda = FDAQuery(api_key=api_key, use_cache=True, cache_ttl=3600)\n```\n\n### 4. Use Exact Matching for Counting\n\nWhen counting\u002Faggregating, use `.exact` suffix:\n\n```python\n# Count exact phrases\nfda.count_by_field(\"drug\", \"event\",\n                  search=\"...\",\n                  field=\"patient.reaction.reactionmeddrapt\",\n                  exact=True)  # Adds .exact automatically\n```\n\n### 5. Validate Input Data\n\nClean and validate search terms:\n\n```python\ndef clean_drug_name(name):\n    \"\"\"Clean drug name for query.\"\"\"\n    return name.strip().replace('\"', '\\\\\"')\n\ndrug_name = clean_drug_name(user_input)\n```\n\n## API Reference\n\nFor detailed information about:\n- **Authentication and rate limits** → See `references\u002Fapi_basics.md`\n- **Drug databases** → See `references\u002Fdrugs.md`\n- **Device databases** → See `references\u002Fdevices.md`\n- **Food databases** → See `references\u002Ffoods.md`\n- **Animal\u002Fveterinary databases** → See `references\u002Fanimal_veterinary.md`\n- **Substance databases** → See `references\u002Fother.md`\n\n## Scripts\n\n### `scripts\u002Ffda_query.py`\n\nMain query module with `FDAQuery` class providing:\n- Unified interface to all FDA endpoints\n- Automatic rate limiting and caching\n- Error handling and retry logic\n- Common query patterns\n\n### `scripts\u002Ffda_examples.py`\n\nComprehensive examples demonstrating:\n- Drug safety profile analysis\n- Device surveillance monitoring\n- Food recall tracking\n- Substance lookup\n- Comparative drug analysis\n- Veterinary drug analysis\n\nRun examples:\n```bash\npython scripts\u002Ffda_examples.py\n```\n\n## Additional Resources\n\n- **openFDA Homepage**: https:\u002F\u002Fopen.fda.gov\u002F\n- **API Documentation**: https:\u002F\u002Fopen.fda.gov\u002Fapis\u002F\n- **Interactive API Explorer**: https:\u002F\u002Fopen.fda.gov\u002Fapis\u002Ftry-the-api\u002F\n- **GitHub Repository**: https:\u002F\u002Fgithub.com\u002FFDA\u002Fopenfda\n- **Terms of Service**: https:\u002F\u002Fopen.fda.gov\u002Fterms\u002F\n\n## Support and Troubleshooting\n\n### Common Issues\n\n**Issue**: Rate limit exceeded\n- **Solution**: Use API key, implement delays, or reduce request frequency\n\n**Issue**: No results found\n- **Solution**: Try broader search terms, check spelling, use wildcards\n\n**Issue**: Invalid query syntax\n- **Solution**: Review query syntax in `references\u002Fapi_basics.md`\n\n**Issue**: Missing fields in results\n- **Solution**: Not all records contain all fields; always check field existence\n\n### Getting Help\n\n- **GitHub Issues**: https:\u002F\u002Fgithub.com\u002FFDA\u002Fopenfda\u002Fissues\n- **Email**: open-fda@fda.hhs.gov\n","# FDA Database Access\n\n## Overview\n\nAccess comprehensive FDA regulatory data through openFDA, the FDA's initiative to provide open APIs for public datasets. Query information about drugs, medical devices, foods, animal\u002Fveterinary products, and substances using Python with standardized interfaces.\n\n**Key capabilities:**\n- Query adverse events for drugs, devices, foods, and veterinary products\n- Access product labeling, approvals, and regulatory submissions\n- Monitor recalls and enforcement actions\n- Look up National Drug Codes (NDC) and substance identifiers (UNII)\n- Analyze device classifications and clearances (510k, PMA)\n- Track drug shortages and supply issues\n- Research chemical structures and substance relationships\n\n## When to Use This Skill\n\nThis skill should be used when working with:\n- **Drug research**: Safety profiles, adverse events, labeling, approvals, shortages\n- **Medical device surveillance**: Adverse events, recalls, 510(k) clearances, PMA approvals\n- **Food safety**: Recalls, allergen tracking, adverse events, dietary supplements\n- **Veterinary medicine**: Animal drug adverse events by species and breed\n- **Chemical\u002Fsubstance data**: UNII lookup, CAS number mapping, molecular structures\n- **Regulatory analysis**: Approval pathways, enforcement actions, compliance tracking\n- **Pharmacovigilance**: Post-market surveillance, safety signal detection\n- **Scientific research**: Drug interactions, comparative safety, epidemiological studies\n\n## Quick Start\n\n### 1. Basic Setup\n\n```python\nfrom scripts.fda_query import FDAQuery\n\n# Initialize (API key optional but recommended)\nfda = FDAQuery(api_key=\"YOUR_API_KEY\")\n\n# Query drug adverse events\nevents = fda.query_drug_events(\"aspirin\", limit=100)\n\n# Get drug labeling\nlabel = fda.query_drug_label(\"Lipitor\", brand=True)\n\n# Search device recalls\nrecalls = fda.query(\"device\", \"enforcement\",\n                   search=\"classification:Class+I\",\n                   limit=50)\n```\n\n### 2. API Key Setup\n\nWhile the API works without a key, registering provides higher rate limits:\n- **Without key**: 240 requests\u002Fmin, 1,000\u002Fday\n- **With key**: 240 requests\u002Fmin, 120,000\u002Fday\n\nRegister at: https:\u002F\u002Fopen.fda.gov\u002Fapis\u002Fauthentication\u002F\n\nSet as environment variable:\n```bash\nexport FDA_API_KEY=\"your_key_here\"\n```\n\n### 3. Running Examples\n\n```bash\n# Run comprehensive examples\npython scripts\u002Ffda_examples.py\n\n# This demonstrates:\n# - Drug safety profiles\n# - Device surveillance\n# - Food recall monitoring\n# - Substance lookup\n# - Comparative drug analysis\n# - Veterinary drug analysis\n```\n\n## FDA Database Categories\n\n### Drugs\n\nAccess 6 drug-related endpoints covering the full drug lifecycle from approval to post-market surveillance.\n\n**Endpoints:**\n1. **Adverse Events** - Reports of side effects, errors, and therapeutic failures\n2. **Product Labeling** - Prescribing information, warnings, indications\n3. **NDC Directory** - National Drug Code product information\n4. **Enforcement Reports** - Drug recalls and safety actions\n5. **Drugs@FDA** - Historical approval data since 1939\n6. **Drug Shortages** - Current and resolved supply issues\n\n**Common use cases:**\n```python\n# Safety signal detection\nfda.count_by_field(\"drug\", \"event\",\n                  search=\"patient.drug.medicinalproduct:metformin\",\n                  field=\"patient.reaction.reactionmeddrapt\")\n\n# Get prescribing information\nlabel = fda.query_drug_label(\"Keytruda\", brand=True)\n\n# Check for recalls\nrecalls = fda.query_drug_recalls(drug_name=\"metformin\")\n\n# Monitor shortages\nshortages = fda.query(\"drug\", \"drugshortages\",\n                     search=\"status:Currently+in+Shortage\")\n```\n\n**Reference:** See `references\u002Fdrugs.md` for detailed documentation\n\n### Devices\n\nAccess 9 device-related endpoints covering medical device safety, approvals, and registrations.\n\n**Endpoints:**\n1. **Adverse Events** - Device malfunctions, injuries, deaths\n2. **510(k) Clearances** - Premarket notifications\n3. **Classification** - Device categories and risk classes\n4. **Enforcement Reports** - Device recalls\n5. **Recalls** - Detailed recall information\n6. **PMA** - Premarket approval data for Class III devices\n7. **Registrations & Listings** - Manufacturing facility data\n8. **UDI** - Unique Device Identification database\n9. **COVID-19 Serology** - Antibody test performance data\n\n**Common use cases:**\n```python\n# Monitor device safety\nevents = fda.query_device_events(\"pacemaker\", limit=100)\n\n# Look up device classification\nclassification = fda.query_device_classification(\"DQY\")\n\n# Find 510(k) clearances\nclearances = fda.query_device_510k(applicant=\"Medtronic\")\n\n# Search by UDI\ndevice_info = fda.query(\"device\", \"udi\",\n                       search=\"identifiers.id:00884838003019\")\n```\n\n**Reference:** See `references\u002Fdevices.md` for detailed documentation\n\n### Foods\n\nAccess 2 food-related endpoints for safety monitoring and recalls.\n\n**Endpoints:**\n1. **Adverse Events** - Food, dietary supplement, and cosmetic events\n2. **Enforcement Reports** - Food product recalls\n\n**Common use cases:**\n```python\n# Monitor allergen recalls\nrecalls = fda.query_food_recalls(reason=\"undeclared peanut\")\n\n# Track dietary supplement events\nevents = fda.query_food_events(\n    industry=\"Dietary Supplements\")\n\n# Find contamination recalls\nlisteria = fda.query_food_recalls(\n    reason=\"listeria\",\n    classification=\"I\")\n```\n\n**Reference:** See `references\u002Ffoods.md` for detailed documentation\n\n### Animal & Veterinary\n\nAccess veterinary drug adverse event data with species-specific information.\n\n**Endpoint:**\n1. **Adverse Events** - Animal drug side effects by species, breed, and product\n\n**Common use cases:**\n```python\n# Species-specific events\ndog_events = fda.query_animal_events(\n    species=\"Dog\",\n    drug_name=\"flea collar\")\n\n# Breed predisposition analysis\nbreed_query = fda.query(\"animalandveterinary\", \"event\",\n    search=\"reaction.veddra_term_name:*seizure*+AND+\"\n           \"animal.breed.breed_component:*Labrador*\")\n```\n\n**Reference:** See `references\u002Fanimal_veterinary.md` for detailed documentation\n\n### Substances & Other\n\nAccess molecular-level substance data with UNII codes, chemical structures, and relationships.\n\n**Endpoints:**\n1. **Substance Data** - UNII, CAS, chemical structures, relationships\n2. **NSDE** - Historical substance data (legacy)\n\n**Common use cases:**\n```python\n# UNII to CAS mapping\nsubstance = fda.query_substance_by_unii(\"R16CO5Y76E\")\n\n# Search by name\nresults = fda.query_substance_by_name(\"acetaminophen\")\n\n# Get chemical structure\nstructure = fda.query(\"other\", \"substance\",\n    search=\"names.name:ibuprofen+AND+substanceClass:chemical\")\n```\n\n**Reference:** See `references\u002Fother.md` for detailed documentation\n\n## Common Query Patterns\n\n### Pattern 1: Safety Profile Analysis\n\nCreate comprehensive safety profiles combining multiple data sources:\n\n```python\ndef drug_safety_profile(fda, drug_name):\n    \"\"\"Generate complete safety profile.\"\"\"\n\n    # 1. Total adverse events\n    events = fda.query_drug_events(drug_name, limit=1)\n    total = events[\"meta\"][\"results\"][\"total\"]\n\n    # 2. Most common reactions\n    reactions = fda.count_by_field(\n        \"drug\", \"event\",\n        search=f\"patient.drug.medicinalproduct:*{drug_name}*\",\n        field=\"patient.reaction.reactionmeddrapt\",\n        exact=True\n    )\n\n    # 3. Serious events\n    serious = fda.query(\"drug\", \"event\",\n        search=f\"patient.drug.medicinalproduct:*{drug_name}*+AND+serious:1\",\n        limit=1)\n\n    # 4. Recent recalls\n    recalls = fda.query_drug_recalls(drug_name=drug_name)\n\n    return {\n        \"total_events\": total,\n        \"top_reactions\": reactions[\"results\"][:10],\n        \"serious_events\": serious[\"meta\"][\"results\"][\"total\"],\n        \"recalls\": recalls[\"results\"]\n    }\n```\n\n### Pattern 2: Temporal Trend Analysis\n\nAnalyze trends over time using date ranges:\n\n```python\nfrom datetime import datetime, timedelta\n\ndef get_monthly_trends(fda, drug_name, months=12):\n    \"\"\"Get monthly adverse event trends.\"\"\"\n    trends = []\n\n    for i in range(months):\n        end = datetime.now() - timedelta(days=30*i)\n        start = end - timedelta(days=30)\n\n        date_range = f\"[{start.strftime('%Y%m%d')}+TO+{end.strftime('%Y%m%d')}]\"\n        search = f\"patient.drug.medicinalproduct:*{drug_name}*+AND+receivedate:{date_range}\"\n\n        result = fda.query(\"drug\", \"event\", search=search, limit=1)\n        count = result[\"meta\"][\"results\"][\"total\"] if \"meta\" in result else 0\n\n        trends.append({\n            \"month\": start.strftime(\"%Y-%m\"),\n            \"events\": count\n        })\n\n    return trends\n```\n\n### Pattern 3: Comparative Analysis\n\nCompare multiple products side-by-side:\n\n```python\ndef compare_drugs(fda, drug_list):\n    \"\"\"Compare safety profiles of multiple drugs.\"\"\"\n    comparison = {}\n\n    for drug in drug_list:\n        # Total events\n        events = fda.query_drug_events(drug, limit=1)\n        total = events[\"meta\"][\"results\"][\"total\"] if \"meta\" in events else 0\n\n        # Serious events\n        serious = fda.query(\"drug\", \"event\",\n            search=f\"patient.drug.medicinalproduct:*{drug}*+AND+serious:1\",\n            limit=1)\n        serious_count = serious[\"meta\"][\"results\"][\"total\"] if \"meta\" in serious else 0\n\n        comparison[drug] = {\n            \"total_events\": total,\n            \"serious_events\": serious_count,\n            \"serious_rate\": (serious_count\u002Ftotal*100) if total > 0 else 0\n        }\n\n    return comparison\n```\n\n### Pattern 4: Cross-Database Lookup\n\nLink data across multiple endpoints:\n\n```python\ndef comprehensive_device_lookup(fda, device_name):\n    \"\"\"Look up device across all relevant databases.\"\"\"\n\n    return {\n        \"adverse_events\": fda.query_device_events(device_name, limit=10),\n        \"510k_clearances\": fda.query_device_510k(device_name=device_name),\n        \"recalls\": fda.query(\"device\", \"enforcement\",\n                           search=f\"product_description:*{device_name}*\"),\n        \"udi_info\": fda.query(\"device\", \"udi\",\n                            search=f\"brand_name:*{device_name}*\")\n    }\n```\n\n## Working with Results\n\n### Response Structure\n\nAll API responses follow this structure:\n\n```python\n{\n    \"meta\": {\n        \"disclaimer\": \"...\",\n        \"results\": {\n            \"skip\": 0,\n            \"limit\": 100,\n            \"total\": 15234\n        }\n    },\n    \"results\": [\n        # Array of result objects\n    ]\n}\n```\n\n### Error Handling\n\nAlways handle potential errors:\n\n```python\nresult = fda.query_drug_events(\"aspirin\", limit=10)\n\nif \"error\" in result:\n    print(f\"Error: {result['error']}\")\nelif \"results\" not in result or len(result[\"results\"]) == 0:\n    print(\"No results found\")\nelse:\n    # Process results\n    for event in result[\"results\"]:\n        # Handle event data\n        pass\n```\n\n### Pagination\n\nFor large result sets, use pagination:\n\n```python\n# Automatic pagination\nall_results = fda.query_all(\n    \"drug\", \"event\",\n    search=\"patient.drug.medicinalproduct:aspirin\",\n    max_results=5000\n)\n\n# Manual pagination\nfor skip in range(0, 1000, 100):\n    batch = fda.query(\"drug\", \"event\",\n                     search=\"...\",\n                     limit=100,\n                     skip=skip)\n    # Process batch\n```\n\n## Best Practices\n\n### 1. Use Specific Searches\n\n**DO:**\n```python\n# Specific field search\nsearch=\"patient.drug.medicinalproduct:aspirin\"\n```\n\n**DON'T:**\n```python\n# Overly broad wildcard\nsearch=\"*aspirin*\"\n```\n\n### 2. Implement Rate Limiting\n\nThe `FDAQuery` class handles rate limiting automatically, but be aware of limits:\n- 240 requests per minute\n- 120,000 requests per day (with API key)\n\n### 3. Cache Frequently Accessed Data\n\nThe `FDAQuery` class includes built-in caching (enabled by default):\n\n```python\n# Caching is automatic\nfda = FDAQuery(api_key=api_key, use_cache=True, cache_ttl=3600)\n```\n\n### 4. Use Exact Matching for Counting\n\nWhen counting\u002Faggregating, use `.exact` suffix:\n\n```python\n# Count exact phrases\nfda.count_by_field(\"drug\", \"event\",\n                  search=\"...\",\n                  field=\"patient.reaction.reactionmeddrapt\",\n                  exact=True)  # Adds .exact automatically\n```\n\n### 5. Validate Input Data\n\nClean and validate search terms:\n\n```python\ndef clean_drug_name(name):\n    \"\"\"Clean drug name for query.\"\"\"\n    return name.strip().replace('\"', '\\\\\"')\n\ndrug_name = clean_drug_name(user_input)\n```\n\n## API Reference\n\nFor detailed information about:\n- **Authentication and rate limits** → See `references\u002Fapi_basics.md`\n- **Drug databases** → See `references\u002Fdrugs.md`\n- **Device databases** → See `references\u002Fdevices.md`\n- **Food databases** → See `references\u002Ffoods.md`\n- **Animal\u002Fveterinary databases** → See `references\u002Fanimal_veterinary.md`\n- **Substance databases** → See `references\u002Fother.md`\n\n## Scripts\n\n### `scripts\u002Ffda_query.py`\n\nMain query module with `FDAQuery` class providing:\n- Unified interface to all FDA endpoints\n- Automatic rate limiting and caching\n- Error handling and retry logic\n- Common query patterns\n\n### `scripts\u002Ffda_examples.py`\n\nComprehensive examples demonstrating:\n- Drug safety profile analysis\n- Device surveillance monitoring\n- Food recall tracking\n- Substance lookup\n- Comparative drug analysis\n- Veterinary drug analysis\n\nRun examples:\n```bash\npython scripts\u002Ffda_examples.py\n```\n\n## Additional Resources\n\n- **openFDA Homepage**: https:\u002F\u002Fopen.fda.gov\u002F\n- **API Documentation**: https:\u002F\u002Fopen.fda.gov\u002Fapis\u002F\n- **Interactive API Explorer**: https:\u002F\u002Fopen.fda.gov\u002Fapis\u002Ftry-the-api\u002F\n- **GitHub Repository**: https:\u002F\u002Fgithub.com\u002FFDA\u002Fopenfda\n- **Terms of Service**: https:\u002F\u002Fopen.fda.gov\u002Fterms\u002F\n\n## Support and Troubleshooting\n\n### Common Issues\n\n**Issue**: Rate limit exceeded\n- **Solution**: Use API key, implement delays, or reduce request frequency\n\n**Issue**: No results found\n- **Solution**: Try broader search terms, check spelling, use wildcards\n\n**Issue**: Invalid query syntax\n- **Solution**: Review query syntax in `references\u002Fapi_basics.md`\n\n**Issue**: Missing fields in results\n- **Solution**: Not all records contain all fields; always check field existence\n\n### Getting Help\n\n- **GitHub Issues**: https:\u002F\u002Fgithub.com\u002FFDA\u002Fopenfda\u002Fissues\n- **Email**: open-fda@fda.hhs.gov\n",{"name":5,"description":7},"main","4e647b68aabe849e143b6950971c380f7adccdef","components\u002Fskills\u002Fscientific\u002Ffda-database","https:\u002F\u002Fgithub.com\u002FmarnixGeerkens\u002Frocketlauncher-claude-code","https:\u002F\u002Frocketlauncher.ai\u002Fclaude-code","https:\u002F\u002Fgithub.com\u002FmarnixGeerkens","CEO of Rocketlauncher.ai\r\n\r\nObsessed with AI\r\n\r\njoin  https:\u002F\u002Fwww.skool.com\u002Frocketlauncher-university\r\n👉🏻 it's free ","2026-10-13 00:52:14",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add marnixGeerkens\u002Frocketlauncher-claude-code --skill fda-database",{"tool":38,"command":39},"bunx","bunx skills add marnixGeerkens\u002Frocketlauncher-claude-code --skill fda-database",{"tool":41,"command":42},"pnpm","pnpm dlx skills add marnixGeerkens\u002Frocketlauncher-claude-code --skill fda-database","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FmarnixGeerkens\u002Frocketlauncher-claude-code\u002Fblob\u002Fmain\u002Fcomponents\u002Fskills\u002Fscientific\u002Ffda-database\u002FSKILL.md",true,[46,52,56,60,64,68,72,78],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"references\u002Fanimal_veterinary.md","REFERENCE","参考文档",11799,"https:\u002F\u002Fgithub.com\u002FmarnixGeerkens\u002Frocketlauncher-claude-code\u002Fblob\u002Fmain\u002Fcomponents\u002Fskills\u002Fscientific\u002Ffda-database\u002Freferences\u002Fanimal_veterinary.md",{"path":53,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":54,"sourceHtmlUrl":55},"references\u002Fapi_basics.md",15948,"https:\u002F\u002Fgithub.com\u002FmarnixGeerkens\u002Frocketlauncher-claude-code\u002Fblob\u002Fmain\u002Fcomponents\u002Fskills\u002Fscientific\u002Ffda-database\u002Freferences\u002Fapi_basics.md",{"path":57,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":58,"sourceHtmlUrl":59},"references\u002Fdevices.md",18934,"https:\u002F\u002Fgithub.com\u002FmarnixGeerkens\u002Frocketlauncher-claude-code\u002Fblob\u002Fmain\u002Fcomponents\u002Fskills\u002Fscientific\u002Ffda-database\u002Freferences\u002Fdevices.md",{"path":61,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":62,"sourceHtmlUrl":63},"references\u002Fdrugs.md",13903,"https:\u002F\u002Fgithub.com\u002FmarnixGeerkens\u002Frocketlauncher-claude-code\u002Fblob\u002Fmain\u002Fcomponents\u002Fskills\u002Fscientific\u002Ffda-database\u002Freferences\u002Fdrugs.md",{"path":65,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":66,"sourceHtmlUrl":67},"references\u002Ffoods.md",10789,"https:\u002F\u002Fgithub.com\u002FmarnixGeerkens\u002Frocketlauncher-claude-code\u002Fblob\u002Fmain\u002Fcomponents\u002Fskills\u002Fscientific\u002Ffda-database\u002Freferences\u002Ffoods.md",{"path":69,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":70,"sourceHtmlUrl":71},"references\u002Fother.md",13735,"https:\u002F\u002Fgithub.com\u002FmarnixGeerkens\u002Frocketlauncher-claude-code\u002Fblob\u002Fmain\u002Fcomponents\u002Fskills\u002Fscientific\u002Ffda-database\u002Freferences\u002Fother.md",{"path":73,"resourceType":74,"resourceTypeDesc":75,"sizeBytes":76,"sourceHtmlUrl":77},"scripts\u002Ffda_examples.py","SCRIPT","脚本",10785,"https:\u002F\u002Fgithub.com\u002FmarnixGeerkens\u002Frocketlauncher-claude-code\u002Fblob\u002Fmain\u002Fcomponents\u002Fskills\u002Fscientific\u002Ffda-database\u002Fscripts\u002Ffda_examples.py",{"path":79,"resourceType":74,"resourceTypeDesc":75,"sizeBytes":80,"sourceHtmlUrl":81},"scripts\u002Ffda_query.py",15411,"https:\u002F\u002Fgithub.com\u002FmarnixGeerkens\u002Frocketlauncher-claude-code\u002Fblob\u002Fmain\u002Fcomponents\u002Fskills\u002Fscientific\u002Ffda-database\u002Fscripts\u002Ffda_query.py",[83,90,99,106,113,120],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":19},"01M7EQFDF4T3K89WMFVFQVT3C8","zapier-make-patterns","No-code automation democratizes workflow building. Zapier and Make (formerly Integromat) let non-developers automate business processes without writing code. But no-code doesn't mean no-complexity - these platforms have their own patterns, pitfalls, and breaking points.  This skill covers when to use which platform, how to build reliable automations, and when to graduate to code-based solutions. Key insight: Zapier optimizes for simplicity and integrations (7000+ apps), Make optimizes for power","https:\u002F\u002Fgithub.com\u002FmarnixGeerkens\u002Frocketlauncher-claude-code\u002Fblob\u002Fmain\u002Fcomponents\u002Fskills\u002Fworkflow-automation\u002Fzapier-make-patterns\u002FSKILL.md",[],[],{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":94,"licenseFileUrl":95,"sourceHtmlUrl":96,"categories":97,"keywords":98,"publishedAt":19},"01M7EQFA5XQ0811Q4Q0WCFASZG","yeet","Use only when the user explicitly asks to stage, commit, push, and open a GitHub pull request in one flow using the GitHub CLI (`gh`).","Apache-2.0","https:\u002F\u002Fgithub.com\u002FmarnixGeerkens\u002Frocketlauncher-claude-code\u002Fblob\u002Fmain\u002Fcomponents\u002Fskills\u002Fworkflow-automation\u002Fyeet\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FmarnixGeerkens\u002Frocketlauncher-claude-code\u002Fblob\u002Fmain\u002Fcomponents\u002Fskills\u002Fworkflow-automation\u002Fyeet\u002FSKILL.md",[],[],{"skillNo":100,"name":101,"nameZh":6,"description":102,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":103,"categories":104,"keywords":105,"publishedAt":19},"01M7EQF4J6C2WKQWD9E2RQC6MJ","workflow-automation","Workflow automation is the infrastructure that makes AI agents reliable. Without durable execution, a network hiccup during a 10-step payment flow means lost money and angry customers. With it, workflows resume exactly where they left off.  This skill covers the platforms (n8n, Temporal, Inngest) and patterns (sequential, parallel, orchestrator-worker) that turn brittle scripts into production-grade automation.  Key insight: The platforms make different tradeoffs. n8n optimizes for accessibility","https:\u002F\u002Fgithub.com\u002FmarnixGeerkens\u002Frocketlauncher-claude-code\u002Fblob\u002Fmain\u002Fcomponents\u002Fskills\u002Fworkflow-automation\u002Fworkflow-automation\u002FSKILL.md",[],[],{"skillNo":107,"name":108,"nameZh":6,"description":109,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":110,"categories":111,"keywords":112,"publishedAt":19},"01M7EQF1AT655CYYZBEQ8V6Z9D","trigger-dev","Trigger.dev expert for background jobs, AI workflows, and reliable async execution with excellent developer experience and TypeScript-first design. Use when: trigger.dev, trigger dev, background task, ai background job, long running task.","https:\u002F\u002Fgithub.com\u002FmarnixGeerkens\u002Frocketlauncher-claude-code\u002Fblob\u002Fmain\u002Fcomponents\u002Fskills\u002Fworkflow-automation\u002Ftrigger-dev\u002FSKILL.md",[],[],{"skillNo":114,"name":115,"nameZh":6,"description":116,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":117,"categories":118,"keywords":119,"publishedAt":19},"01M7EQEY9ENH0G2EJ1WD6C1CE8","slack-automation","Automate Slack workspace operations including messaging, search, channel management, and reaction workflows through Composio's Slack toolkit.","https:\u002F\u002Fgithub.com\u002FmarnixGeerkens\u002Frocketlauncher-claude-code\u002Fblob\u002Fmain\u002Fcomponents\u002Fskills\u002Fworkflow-automation\u002Fslack-automation\u002FSKILL.md",[],[],{"skillNo":121,"name":122,"nameZh":6,"description":123,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":94,"licenseFileUrl":6,"sourceHtmlUrl":124,"categories":125,"keywords":126,"publishedAt":19},"01M7EQESHEKPTE0QPW9R6XV5K2","rote","Compile a proven agent skill (a SKILL.md plus references) into a deterministic pipeline that runs without an LLM in the loop, then serve it back to Claude as an MCP tool. Use when: rote, compile this skill, turn this skill into a workflow, make this skill deterministic, make this skill cheaper or faster, harden this skill for production, run this skill as a background job.","https:\u002F\u002Fgithub.com\u002FmarnixGeerkens\u002Frocketlauncher-claude-code\u002Fblob\u002Fmain\u002Fcomponents\u002Fskills\u002Fworkflow-automation\u002Frote\u002FSKILL.md",[],[]]