jaspar-database
JASPAR 2024 TF binding profiles via REST API and pyJASPAR. Retrieve PFMs/PWMs by TF name, JASPAR ID, species, or structural class. Scan DNA for TFBS; browse by taxon (human, mouse) or TF family (bHLH, zinc finger). Use for motif enrichment input, TFBS scanning, and regulatory sequence analysis.
Install / Use
npx skills add jaechang-hits/SciAgent-Skills --skill jaspar-databaseInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Data & AnalyticsSupported Platforms
Our assessment of jaspar-database
jaspar-database scores 91/100 on our quality scale, 254th of 599 Data & Analytics skills we index (top 43%).
Its SKILL.md is 28 KB long, well organised into 69 sections with 15 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 jaspar-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.
jaspar-database compared with similar skills
All 4 of these similar skills score higher than jaspar-database; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| jaspar-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 jaspar-database?
- Run
npx skills add jaechang-hits/SciAgent-Skills --skill jaspar-database. The install tabs above show the steps for each supported agent. - Which AI agents does jaspar-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 jaspar-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 jaspar-database still maintained?
- The repository was last updated about 3 months ago, so jaspar-database is actively maintained.
Skill content
View source on GitHubname: "jaspar-database" description: "JASPAR 2024 TF binding profiles via REST API and pyJASPAR. Retrieve PFMs/PWMs by TF name, JASPAR ID, species, or structural class. Scan DNA for TFBS; browse by taxon (human, mouse) or TF family (bHLH, zinc finger). Use for motif enrichment input, TFBS scanning, and regulatory sequence analysis. For ChIP-seq peak motif discovery use homer-motif-analysis; for regulatory variant scoring use regulomedb-database." license: "CC-BY-4.0"
JASPAR Database
Overview
JASPAR is a curated, open-access database of transcription factor (TF) binding profiles represented as position frequency matrices (PFMs). The 2024 release contains 1,209 profiles in the CORE vertebrate collection, covering 783 TFs with experimentally validated binding data from SELEX, ChIP-seq, and PBM experiments. Access is free via the JASPAR REST API at https://jaspar.elixir.no/api/v1/ — no authentication required — and through the pyJASPAR Python library for matrix retrieval and manipulation.
When to Use
- Looking up the PWM or PFM for a specific TF by name (e.g., CTCF, SP1, GATA1) to use as motif input for a scanning tool
- Retrieving all JASPAR profiles for a species (e.g., Homo sapiens, Mus musculus) to build a motif library for enrichment analysis
- Scanning a DNA promoter sequence for predicted TF binding sites using a known PWM
- Finding all TFs of a given structural class (bHLH, zinc finger, homeodomain) to build a TF family binding profile set
- Getting metadata for a JASPAR matrix: number of binding sites, information content, GC content, experiment type
- Downloading complete JASPAR collection sets (CORE, UNVALIDATED, CNE) in JASPAR or MEME format for batch analysis
- Use
homer-motif-analysisinstead when you need de novo motif discovery from ChIP-seq peaks; JASPAR is for retrieving known matrices - For regulatory element annotations tied to a genomic region use
encode-databaseorregulomedb-database
Prerequisites
- Python packages:
requests,pandas,matplotlib,numpy - Optional:
pyJASPAR(Python library wrapping JASPAR REST API with BIOPYTHON motif objects) - Data requirements: TF gene symbols, JASPAR matrix IDs (e.g.,
MA0139.1), or DNA sequences (string or FASTA) - Environment: internet connection; no API key required
- Rate limits: no official published limits; use
time.sleep(0.5)between batch requests
pip install requests pandas matplotlib numpy
pip install pyJASPAR # optional; pulls in biopython
Quick Start
import requests
JASPAR_API = "https://jaspar.elixir.no/api/v1"
# Search for CTCF profile in the CORE vertebrate collection
r = requests.get(f"{JASPAR_API}/matrix/", params={
"search": "CTCF",
"collection": "CORE",
"tax_group": "vertebrates",
"format": "json"
}, timeout=15)
r.raise_for_status()
results = r.json()
print(f"Profiles found: {results['count']}")
for m in results["results"][:3]:
print(f" {m['matrix_id']} {m['name']} sites={m['sites']} type={m['type']}")
# Profiles found: 2
# MA0139.1 CTCF sites=190 type=ChIP-seq
# MA1929.1 CTCF sites=2135 type=ChIP-seq
Core API
Query 1: Matrix Search
Search for TF profiles by TF name, species, collection, or taxonomic group. Returns a paginated list of matching profile records.
import requests, time
JASPAR_API = "https://jaspar.elixir.no/api/v1"
def jaspar_search(search=None, collection="CORE", tax_id=None, tax_group=None,
tf_class=None, tf_family=None, page_size=50):
"""Search JASPAR matrices. Returns list of result dicts."""
params = {"format": "json", "page_size": page_size}
if search: params["search"] = search
if collection: params["collection"] = collection
if tax_id: params["tax_id"] = tax_id
if tax_group: params["tax_group"] = tax_group
if tf_class: params["tf_class"] = tf_class
if tf_family: params["tf_family"] = tf_family
all_results = []
url = f"{JASPAR_API}/matrix/"
while url:
r = requests.get(url, params=params if url == f"{JASPAR_API}/matrix/" else None, timeout=15)
r.raise_for_status()
data = r.json()
all_results.extend(data["results"])
url = data.get("next") # follow pagination
time.sleep(0.3)
return all_results
# Example: all CORE vertebrate profiles for GATA family
gata_profiles = jaspar_search(search="GATA", collection="CORE", tax_group="vertebrates")
print(f"GATA profiles: {len(gata_profiles)}")
for m in gata_profiles[:4]:
print(f" {m['matrix_id']} {m['name']:12s} {m.get('tf_class','')} sites={m['sites']}")
Query 2: Matrix Retrieval
Fetch the full profile record for a specific matrix ID, including the raw PFM counts, metadata, and TF annotations.
import requests
JASPAR_API = "https://jaspar.elixir.no/api/v1"
def get_matrix(matrix_id):
"""Return full matrix record for a JASPAR ID (e.g. 'MA0139.1')."""
r = requests.get(f"{JASPAR_API}/matrix/{matrix_id}/", params={"format": "json"}, timeout=15)
r.raise_for_status()
return r.json()
m = get_matrix("MA0139.1") # CTCF
print(f"ID: {m['matrix_id']} Name: {m['name']}")
print(f"Collection: {m['collection']} Type: {m['type']}")
print(f"Species: {[s['name'] for s in m.get('species', [])]}")
print(f"UniProt: {m.get('uniprot_ids', [])}")
print(f"Sites: {m['sites']} Binding sites used to build matrix")
print(f"TF class: {m.get('class_name', 'n/a')} Family: {m.get('family_name', 'n/a')}")
# PFM structure: dict mapping position (as str) -> {A, C, G, T: count}
pfm = m["pfm"]
n_positions = len(pfm)
print(f"\nPFM length: {n_positions} positions")
print(f"Position 0: {pfm['0']}") # {A: x, C: y, G: z, T: w}
# Position 0: {'A': 87, 'C': 12, 'G': 22, 'T': 69}
Query 3: PWM Computation from PFM
Convert a raw PFM (count matrix) to a position weight matrix (PWM) using log-odds scoring. The PWM is used for binding site scanning.
import requests, numpy as np
JASPAR_API = "https://jaspar.elixir.no/api/v1"
def pfm_to_pwm(pfm_dict, pseudocount=0.8, background=None):
"""
Convert JASPAR PFM dict to PWM (log2 odds).
pfm_dict: dict of str(position) -> {A, C, G, T: float}
Returns: numpy array shape (4, L), rows = [A, C, G, T]
"""
if background is None:
background = {"A": 0.25, "C": 0.25, "G": 0.25, "T": 0.25}
bases = ["A", "C", "G", "T"]
L = len(pfm_dict)
counts = np.array([[pfm_dict[str(i)][b] for i in range(L)] for b in bases], dtype=float)
counts += pseudocount
freqs = counts / counts.sum(axis=0, keepdims=True)
bg = np.array([background[b] for b in bases])[:, None]
pwm = np.log2(freqs / bg)
return pwm # shape (4, L)
r = requests.get(f"{JASPAR_API}/matrix/MA0139.1/", params={"format": "json"}, timeout=15)
pfm = r.json()["pfm"]
pwm = pfm_to_pwm(pfm)
print(f"PWM shape: {pwm.shape} (4 bases × {pwm.shape[1]} positions)")
print(f"Min score per position: {pwm.min(axis=0)[:5]}")
print(f"Max score per position: {pwm.max(axis=0)[:5]}")
# PWM shape: (19, ) -> transposed view: (4, 19)
# Min score per position: [-2.32 -3.64 -3.64 -1.32 -3.64]
# Max score per position: [ 1.87 1.82 1.87 1.71 1.90]
Query 4: Sequence Scanning
Scan a DNA sequence for TFBS matches by sliding the PWM across the sequence and computing log-odds scores at each position.
import requests, numpy as np
JASPAR_API = "https://jaspar.elixir.no/api/v1"
BASE_IDX = {"A": 0, "C": 1, "G": 2, "T": 3}
def pfm_to_pwm(pfm_dict, pseudocount=0.8):
bases = ["A", "C", "G", "T"]
L = len(pfm_dict)
counts = np.array([[pfm_dict[str(i)][b] for i in range(L)] for b in bases], dtype=float)
counts += pseudocount
freqs = counts / counts.sum(axis=0, keepdims=True)
return np.log2(freqs / 0.25)
def scan_sequence(seq, pwm, threshold_pct=0.80):
"""
Slide pwm over seq, return hits above threshold_pct of max possible score.
Returns list of (position, score, strand).
"""
seq = seq.upper()
L = pwm.shape[1]
max_score = pwm.clip(min=0).sum(axis=0).sum()
min_score = pwm.clip(max=0).sum(axis=0).sum()
threshold = min_score + threshold_pct * (max_score - min_score)
hits = []
for i in range(len(seq) - L + 1):
window = seq[i:i+L]
if "N" in window:
continue
score = sum(pwm[BASE_IDX[window[j]], j] for j in range(L))
if score >= threshold:
hits.append((i, round(score, 3), "+"))
return hits, max_score, threshold
# Fetch CTCF matrix and scan a synthetic CTCF-like sequence
r = requests.get(f"{JASPAR_API}/matrix/MA0139.1/", params={"format": "json"}, timeout=15)
pfm = r.json()["pfm"]
pwm = pfm_to_pwm(pfm)
# 100 bp sequence with known CTCF consensus embedded
seq = ("GCAGGTTTAAGCTTCCTGGCATTTAAGCTTCCTGGCATTTCCCCAGGGGGCGGAGGCAGAG"
"CCGCGAGCCGCGAGCCGCGAGCCGCGAGCCGCGAGTTTAAG")
hits, max_score, thresh = scan_sequence(seq, pwm, threshold_pct=0.80)
print(f"Max PWM score: {max_score:.2f} | Threshold (80%): {thresh:.2f}")
print(f"Hits: {len(hits)}")
for pos, score, strand in hits:
print(f" pos={pos} score={score:.2f} {strand} seq={seq[pos:pos+pwm.shape[1]]}")
Query 5: Taxon Browser
List all JASPAR CORE profiles for a specific organism, identified by NCBI taxonomy ID.
import requests, time, pandas as pd
JASPAR_API = "https://jaspar.elixir.no/api/v1"
# Common taxonomy IDs
TAX_IDS = {
"Homo sapiens": 9606,
"Mus musculus": 10090,
"Rattus norvegicus": 10116,
"Drosophila melanogaster": 7227,
"Saccharomyces cerevisiae": 4932,
}
def get_species_profiles(tax_id, collection="CORE"):
"""Return all matrices for a species tax ID."""
params = {"tax_id": tax_id, "collection": collection, "format": "json", "page_size": 100}
results = []
url = f"{JASPAR_API}/matrix/"
while url:
r = requests.get(url, params=params if url == f"{JASPAR_API}/matrix/" else None, timeout=15)
r.raise_for_status()
data = r.json()
results.extend(data["results"])
url = data.get("next")
time.sleep(0.3)
return results
human_profiles = get_species_profiles(TAX_IDS["Homo sapiens"])
print(f"Human CORE profiles: {len(human_profiles)}")
df = pd.DataFrame([{
"matrix_id": m["matrix_id"],
"name": m["name"],
"tf_class": m.get("class_name", ""),
"tf_family": m.get("family_name", ""),
"sites": m["sites"],
"type": m["type"],
} for m in human_profiles])
print(df.head(5).to_string(index=False))
print(f"\nExperiment types:\n{df['type'].value_counts().to_string()}")
Query 6: TF Class and Family Browser
Find all profiles belonging to a specific TF structural class or family, useful for building class-specific motif libraries.
import requests, time
JASPAR_API = "https://jaspar.elixir.no/api/v1"
def get_class_profiles(tf_class=None, tf_family=None, collection="CORE", tax_group="vertebrates"):
"""Return all profiles for a TF structural class or family."""
params = {"collection": collection, "tax_group": tax_group, "format": "json", "page_size": 100}
if tf_class: params["tf_class"] = tf_class
if tf_family: params["tf_family"] = tf_family
results = []
url = f"{JASPAR_API}/matrix/"
while url:
r = requests.get(url, params=params if url == f"{JASPAR_API}/matrix/" else None, timeout=15)
r.raise_for_status()
data = r.json()
results.extend(data["results"])
url = data.get("next")
time.sleep(0.3)
return results
# Common TF classes: "Zinc-coordinating", "Basic leucine zipper", "Helix-turn-helix"
# Common TF families: "C2H2 ZF", "bHLH", "bZIP", "Homeodomain"
bhlh = get_class_profiles(tf_family="bHLH", collection="CORE", tax_group="vertebrates")
print(f"bHLH vertebrate profiles: {len(bhlh)}")
for m in bhlh[:5]:
print(f" {m['matrix_id']:12s} {m['name']:15s} sites={m['sites']:5d} {m['ty
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.
