bioservices-multi-database
Unified Python interface to 40+ bioinformatics web services: UniProt proteins, KEGG pathways, ChEMBL/ChEBI/PubChem, BLAST, cross-database ID mapping, GO annotations, PPI.
Install / Use
npx skills add jaechang-hits/SciAgent-Skills --skill bioservices-multi-databaseInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
AutomationSupported Platforms
Our assessment of bioservices-multi-database
bioservices-multi-database scores 91/100 on our quality scale, 1096th of 2,771 Automation skills we index (top 40%).
Its SKILL.md is 24 KB long, well organised into 61 sections with 19 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 bioservices-multi-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.
bioservices-multi-database compared with similar skills
All 4 of these similar skills score higher than bioservices-multi-database; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| bioservices-multi-database (this skill)by jaechang-hits | 91 | 367 | 3mo ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 113.3k | 12d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 82.1k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 80.2k | today | CLAUDE.md |
| Claude-Code-Game-Studiosby Donchitos | 100 | 40.2k | 10d ago | CLAUDE.md |
Frequently asked questions
- How do I install bioservices-multi-database?
- Run
npx skills add jaechang-hits/SciAgent-Skills --skill bioservices-multi-database. The install tabs above show the steps for each supported agent. - Which AI agents does bioservices-multi-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 bioservices-multi-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 bioservices-multi-database still maintained?
- The repository was last updated about 3 months ago, so bioservices-multi-database is actively maintained.
Skill content
View source on GitHubname: bioservices-multi-database description: > Unified Python interface to 40+ bioinformatics web services: UniProt proteins, KEGG pathways, ChEMBL/ChEBI/PubChem, BLAST, cross-database ID mapping, GO annotations, PPI. For deep single-DB queries use dedicated tools (gget for Ensembl, pubchempy for PubChem); bioservices excels at cross-database workflows. license: GPLv3
BioServices Multi-Database Access
Overview
BioServices provides a unified Python interface to 40+ bioinformatics web services including UniProt, KEGG, ChEMBL, ChEBI, PubChem, UniChem, PSICQUIC, QuickGO, and BLAST. Each service is accessed through a consistent object-oriented API with built-in caching, rate limiting, and output format handling.
When to Use
- Querying protein information from UniProt (search, retrieve, ID mapping)
- Discovering KEGG pathways and extracting gene/interaction networks
- Cross-referencing compounds across ChEMBL, ChEBI, PubChem, and KEGG
- Running BLAST sequence similarity searches against UniProtKB
- Mapping identifiers between biological databases (UniProt, Ensembl, KEGG, RefSeq, PDB)
- Retrieving Gene Ontology annotations via QuickGO
- Finding protein-protein interactions via PSICQUIC (IntAct, MINT, BioGRID)
- Batch converting thousands of biological identifiers with error handling
- For single-database deep queries → use gget (Ensembl), pubchempy (PubChem), or chembl-database-bioactivity skill
- For pathway visualization → use pathway analysis tools (Cytoscape, NetworkX) after retrieving data with bioservices
Prerequisites
pip install bioservices
# Optional: pandas for tabular output, matplotlib for visualization
pip install pandas matplotlib
API Rate Limits: Most services have rate limits. bioservices handles basic throttling internally, but for batch operations add explicit delays:
- UniProt mapping: ~1 request/second for batch jobs
- KEGG: 10 requests/second (be conservative with pathway parsing)
- ChEMBL/ChEBI: 5-10 requests/second
- BLAST: 1 job at a time (async polling, ~30-300s per job)
Quick Start
from bioservices import UniProt, KEGG
import time
# Protein lookup
u = UniProt(verbose=False)
result = u.search("ABL1_HUMAN", frmt="tsv", columns="accession,gene_names,organism_name,length")
print(result[:200])
# Pathway discovery
k = KEGG(verbose=False)
pathways = k.get_pathway_by_gene("hsa:25", "hsa") # ABL1
print(f"ABL1 participates in {len(pathways)} pathways")
for pid, name in list(pathways.items())[:3]:
print(f" {pid}: {name}")
Core API
1. Protein Analysis (UniProt)
from bioservices import UniProt
u = UniProt(verbose=False)
# Search by protein name or gene
result = u.search("BRCA1 AND organism_id:9606", frmt="tsv",
columns="accession,gene_names,protein_name,length,go_p")
print(result[:300])
# Retrieve full entry
entry = u.retrieve("P38398", frmt="txt") # Swiss-Prot flat file
fasta = u.retrieve("P38398", frmt="fasta")
print(fasta[:200])
# ID mapping: gene names → UniProt accessions
result = u.mapping(fr="Gene_Name", to="UniProtKB", query="BRCA1 TP53 ABL1", taxId=9606)
print(f"Mapped {len(result['results'])} entries")
for r in result['results']:
print(f" {r['from']} → {r['to']['primaryAccession']}")
2. Pathway Discovery (KEGG)
from bioservices import KEGG
k = KEGG(verbose=False)
# List pathways for an organism
pathways = k.pathwayIds # All reference pathways
human_pathways = k.list("pathway", "hsa")
print(f"Human pathways: {len(human_pathways.strip().splitlines())}")
# Get pathway details
pathway_data = k.get("hsa04110") # Cell cycle
parsed = k.parse(pathway_data)
print(f"Pathway: {parsed.get('NAME', 'Unknown')}")
print(f"Genes: {len(parsed.get('GENE', {}))}")
# KGML parsing for interaction networks
from bioservices import KEGG
k = KEGG(verbose=False)
kgml = k.get("hsa04110", "kgml") # XML pathway representation
# Parse KGML for entries and relations
import xml.etree.ElementTree as ET
root = ET.fromstring(kgml)
entries = root.findall("entry")
relations = root.findall("relation")
print(f"Entries: {len(entries)}, Relations: {len(relations)}")
# Extract interaction types
from collections import Counter
rel_types = Counter()
for rel in relations:
for subtype in rel.findall("subtype"):
rel_types[subtype.get("name")] += 1
print(f"Interaction types: {dict(rel_types)}")
3. Compound Databases (ChEMBL, ChEBI, UniChem, PubChem)
from bioservices import ChEMBL, ChEBI, UniChem
import time
# ChEMBL compound lookup
chembl = ChEMBL(verbose=False)
result = chembl.get_molecule("CHEMBL25") # Aspirin
print(f"Name: {result['pref_name']}")
print(f"MW: {result['molecule_properties']['full_mwt']}")
print(f"SMILES: {result['molecule_structures']['canonical_smiles']}")
time.sleep(0.2)
# ChEBI entity lookup
chebi = ChEBI(verbose=False)
entity = chebi.getCompleteEntity("CHEBI:15365") # Aspirin
print(f"ChEBI Name: {entity.chebiAsciiName}")
print(f"Formula: {entity.formulae[0].data if entity.formulae else 'N/A'}")
# Cross-database compound mapping via UniChem
from bioservices import UniChem
uc = UniChem()
# Map ChEMBL ID to other databases
# Source IDs: 1=ChEMBL, 2=DrugBank, 3=PDB, 4=IUPHAR, 7=ChEBI, 22=PubChem
mappings = uc.get_mapping("CHEMBL25", 1) # From ChEMBL
for m in mappings[:5]:
print(f" Source {m['src_id']}: {m['src_compound_id']}")
4. Sequence Analysis (BLAST)
from bioservices import NCBIblast
import time
blast = NCBIblast(verbose=False)
sequence = ">query\nMKTAYIAKQRQISFVKSHFSRQLE..." # Truncated for brevity
job_id = blast.run(
program="blastp",
database="uniprotkb_swissprot",
sequence=sequence,
stype="protein",
email="user@example.com" # Required by NCBI
)
print(f"Job submitted: {job_id}")
# Poll for results (async)
while blast.getStatus(job_id) == "RUNNING":
time.sleep(10)
print("Waiting...")
result_types = blast.getResultTypes(job_id)
alignment = blast.getResult(job_id, "out") # Text alignment
print(alignment[:500])
5. Identifier Mapping
from bioservices import UniProt
u = UniProt(verbose=False)
# Batch mapping: UniProt → multiple databases
accessions = "P00520 P12931 P04637 P38398"
# UniProt → PDB
result = u.mapping(fr="UniProtKB_AC-ID", to="PDB", query=accessions)
for r in result.get('results', []):
print(f" {r['from']} → {r['to']}")
# UniProt → Ensembl
result = u.mapping(fr="UniProtKB_AC-ID", to="Ensembl", query=accessions)
print(f"Mapped {len(result.get('results', []))} entries to Ensembl")
# KEGG-based identifier extraction
from bioservices import KEGG
k = KEGG(verbose=False)
# Get cross-references from a KEGG entry
entry = k.get("hsa:25") # ABL1
parsed = k.parse(entry)
# Extract database links
for key in ['DBLINKS', 'PATHWAY']:
if key in parsed:
print(f"{key}: {parsed[key]}")
6. Gene Ontology & Protein Interactions
from bioservices import QuickGO
go = QuickGO(verbose=False)
# Get GO annotations for a protein
annotations = go.Annotation(geneProductId="UniProtKB:P00520", taxonId="9606")
if hasattr(annotations, 'shape'): # DataFrame
print(f"Annotations: {len(annotations)}")
for aspect in ['biological_process', 'molecular_function', 'cellular_component']:
subset = annotations[annotations['goAspect'] == aspect]
print(f" {aspect}: {len(subset)} terms")
# Protein-protein interactions via PSICQUIC
from bioservices import PSICQUIC
psicquic = PSICQUIC(verbose=False)
# Query IntAct for interactions
interactions = psicquic.query("intact", "identifier:P00520", frmt="tab25")
lines = interactions.strip().split("\n") if interactions else []
print(f"Interactions found: {len(lines)}")
for line in lines[:3]:
fields = line.split("\t")
print(f" {fields[0]} <-> {fields[1]}") # Interactor A <-> Interactor B
Key Concepts
Service Initialization & Verbosity
All services share a common pattern: Service(verbose=False) suppresses HTTP request logging. Set verbose=True during debugging to see full request/response details.
Output Format Handling
| Service | Default Format | Available Formats | Notes |
|---------|---------------|-------------------|-------|
| UniProt | XML | tsv, fasta, json, txt, xml, gff | Use tsv with columns= for tabular |
| KEGG | Text | kgml, image | Parse text with k.parse() |
| ChEMBL | JSON | JSON only | Dict access on response |
| ChEBI | SOAP XML | Object attributes | Access via .chebiAsciiName etc. |
| NCBIblast | Text | out, xml, json, ids | Async: submit → poll → retrieve |
| PSICQUIC | PSI-MI TAB | tab25, tab27, xml25, count | Tab-separated interaction records |
| QuickGO | DataFrame | tsv, json | Pandas DataFrame when available |
Common Organism Codes (KEGG)
| Code | Organism | Taxonomy ID |
|------|----------|-------------|
| hsa | Homo sapiens | 9606 |
| mmu | Mus musculus | 10090 |
| rno | Rattus norvegicus | 10116 |
| dme | Drosophila melanogaster | 7227 |
| sce | Saccharomyces cerevisiae | 559292 |
| eco | Escherichia coli K-12 | 83333 |
| ath | Arabidopsis thaliana | 3702 |
UniProt Mapping Database Codes
Common database pairs for u.mapping(fr=, to=):
| Category | Database Code | Example |
|----------|--------------|---------|
| Protein | UniProtKB_AC-ID | P00520 |
| Gene | Gene_Name, GeneID | ABL1, 25 |
| Structure | PDB | 2HYY |
| Sequence | RefSeq_Protein, Ensembl | NP_005148, ENSG00000097007 |
| Pathway | KEGG, Reactome | hsa:25, R-HSA-123 |
| Ontology | GO | GO:0006468 |
Full mapping database list: see references/identifier_mapping_guide.md.
Common Workflows
Workflow 1: Complete Protein Analysis Pipeline
from bioservices import UniProt, KEGG, QuickGO, PSICQUIC
import time
def analyze_protein(uniprot_id):
"""End-to-end protein analysis: metadata → pathways → GO → interactions."""
results = {}
# Step 1: UniProt metadata
u = UniProt(verbose=False)
entry = u.retrieve(uniprot_id, frmt="tsv",
columns="accession,gene_names,protein_name,length,organism_name")
results['uniprot'] = entry
print(f"[1] UniProt entry retrieved")
# Step 2: KEGG pathways
k = KEGG(verbose=False)
mapping = u.mapping(fr="UniProtKB_AC-ID", to="KEGG", query=uniprot_id)
kegg_ids = [r['to'] for r in mapping.get('results', [])]
if kegg_ids:
pathways = k.get_pathway_by_gene(kegg_ids[0], kegg_ids[0][:3])
results['pathways'] = pathways or {}
print(f"[2] Found {len(results['pathways'])} pathways")
time.sleep(0.3)
# Step 3: GO annotations
go = QuickGO(verbose=False)
annotations = go.Annotation(geneProductId=f"UniProtKB:{uniprot_id}")
results['go_annotations'] = annotations
print(f"[3] GO annotations retrieved")
time.sleep(0.3)
# Step 4: Protein interactions
psicquic = PSICQUIC(verbose=False)
interactions = psicquic.query("intact", f"identifier:{uniprot_id}", frmt="tab25")
lines = interactions.strip().split("\n") if interactions else []
results['interactions'] = len(lines)
print(f"[4] Found {len(lines)} interactions")
return results
# Usage
results = analyze_protein("P00520") # ABL1
Workflow 2: Cross-Database Compound Search
from bioservices import KEGG, ChEMBL, ChEBI, UniChem
import time
def search_compound(compound_name):
"""Search compound across KEGG → ChEBI → ChEMBL with cross-references."""
k = KEGG(verbose=False)
# Step 1: KEGG compound search
kegg_results = k.find("compound", compound_name)
if not kegg_results:
print(f"No KEGG results for '{compound_name}'")
return None
kegg_id = kegg_results.strip().split("\t")[0] # First hit
kegg_entry = k.parse(k.get(kegg_id))
print(f"[1] KEGG: {kegg_id} — {kegg_entry.get('NAME', ['Unknown'])[
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.
ruflo
82.1k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
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.
Claude-Code-Game-Studios
40.2kTurn Claude Code into a full game dev studio — 49 AI agents, 75 workflow skills, and a complete coordination system mirroring real studio hierarchy.
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.
