UniProt Protein Database Query
Query the UniProt REST API for protein information.
When to Use
- User asks about a protein's function, sequence, or annotation
- User provides a gene name and wants protein info
- User needs protein accession IDs
- User asks "what does gene X do" (protein level)
How to Execute
import requests
import json
BASE_URL = "https://rest.uniprot.org"
# 1. Search by gene name (default: human, reviewed/Swiss-Prot)
def search_uniprot(gene_name, organism_id=9606, max_results=5):
url = f"{BASE_URL}/uniprotkb/search"
params = {
"query": f"gene_exact:{gene_name} AND organism_id:{organism_id} AND reviewed:true",
"format": "json",
"size": max_results,
"fields": "accession,id,gene_names,protein_name,organism_name,length,cc_function,ft_domain,sequence"
}
r = requests.get(url, params=params)
r.raise_for_status()
return r.json()
# 2. Get by accession ID
def get_uniprot_entry(accession):
url = f"{BASE_URL}/uniprotkb/{accession}.json"
# Request an explicit field set so the response shape is deterministic.
params = {"fields": "accession,id,gene_names,protein_name,organism_name,length,cc_function,ft_domain,sequence"}
r = requests.get(url, params=params, timeout=30)
r.raise_for_status()
return r.json()
# 3. Get FASTA sequence
def get_fasta(accession):
url = f"{BASE_URL}/uniprotkb/{accession}.fasta"
r = requests.get(url)
r.raise_for_status()
return r.text
# Example usage
data = search_uniprot("TP53")
for entry in data.get("results", []):
acc = entry["primaryAccession"]
name = entry.get("proteinDescription", {}).get("recommendedName", {}).get("fullName", {}).get("value", "N/A")
gene = entry.get("genes", [{}])[0].get("geneName", {}).get("value", "N/A")
length = entry.get("sequence", {}).get("length", "N/A")
# Extract function
functions = [c["texts"][0]["value"] for c in entry.get("comments", []) if c["commentType"] == "FUNCTION"]
func_text = functions[0][:200] if functions else "N/A"
print(f"Accession: {acc}")
print(f"Protein: {name}")
print(f"Gene: {gene}")
print(f"Length: {length} aa")
print(f"Function: {func_text}")
Common Search Patterns
- By gene:
gene_exact:BRCA1 AND organism_id:9606
- By keyword:
keyword:kinase AND organism_id:9606
- By disease:
cc_disease:cancer AND organism_id:9606
- By GO term:
go:apoptosis AND organism_id:9606
- Species IDs: Human=9606, Mouse=10090, Rat=10116, Zebrafish=7955, Fly=7227, Yeast=559292
Output Format
Present: Accession, protein name, gene, organism, length, function summary, and UniProt link.
Follow-up Suggestions
- "Want me to get the AlphaFold structure for this protein?"
- "Should I check protein-protein interactions on STRING?"
- "Want me to BLAST this protein sequence?"
1---2name: query-uniprot3description: Query UniProt protein database. Use when user asks about protein sequences, functions, annotations, domains, or protein identifiers. Triggers on "uniprot", "protein function", "protein sequence", "gene product", "protein info".4metadata:5 source: https://skillmd.com/skills/stanfish06/query-uniprot6---78# UniProt Protein Database Query910Query the UniProt REST API for protein information.1112## When to Use1314- User asks about a protein's function, sequence, or annotation15- User provides a gene name and wants protein info16- User needs protein accession IDs17- User asks "what does gene X do" (protein level)1819## How to Execute2021```python22import requests23import json2425BASE_URL = "https://rest.uniprot.org"2627# 1. Search by gene name (default: human, reviewed/Swiss-Prot)28def search_uniprot(gene_name, organism_id=9606, max_results=5):29 url = f"{BASE_URL}/uniprotkb/search"30 params = {31 "query": f"gene_exact:{gene_name} AND organism_id:{organism_id} AND reviewed:true",32 "format": "json",33 "size": max_results,34 "fields": "accession,id,gene_names,protein_name,organism_name,length,cc_function,ft_domain,sequence"35 }36 r = requests.get(url, params=params)37 r.raise_for_status()38 return r.json()3940# 2. Get by accession ID41def get_uniprot_entry(accession):42 url = f"{BASE_URL}/uniprotkb/{accession}.json"43 # Request an explicit field set so the response shape is deterministic.44 params = {"fields": "accession,id,gene_names,protein_name,organism_name,length,cc_function,ft_domain,sequence"}45 r = requests.get(url, params=params, timeout=30)46 r.raise_for_status()47 return r.json()4849# 3. Get FASTA sequence50def get_fasta(accession):51 url = f"{BASE_URL}/uniprotkb/{accession}.fasta"52 r = requests.get(url)53 r.raise_for_status()54 return r.text5556# Example usage57data = search_uniprot("TP53")58for entry in data.get("results", []):59 acc = entry["primaryAccession"]60 name = entry.get("proteinDescription", {}).get("recommendedName", {}).get("fullName", {}).get("value", "N/A")61 gene = entry.get("genes", [{}])[0].get("geneName", {}).get("value", "N/A")62 length = entry.get("sequence", {}).get("length", "N/A")63 64 # Extract function65 functions = [c["texts"][0]["value"] for c in entry.get("comments", []) if c["commentType"] == "FUNCTION"]66 func_text = functions[0][:200] if functions else "N/A"67 68 print(f"Accession: {acc}")69 print(f"Protein: {name}")70 print(f"Gene: {gene}")71 print(f"Length: {length} aa")72 print(f"Function: {func_text}")73```7475## Common Search Patterns7677- By gene: `gene_exact:BRCA1 AND organism_id:9606`78- By keyword: `keyword:kinase AND organism_id:9606`79- By disease: `cc_disease:cancer AND organism_id:9606`80- By GO term: `go:apoptosis AND organism_id:9606`81- Species IDs: Human=9606, Mouse=10090, Rat=10116, Zebrafish=7955, Fly=7227, Yeast=5592928283## Output Format8485Present: Accession, protein name, gene, organism, length, function summary, and UniProt link.8687## Follow-up Suggestions8889- "Want me to get the AlphaFold structure for this protein?"90- "Should I check protein-protein interactions on STRING?"91- "Want me to BLAST this protein sequence?"