dbsnp-database
Query NCBI dbSNP for SNP records by rsID, gene, or region via E-utilities and Variation Services REST API. Retrieve alleles, MAF, variant class (SNV/indel/MNV), clinical links, cross-DB IDs (ClinVar, dbVar, 1000G). Free; 3 req/sec (10 with key).
Install / Use
npx skills add jaechang-hits/SciAgent-Skills --skill dbsnp-databaseInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Data & AnalyticsSupported Platforms
Our assessment of dbsnp-database
dbsnp-database scores 91/100 on our quality scale, 245th of 599 Data & Analytics skills we index (top 41%).
Its SKILL.md is 28 KB long, well organised into 54 sections with 13 code examples: a thorough specification that gives an agent plenty to work with.
It has 367 GitHub stars, a meaningful sign that others use it.
Maintenance, license and trust
- The repository was last updated about 3 months ago, so dbsnp-database is actively maintained.
- Our last check on 2026-11-20 found the source still online.
- No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
- Its trust signals score 88/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-05. Automated pattern scan on 2026-10-05. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
dbsnp-database compared with similar skills
All 4 of these similar skills score higher than dbsnp-database; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| dbsnp-database (this skill)by jaechang-hits | 91 | 367 | 3mo ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 113.3k | 12d ago | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 80.2k | today | CLAUDE.md |
| Scraplingby D4Vinci | 100 | 104.4k | 2d ago | MCP Server |
| crawl4aiby unclecode | 100 | 87.6k | today | MCP Server |
Frequently asked questions
- How do I install dbsnp-database?
- Run
npx skills add jaechang-hits/SciAgent-Skills --skill dbsnp-database. The install tabs above show the steps for each supported agent. - Which AI agents does dbsnp-database work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is dbsnp-database safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 88/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is dbsnp-database still maintained?
- The repository was last updated about 3 months ago, so dbsnp-database is actively maintained.
Skill content
View source on GitHubname: "dbsnp-database" description: "Query NCBI dbSNP for SNP records by rsID, gene, or region via E-utilities and Variation Services REST API. Retrieve alleles, MAF, variant class (SNV/indel/MNV), clinical links, cross-DB IDs (ClinVar, dbVar, 1000G). Free; 3 req/sec (10 with key). For clinical pathogenicity use clinvar-database; for population frequencies use gnomad-database." license: "CC0-1.0"
dbSNP Database
Overview
NCBI dbSNP is the primary public repository for short human genetic variants, cataloguing over 1 billion SNPs, indels, and MNVs with allele frequencies, functional annotations, and cross-references to ClinVar, gnomAD, and 1000 Genomes. Variants are identified by stable rsIDs (reference SNP cluster IDs). Access is free via two APIs: the legacy NCBI E-utilities and the newer NCBI Variation Services REST API, which returns structured JSON.
When to Use
- Looking up allele frequencies and variant class for a known rsID
- Searching all dbSNP variants in a gene or chromosomal region by name or coordinates
- Resolving rsIDs to genomic coordinates (GRCh38/GRCh37) and HGVS notation
- Checking whether a variant of interest has clinical significance links to ClinVar entries
- Batch-fetching hundreds of rsIDs efficiently using epost+efetch history server
- Cross-referencing a list of variant positions to dbSNP rsIDs for downstream annotation
- For clinical pathogenicity classifications use
clinvar-database; dbSNP provides IDs and frequency but not curated clinical significance - For population frequency stratified by ancestry use
gnomad-database; dbSNP MAF is a single aggregate frequency
Prerequisites
- Python packages:
requests,pandas,matplotlib,xml.etree.ElementTree(stdlib) - Data requirements: rsIDs (
rs80357906), gene symbols, or chromosomal coordinates - Environment: internet connection; NCBI Entrez email required for E-utilities (set
emailparameter) - Rate limits: 3 requests/second without API key; 10 requests/second with free NCBI API key. Register at https://www.ncbi.nlm.nih.gov/account/ — add
&api_key=YOUR_KEYto all requests
pip install requests pandas matplotlib
# xml.etree.ElementTree is part of Python stdlib — no additional install needed
Quick Start
import requests
import json
EMAIL = "your@email.com" # required by NCBI policy
BASE_EUTILS = "https://eutils.ncbi.nlm.nih.gov/entrez/eutils"
BASE_VARIATION = "https://api.ncbi.nlm.nih.gov/variation/v0"
def fetch_snp_by_rsid(rsid: str) -> dict:
"""Fetch a dbSNP record by rsID using the NCBI Variation Services API (structured JSON)."""
rs_num = str(rsid).lstrip("rs")
r = requests.get(f"{BASE_VARIATION}/refsnp/{rs_num}", timeout=15)
r.raise_for_status()
return r.json()
record = fetch_snp_by_rsid("rs1800497") # DRD2 Taq1A
print(f"rsID: rs{record['refsnp_id']}")
print(f"Variant type: {record['primary_snapshot_data'].get('variant_type')}")
# Top-level keys: citations, create_date, dbsnp1_merges, last_update_build_id,
# last_update_date, lost_obs_movements, mane_select_ids, present_obs_movements,
# primary_snapshot_data, refsnp_id. (No top-level `organism` field.)
# rsID: rs1800497
# Variant type: snv
Core API
Query 1: rsID Lookup via E-utilities
Fetch the full SNP record for a single rsID using efetch with db=snp. Returns an XML document with alleles, placements, and frequency data.
import requests
import xml.etree.ElementTree as ET
EMAIL = "your@email.com"
BASE = "https://eutils.ncbi.nlm.nih.gov/entrez/eutils"
def efetch_snp_xml(rsid: str) -> ET.Element:
"""Fetch dbSNP XML record for a single rsID via the docsum rettype.
Note: rettype="xml" returns a namespaced ExchangeSet; rettype="docsum"
returns the simpler eSummaryResult/DocumentSummary tree without namespaces."""
rs_num = str(rsid).lstrip("rs")
r = requests.get(f"{BASE}/efetch.fcgi",
params={"db": "snp", "id": rs_num,
"rettype": "docsum", "retmode": "xml",
"email": EMAIL},
timeout=20)
r.raise_for_status()
return ET.fromstring(r.text)
root = efetch_snp_xml("rs80357906")
# Parse the DocumentSummary record (MAF/MAFALLELE were removed in 2024;
# GLOBAL_MAFS is a sub-tree — use ESummary JSON below for easier access)
for docsum in root.iter("DocumentSummary"):
rs_id = docsum.get("uid")
snp_class = docsum.findtext("SNP_CLASS", "Unknown")
chr_pos = docsum.findtext("CHRPOS", "N/A")
clin_sig = docsum.findtext("CLINICAL_SIGNIFICANCE", "N/A")
print(f"rs{rs_id} | Class: {snp_class} | Position: {chr_pos}")
print(f" ClinSig: {clin_sig}")
# rs80357906 | Class: delins | Position: 17:43057062
# ClinSig: pathogenic,risk-factor,uncertain-significance
# Fetch using ESummary for structured JSON (preferred for batch)
def esummary_snp(rsid: str) -> dict:
rs_num = str(rsid).lstrip("rs")
r = requests.get(f"{BASE}/esummary.fcgi",
params={"db": "snp", "id": rs_num,
"retmode": "json", "email": EMAIL},
timeout=15)
r.raise_for_status()
result = r.json()["result"]
return result.get(rs_num, {})
rec = esummary_snp("rs80357906")
print(f"rs{rec.get('snp_id')}:")
print(f" Class : {rec.get('snp_class')}") # e.g., 'delins'
# `maf`/`mafallele` were removed from ESummary in 2024 — use `global_mafs`
# (list of {study, freq}) and pick a study (e.g., 'GnomAD_genomes') or the
# global aggregate ('TOPMED'/'1000Genomes').
for m in rec.get('global_mafs', [])[:4]:
print(f" MAF[{m['study']:18s}]: {m['freq']}")
print(f" ChrPos : {rec.get('chrpos')}") # 17:43057062
print(f" ClinSig : {rec.get('clinical_significance')}")
print(f" FxnClass : {rec.get('fxn_class')}")
Query 2: Gene Variant Search
Search dbSNP for all variants in a gene using esearch. Returns a list of rsIDs matching the gene.
import requests
EMAIL = "your@email.com"
BASE = "https://eutils.ncbi.nlm.nih.gov/entrez/eutils"
def esearch_snp(query: str, retmax: int = 100) -> tuple[list, int]:
"""Search dbSNP using a query string. Returns (id_list, total_count)."""
r = requests.get(f"{BASE}/esearch.fcgi",
params={"db": "snp", "term": query,
"retmax": retmax, "retmode": "json",
"email": EMAIL},
timeout=15)
r.raise_for_status()
result = r.json()["esearchresult"]
return result["idlist"], int(result["count"])
# All variants in BRCA1
ids, total = esearch_snp("BRCA1[gene] AND human[orgn]", retmax=20)
print(f"BRCA1 variants in dbSNP: {total:,} total")
print(f"First 5 rsIDs: {['rs' + i for i in ids[:5]]}")
# Only clinical variants (linked to ClinVar)
ids_clin, total_clin = esearch_snp(
"BRCA1[gene] AND human[orgn] AND clinsig[filter]", retmax=50)
print(f"BRCA1 variants with clinical significance: {total_clin:,}")
Query 3: Chromosomal Region Search
Search for all variants in a genomic region using chromosome coordinates.
import requests
EMAIL = "your@email.com"
BASE = "https://eutils.ncbi.nlm.nih.gov/entrez/eutils"
def search_region(chrom: str, start: int, stop: int,
assembly: str = "GRCh38", retmax: int = 200) -> tuple[list, int]:
"""Find all dbSNP variants in a chromosomal region."""
query = f"{chrom}[CHR] AND {start}:{stop}[CHRPOS37]" if assembly == "GRCh37" else \
f"{chrom}[CHR] AND {start}:{stop}[CHRPOS]"
r = requests.get(f"{BASE}/esearch.fcgi",
params={"db": "snp", "term": query,
"retmax": retmax, "retmode": "json",
"email": EMAIL},
timeout=20)
r.raise_for_status()
result = r.json()["esearchresult"]
return result["idlist"], int(result["count"])
# PCSK9 exon 4 region (GRCh38)
ids, total = search_region("1", 55039700, 55040200)
print(f"Variants in chr1:55039700-55040200: {total:,} total")
print(f"Retrieved {len(ids)} rsIDs: {['rs' + i for i in ids[:5]]}")
Query 4: Variant Summary — MAF, Alleles, Clinical Significance
Retrieve structured summary data for variant records using ESummary, extracting MAF, alleles, and database cross-links.
import requests, json
EMAIL = "your@email.com"
BASE = "https://eutils.ncbi.nlm.nih.gov/entrez/eutils"
def fetch_snp_summaries(rsids: list) -> dict:
"""Fetch ESummary records for a list of rsIDs. Returns dict keyed by rs number."""
ids_str = ",".join(str(r).lstrip("rs") for r in rsids)
r = requests.post(f"{BASE}/esummary.fcgi",
data={"db": "snp", "id": ids_str,
"retmode": "json", "email": EMAIL},
timeout=20)
r.raise_for_status()
return r.json()["result"]
rsids = ["rs80357906", "rs80357220", "rs28897672", "rs1801133"]
result = fetch_snp_summaries(rsids)
for rs_num in rsids:
uid = str(rs_num).lstrip("rs")
rec = result.get(uid, {})
# `global_mafs` is a list of {study, freq}; pick the first or filter by study
gmafs = rec.get("global_mafs", [])
maf_str = gmafs[0]["freq"] if gmafs else "N/A"
maf_study = gmafs[0]["study"] if gmafs else ""
print(f"\n{rs_num}:")
print(f" Class : {rec.get('snp_class', 'N/A')}")
print(f" MAF : {maf_str} (from {maf_study})")
print(f" Location : {rec.get('chrpos', 'N/A')}")
print(f" ClinSig : {rec.get('clinical_significance', 'N/A')}")
print(f" Function : {rec.get('fxn_class', 'N/A')}")
Query 5: Batch rsID Query with EPost+EFetch
Efficiently upload hundreds of rsIDs to the NCBI history server using EPost, then retrieve them in batches with EFetch.
import requests, time, pandas as pd
EMAIL = "your@email.com"
BASE = "https://eutils.ncbi.nlm.nih.gov/entrez/eutils"
def epost_ids(id_list: list) -> tuple[str, str]:
"""Upload rsIDs to NCBI history server. Returns (WebEnv, query_key)."""
ids_str = ",".join(str(i).lstrip("rs") for i in id_list)
r = requests.post(f"{BASE}/epost.fcgi",
data={"db": "snp", "id": ids_str, "email": EMAIL},
timeout=30)
r.raise_for_status()
import xml.etree.ElementTree as ET
root = ET.fromstring(r.text)
webenv = root.findtext("WebEnv")
query_key = root.findtext("QueryKey")
return webenv, query_key
def efetch_history(webenv: str, query_key: str,
retstart: int = 0, retmax: int = 100) -> dict:
"""Retrieve records from NCBI history server using ESummary."""
r = requests.get(f"{BASE}/esummary.fcgi",
params={"db": "snp", "WebEnv": webenv,
"query_key": query_key, "retstart": retstart,
"retmax": retmax, "retmode": "json",
"email": EMAIL},
timeout=30)
r.raise_for_status()
return r.json()["result"]
rsid_batch = ["rs80357906", "rs80357220", "rs28897672", "rs1801133",
"rs429358", "rs7412", "rs1800497"]
webenv, query_key = epost_ids(rsid_batch)
print(f"Posted {len(rsid_batch)} IDs | WebEnv: {webenv[:40]}...")
records = []
for start in range(0, len(rsid_batch), 100):
result = efetch_history(webenv, query_key, retstart=start, retmax=100)
for uid in result.get("uids", []):
rec = result[uid]
# global_mafs replaced maf/mafallele in 2024 — flatten the first entry
gmafs = rec.get("global_mafs", [])
records.append({
"rsid": f"rs{uid}",
"snp_class": rec.get("snp_class"),
"maf": gmafs[0]["freq"] if gmafs else None,
"maf_study": gmafs[0]["study"] if gmafs else None,
"chrpos": rec.get("chrpos"),
"clinical_sig": rec.get("clinical_significance"),
}
Truncated for display — read the full file on GitHub.
Related Skills
Agent-Reach
113.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
headroom
80.2kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Scrapling
104.4k🕷️ The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev
crawl4ai
87.6kOfficial Crawl4AI Cloud: a hosted web scraping, extraction, and search API for AI agents. Free API key, 1,000 credits a month, no card. Fully open source: this repo is the Apache-2.0 crawler that powers it, and you can self-host it.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
