interpro-database

Query the InterPro API to identify protein domains, families, and functional annotations.

Updated Sep 9, 2026
One-click install
npx skills add https://github.com/xlinh2301/EditCTC --skill interpro-database-xlinh2301
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: interpro-database
Source: https://github.com/xlinh2301/EditCTC/tree/main/.agents/skills/interpro-database
Command: npx skills add https://github.com/xlinh2301/EditCTC --skill interpro-database-xlinh2301

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires polite-http, and includes scripts (resource) and references (resource) components.

What problem does it solve? Protein sequence analysis often requires querying multiple signature databases (Pfam, CDD, SMART, and more) individually, which is slow and redundant. This Skill provides unified programmatic access to InterPro, which integrates 14 member databases into one searchable resource, with built-in rate limiting, pagination, and retry handling. ## Core Features & Use Cases - Domain and Family Identification: Find all domains, families, repeats, and sites annotated on a protein, or find all proteins containing a given domain. - Domain Architecture (IDA) Search: Search for proteins by exact domain combinations and ordering using the two-step ida_search workflow. - InterPro-N Deep Learning Fallback: When standard signatures return no hits, query InterPro-N predictions to annotate uncharacterized or divergent proteins. - Use Case: Given a UniProt accession like P04637, fetch all InterPro entries, linked PDB structures, and taxonomy distribution for its domains, writing results to JSONL files for downstream pipeline processing. ## Quick Start Use the interpro-database skill to list all InterPro domains annotated on UniProt protein P04637 and save the results to a file.

Frequently Asked Questions about interpro-database

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

FAQPage Schema
How do I find all domains in a protein using InterPro?▼

Fetch the entry endpoint linked to the protein's UniProt accession, for example /entry/interpro/protein/uniprot/P04637. The interpro_client.py script handles this via linked endpoint arguments and writes results to a JSONL file.

How do I search proteins by domain architecture in InterPro?▼

Use the ida_search parameter on the root /entry endpoint with comma-separated domain accessions to find matching architectures, then filter the /protein endpoint by the returned ida_id values. The ordered and exact flags control ordering and composition strictness.

Can I look up InterPro entries using a gene name like TP53?▼

No, InterPro requires UniProt accessions such as P04637 and does not reliably map gene names. Resolve the gene name to an accession first using a database like UniProt or Ensembl before querying.

What should I do when InterPro returns no annotations for a protein?▼

Retry the protein query with the interpro_n flag to check InterPro-N deep learning predictions, which can identify remote homologs in uncharacterized proteins. Always report that these results are predictions rather than curated signatures.

How do I count InterPro entries without downloading all results?▼

Use the count command or the get_interpro_count function, which reads the count field from the API response with page_size=1. Never iterate over the fetch generator to tally results, as this downloads entire datasets unnecessarily.