Public Database Lookup

One bounded GET against a public life-science REST API. The bundled script picks the base URL, adds a User-Agent, retries on 429 and 5xx, and prints a compact JSON envelope instead of the full payload.

Instructions

1. Pick the service that owns the record: uniprot, ncbi-entrez, ncbi-datasets, mgnify, interpro, alphafold, string, or ena.
2. Read the card for that service in references/services.md for the path, parameters, and the right --record-path.
3. Run the wrapper:
   • In this repository: skills/public-db-lookup/scripts/lookup
   • After installation: ~/.agents/skills/public-db-lookup/scripts/lookup
4. Keep --max-items small (default 5). Raise it only when the user needs more rows.
5. When the full payload matters, add --save-raw PATH and work from the file; the envelope still carries the compacted view.
6. For the two NCBI services, export NCBI_API_KEY and NCBI_EMAIL (and NCBI_TOOL if you have one). The script adds them as request parameters and redacts the key from its output.
7. Route PubMed and PMC literature searches to /polars-dovmed and JGI data to /jgi-lakehouse; this skill does not cover them.

Execution behavior