uniprot-database

Query UniProt REST API to search proteins, retrieve sequences, and map IDs.

18|1|Updated Dec 27, 2025
One-click install
npx skills add https://github.com/LogauaEngstrom/claude-scientific-skills --skill uniprot-database-logauaengstrom
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: uniprot-database
Source: https://github.com/LogauaEngstrom/claude-scientific-skills/tree/main/scientific-skills/uniprot-database
Command: npx skills add https://github.com/LogauaEngstrom/claude-scientific-skills --skill uniprot-database-logauaengstrom

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Direct UniProt REST access to UniProt REST API enables programmatic protein searches, sequence retrieval, and cross-database mappings without manual web interactions.

Core Features & Use Cases

  • Search proteins by name, gene, accession, or organism
  • Retrieve sequences in JSON, FASTA, TSV, XML formats
  • Map identifiers between UniProt and external databases (Ensembl, RefSeq, PDB, etc.)
  • Batch retrieve and stream large result sets for high-volume datasets
  • Real-world scenario: integrate into a pipeline to fetch target proteins and map to PDB IDs for downstream modeling

Quick Start

Execute a basic search for a human protein and fetch its JSON entry.

Frequently Asked Questions about uniprot-database

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I retrieve protein sequences in FASTA format using the UniProt REST API?

You can retrieve protein sequences in FASTA format by querying the UniProt REST API endpoint /uniprotkb/{accession}.{format}. The Skill executes this request programmatically to fetch sequence data directly without manual web interactions, supporting JSON, TSV, and XML formats as well.

What is the best way to map protein IDs between UniProt and Ensembl or PDB?

Mapping protein IDs between UniProt and databases like Ensembl, RefSeq, or PDB is accomplished using the /idmapping/run endpoint. The Skill automates submitting identifiers, polling for status, and retrieving cross-database mapping results to integrate protein data across platforms.

Can I batch retrieve and stream large protein datasets from UniProt?

Yes, you can batch retrieve and stream large protein datasets from UniProt using the /uniprotkb/stream endpoint. The Skill supports streaming retrieval to handle high-volume datasets efficiently, returning large result sets in formats like JSON, TSV, FASTA, or XML.

How do I search UniProt by protein name, gene, or organism?

You search UniProt by protein name, gene, accession, or organism using the /uniprotkb/search endpoint. The Skill constructs and executes these queries programmatically, enabling precise filtering to locate target proteins across the UniProtKB database.

Does this UniProt data retrieval approach require complex dependencies?

No, this UniProt data retrieval approach requires only the standard Python requests library as a dependency. The Skill provides a Python client script to simplify usage, wrapping REST API endpoints for straightforward integration into bioinformatics pipelines.

When do I need cross-database ID mapping for protein analysis?

Cross-database ID mapping is needed for protein analysis when integrating UniProt data with structural or genomic databases like PDB or Ensembl. It enables real-world scenarios such as fetching target proteins and mapping to PDB IDs for downstream structural modeling.