Operating rules
- Use
scripts/rest_request.pyfor all RNAcentral calls. - Use
base_url=https://rnacentral.org/api/v1. - Keep the trailing slash on collection and record paths to avoid redirects.
- Start with targeted lookups such as
rna/<URS>/<taxid>because broadrna/browsing can be slow or time out. - Re-run requests in long conversations instead of relying on older tool output.
Execution behavior
- Return concise markdown summaries from the script JSON by default.
- Return raw JSON only if the user explicitly asks for machine-readable output.
- Prefer these paths:
rna/<URS>/<taxid>,rna/<URS>/,rna/<URS>/xrefs/, and targetedrna/searches withqplus smallpage_size.
Input
- Read one JSON object from stdin.
- Required fields:
base_url,path - Optional fields:
method,params,headers,json_body,form_body,record_path,response_format,max_items,max_depth,timeout_sec,save_raw,raw_output_path - Common RNAcentral patterns:
{"base_url":"https://rnacentral.org/api/v1","path":"rna/URS000075C808/9606","max_items":10}{"base_url":"https://rnacentral.org/api/v1","path":"rna/","params":{"q":"TP53","page_size":10},"record_path":"results","max_items":10}{"base_url":"https://rnacentral.org/api/v1","path":"rna/URS0000000001/"}{"base_url":"https://rnacentral.org/api/v1","path":"rna/URS0000000001/xrefs/","record_path":"results","max_items":10}
Output
- Success returns
ok,source,path,method,status_code,warnings, and either compactrecordsor a compactsummary. - Use
raw_output_pathwhensave_raw=true. - Failure returns
ok=falsewitherror.codeanderror.message.
Execution
echo '{"base_url":"https://rnacentral.org/api/v1","path":"rna/URS000075C808/9606","max_items":10}' | python scripts/rest_request.py
References
- No additional runtime references are required; keep the import package limited to this file and
scripts/rest_request.py.