Ndfrt

Skill BioTender-max/awesome-bio-agent-skills/skills/drugclaw/ndfrt

Query NDF-RT (National Drug File Reference Terminology) via the NCI EVS REST API. Use when looking up drug mechanisms of action, physiological effects, pharmacologic classes, chemical structures, or drug–disease relationships (may_treat / may_prevent) in NDF-RT. Accepts drug names or NDF-RT codes.From its SKILL.md

Install

npx -y skills add BioTender-max/awesome-bio-agent-skills --skill ndfrt

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.

SKILL.md

2.3 KB, 562 tokens by cl100k_base, as published. Nobody here has run it

NDF-RT Query Skill

Search NDF-RT concepts by drug name or NDF-RT code via the NCI EVS REST API. Auto-detects entity type by pattern:

Input Pattern	Detected As	Lookup Logic
`N0000145918`	NDF-RT code (`N` + 10 digits)	direct concept GET
anything else	free text	full-text search endpoint

API

Function	Input	Returns
`search(entity, limit)`	single entity string	`dict` with `entity`, `type`, `results`
`search_batch(entities, limit)`	list of entity strings	`dict[str, dict]`
`summarize(result, entity)`	search result dict + label	compact multi-line text
`to_json(result)`	search result dict	`list[dict]`

Result dict structure

Each item in results contains:

Key	Description
`code`	NDF-RT concept code
`name`	Preferred concept name
`kind`	Concept kind (e.g. `DRUG_KIND`, `DISEASE_KIND`)
`properties`	flat `{type: value}` property dict
`roles`	list of `{type, relatedCode, relatedName}` role relationships
`parents`	list of `{code, name}` ISA parent concepts
`synonyms`	deduplicated list of synonym strings

Key NDF-RT relationship types (roles)

Role	Meaning
`has_MoA`	mechanism of action
`has_PE`	physiological effect
`has_EPC`	established pharmacologic class
`may_treat`	indicated disease/condition
`may_prevent`	preventable disease/condition
`CI_with`	contraindicated with
`has_Chemical_Structure`	chemical structure classification

Usage

See if __name__ == "__main__" block in 52_NDF_RT.py for runnable examples covering: drug name search, code lookup, batch search, JSON output, and root concept listing.

Data

Source: NCI EVS REST API (https://api-evsrest.nci.nih.gov/api/v1)
Terminology: ndfrt
Auth: none required
Rate limits: not documented; use reasonable request spacing
Maintainer: U.S. Department of Veterans Affairs / NCI Enterprise Vocabulary Services

What ships with it: 5 files

14.6 KB alongside SKILL.md, 4 of them executable

example.pyruns9.3 KB
__init__.pyruns126 B
ndfrt_skill.pyruns3.4 KB
README.md1.0 KB
retrieve.pyruns781 B