K-Dense-AI/scientific-agent-skills / skills/database-lookup
database-lookup
VerifiedQueries documented public database APIs with explicit endpoints, filters, pagination, and provenance. Used when a scientific, regulatory, financial, or other database-backed fact must be retrieved reproducibly from a named source rather than inferred from general knowledge.
references/ncbi-taxonomy.md
View on GitHub# NCBI Taxonomy API Reference
## Overview
Taxonomic classification data (names, lineages, ranks) for all organisms in NCBI databases. Accessible via E-utilities with `db=taxonomy`.
## Base URL
```
https://eutils.ncbi.nlm.nih.gov/entrez/eutils/
```
## Authentication
- **API key** (recommended): Append `&api_key=YOUR_KEY` (register at ncbi.nlm.nih.gov/account).
- Without key: 3 req/sec. With key: 10 req/sec.
- Provide `tool` and `email` parameters.
## Key Endpoints
### 1. ESearch -- Search taxonomy by name
```
GET esearch.fcgi?db=taxonomy&term=QUERY&retmode=json
```
| Param | Description |
|-------|-------------|
| `term` | Organism name, common name, or taxid. Fields: `[Scientific Name]`, `[Common Name]`, `[All Names]`, `[Rank]` |
| `retmax` | Max IDs returned (default 20) |
**Example -- search by scientific name:**
```
GET esearch.fcgi?db=taxonomy&term=Homo+sapiens[Scientific Name]&retmode=json
```
Response:
```json
{
"esearchresult": {
"count": "1",
"idlist": ["9606"]
}
}
```
**Example -- search by common name:**
```
GET esearch.fcgi?db=taxonomy&term=dog[Common Name]&retmode=json
```
### 2. EFetch -- Retrieve full taxonomy records
```
GET efetch.fcgi?db=taxonomy&id=TAXIDS&retmode=xml
```
Note: Taxonomy EFetch only supports XML output.
**Example -- fetch human taxonomy (taxid 9606):**
```
GET efetch.fcgi?db=taxonomy&id=9606&retmode=xml
```
Response (abbreviated XML):
```xml
<TaxaSet>
<Taxon>
<TaxId>9606</TaxId>
<ScientificName>Homo sapiens</ScientificName>
<OtherNames>
<CommonName>human</CommonName>
</OtherNames>
<Rank>species</Rank>
<Division>Primates</Division>
<GeneticCode><GCId>1</GCId><GCName>Standard</GCName></GeneticCode>
<MitoGeneticCode><MGCId>2</MGCId><MGCName>Vertebrate Mitochondrial</MGCName></MitoGeneticCode>
<Lineage>cellular organisms; Eukaryota; Opisthokonta; Metazoa; ... ; Hominidae; Homo</Lineage>
<LineageEx>
<Taxon><TaxId>131567</TaxId><ScientificName>cellular organisms</ScientificName><Rank>no rank</Rank></Taxon>
<Taxon><TaxId>2759</TaxId><ScientificName>Eukaryota</ScientificName><Rank>superkingdom</Rank></Taxon>
<!-- ... each ancestor node ... -->
</LineageEx>
</Taxon>
</TaxaSet>
```
### 3. ESummary -- Brief taxonomy summaries
```
GET esummary.fcgi?db=taxonomy&id=TAXIDS&retmode=json
```
**Example -- multiple taxa:**
```
GET esummary.fcgi?db=taxonomy&id=9606,10090,7227&retmode=json
```
Response includes: lowercase JSON keys `scientificname`, `commonname`, `rank`, `division`, `taxid`, `genus`, `species` (XML uses different capitalization).
### 4. ELink -- Cross-link taxonomy to other databases
```
GET elink.fcgi?dbfrom=taxonomy&db=protein&id=9606&term=insulin
```
Find all protein records for a given taxid, optionally filtered by keyword.
## Common Search Patterns
```
# All species under a genus
term=Drosophila[Next Level] AND species[Rank]
# Search Taxonomy by taxid directly
term=9606[Taxonomy ID]
# By rank
term=Mammalia[Scientific Name] AND class[Rank]
# Taxonomy subtree search
term=9605[Subtree]
```
`txid9606[Organism:exp]` is a sequence-database search expression, not a Taxonomy field. Discover Taxonomy search fields with `einfo.fcgi?db=taxonomy&retmode=json`; resolve scientific names to taxids before subtree searches.
## Useful Cross-references
| Link | Description |
|------|-------------|
| `taxonomy_protein` | All proteins for a taxon |
| `taxonomy_gene` | All genes for a taxon |
| `taxonomy_nuccore` | All nucleotide records for a taxon |
| `taxonomy_genome` | Genome assemblies for a taxon |
## Rate Limits
- Without API key: 3 requests/second
- With API key: 10 requests/second
- EFetch supports multiple taxids in a single call (comma-separated)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |