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/kegg.md
View on GitHub# KEGG REST API
## Base URL
```
https://rest.kegg.jp
```
## Auth
No API key required. Free for academic use. Commercial use requires license.
## Important: KEGG returns tab-delimited text and flat-file format, NOT JSON.
## Key Operations (URL-path-based, no query parameters)
| URL Pattern | Description |
|-------------|-------------|
| `/list/{database}` | List all entries |
| `/list/{database}/{organism}` | List entries for organism |
| `/get/{dbentries}` | Get entry data (flat-file) |
| `/get/{dbentries}/image` | Pathway image (PNG) |
| `/get/{dbentries}/kgml` | Pathway as KGML XML |
| `/find/{database}/{query}` | Search by keyword |
| `/find/{database}/{query}/formula` | Search by molecular formula |
| `/find/{database}/{value}/exact_mass` | Search by exact mass |
| `/link/{target_db}/{source_db}` | Find linked entries between databases |
| `/link/{target_db}/{dbentries}` | Links for specific IDs |
| `/conv/{target_db}/{dbentries}` | Cross-reference ID conversion |
| `/ddi/{dbentries}` | Drug-drug interactions |
## Database Codes
| Code | Database | Example ID |
|------|----------|------------|
| `pathway` | Pathways | `hsa00010` |
| `compound` | Compounds | `C00001` |
| `drug` | Drugs | `D00001` |
| `enzyme` | Enzymes | `ec:1.1.1.1` |
| `genes`/`hsa` | Genes | `hsa:10458` |
| `disease` | Diseases | `H00001` |
| `reaction` | Reactions | `R00001` |
| `ko` | KO orthologs | `K00001` |
## Example Calls
```
# List human pathways
https://rest.kegg.jp/list/pathway/hsa
# Get pathway entry
https://rest.kegg.jp/get/hsa00010
# Search compounds by name
https://rest.kegg.jp/find/compound/aspirin
# Search by molecular formula
https://rest.kegg.jp/find/compound/C9H8O4/formula
# Find pathways for a gene
https://rest.kegg.jp/link/pathway/hsa:10458
# Find diseases for a gene
https://rest.kegg.jp/link/disease/hsa:672
# Convert KEGG to PubChem IDs
https://rest.kegg.jp/conv/pubchem/C00001
# Get multiple entries (max 10, joined with +)
https://rest.kegg.jp/get/C00001+C00002+C00003
# Drug-drug interactions
https://rest.kegg.jp/ddi/D00564+D00110
```
## Response Format
Tab-delimited text for list/find/link/conv. Flat-file text for get. **No JSON support.**
## Rate Limits
KEGG requests at most 3 calls per second; pace below that and honor failures. Batch up to 10 IDs per `/get` with `+`. May return HTTP 403 if too many requests.
KEGG `conv/pubchem/...` maps to PubChem **Substance IDs (SIDs)**, not Compound IDs (CIDs). Resolve SID to CID through PubChem before joining compound properties. Official contract: https://www.kegg.jp/kegg/rest/keggapi.html
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 |