Skip to content
Skills Library
Science & research · Analysis

alterlab-string-db

/alterlab-string-db

Query the STRING API for protein-protein interactions (59M proteins, 20B+ interactions across 12,500+ organisms), building interaction networks, discovering functional partners, and running GO/KEGG/Pfam enrichment on protein lists. Use when constructing a protein-protein interaction network, expanding from seed proteins to functional partners, or running PPI-based enrichment for systems biology; for curated metabolic pathway maps and reactions prefer alterlab-kegg, and for protein sequences, annotations, or accession ID mapping prefer alterlab-uniprot instead. Part of the AlterLab Academic Ski

Licence
MIT
Last repository change
23.09.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
6
Scripts
1
HTML comments
0
URLs in SKILL.md
6
Deprecation

No signals detected. Repository changed on 23.09.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 1 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: scripts/string_api.py

What it does and when to use it

Query the STRING API for protein-protein interactions (59M proteins, 20B+ interactions across 12,500+ organisms), building interaction networks, discovering functional partners, and running GO/KEGG/Pfam enrichment on protein lists. Use when constructing a protein-protein interaction network, expanding from seed proteins to functional partners, or running PPI-based enrichment for systems biology; for curated metabolic pathway maps and reactions prefer alterlab-kegg, and for protein sequences, annotations, or accession ID mapping prefer alterlab-uniprot instead. Part of the AlterLab Academic Ski

Original author description

Query the STRING API for protein-protein interactions (59M proteins, 20B+ interactions across 12,500+ organisms), building interaction networks, discovering functional partners, and running GO/KEGG/Pfam enrichment on protein lists. Use when constructing a protein-protein interaction network, expanding from seed proteins to functional partners, or running PPI-based enrichment for systems biology; for curated metabolic pathway maps and reactions prefer alterlab-kegg, and for protein sequences, annotations, or accession ID mapping prefer alterlab-uniprot instead. Part of the AlterLab Academic Ski

How it works

  1. Overview
  2. When to Use This Skill
  3. What This Skill Provides
  4. Core Workflow
  5. Key Parameters
  6. API Best Practices
  7. Routing Guidance
  8. References
  9. Troubleshooting (Quick)
  10. Additional Resources
Original SKILL.md headings · 138 lines, 796 words
SKILL.md preview
---
name: alterlab-string-db
description: Query the STRING API for protein-protein interactions (59M proteins, 20B+ interactions across 12,500+ organisms), building interaction networks, discovering functional partners, and running GO/KEGG/Pfam enrichment on protein lists. Use when constructing a protein-protein interaction network, expanding from seed proteins to functional partners, or running PPI-based enrichment for systems biology; for curated metabolic pathway maps and reactions prefer alterlab-kegg, and for protein sequences, annotations, or accession ID mapping prefer alterlab-uniprot instead. Part of the AlterLab Academic Skills suite.
license: MIT
allowed-tools: Read WebFetch Bash(curl:*) Bash(python:*)
compatibility: Keyless STRING REST API (no authentication required); default API serves STRING v12.0 as of 2026-09 — pin with STRING_BASE_URL=https://version-12-0.string-db.org/api
metadata:
    skill-author: AlterLab
    version: "1.0.1"
    last_updated: "2026-09-23"
---

# STRING Database

## Overview

STRING is a comprehensive database of known and predicted protein-protein
interactions covering 59.3M proteins and 20B+ interactions across 12,535 organisms
(v12.0, the version the default API serves as of 2026-09; a `version-12-5`
subdomain also answers — check `string_version()` before comparing results).
Query interaction networks, perform functional enrichment, and discover partners
via the REST API for systems biology and pathway analysis.

## When to Use This Skill

Use this skill when:

- Retrieving protein-protein interaction networks for single or multiple proteins
- Performing functional enrichment (GO, KEGG, Pfam) on protein lists
- Discovering interaction partners and expanding protein networks
- Testing if proteins form significantly enriched functional modules
- Generating network visualizations with evidence-based coloring
- Analyzing homology and protein family relationships
- Conducting cross-species protein interaction comparisons
- Identifying hub proteins and network connectivity patterns

### Does NOT Trigger

| Scenario | Use Instead |
|----------|-------------|
| Curated pathway maps, reactions, KEGG orthology | `alterlab-kegg` |
| Reactome pathway over-representation with the reaction hierarchy | `alterlab-reactome` |
| Protein sequences, function annotation, or accession mapping | `alterlab-uniprot` |
| Graph algorithms on your own network (centrality, communities) | `alterlab-networkx` |
| Domain/family classification of the proteins | `alterlab-interpro` |

## What This Skill Provides

1. Python helper functions (`scripts/string_api.py`) for all STRING REST API
   operations.
2. Comprehensive reference documentation (`references/string_reference.md`) with
   detailed endpoint and parameter specifications.

When a user requests STRING data, determine which operation is needed and use
the appropriate function from `scripts/string_api.py`.

## Core Workflow

1. **Map identifiers first** — `string_map_ids()` converts gene/protein names to
   STRING IDs (format `9606.ENSP00000269305`); always do this for speed and
   accuracy.
2. **Retrieve the network or partners** — `string_network()` for tabular
   interaction data, `string_interaction_partners()` to expand from seeds,
   `string_network_image()` for a PNG figure.
3. **Test and interpret** — `string_ppi_enrichment()` checks whether the network
   has more edges than chance; `string_enrichment()` runs GO/KEGG/Pfam enrichment
   (FDR < 0.05 = significant).
4. **Compare / extend** — `string_homology()` for family/paralog analysis;
   repeat with other `species` for cross-species comparison.
5. **Record version** — `string_version()` for reproducibility.

The eight helper operations and five composed analysis workflows are documented
in the references below.

## Key Parameters

- **`required_score`** (confidence, 0-1000): 150 = low/exploratory, 400 =
  medium/default, 700 = high/conservative, 900 = highest/very stringent. Lower =
  higher recall (more false positives); higher = higher precision.
- **`network_type`**: `'functional'` (all evidence, default — pathway/systems
  biology) or `'physical'` (direct binding only — complexes, structural work).
- **`species`**: NCBI taxon ID (9606 human, 10090 mouse, 7227 fly, 4932 yeast,
  6239 C. elegans, 7955 zebrafish, …). Required for networks > 10 proteins. Full
  list: https://string-db.org/cgi/input?input_page_active_form=organisms

## API Best Practices

1. Always map identifiers first with `string_map_ids()`.
2. Prefer STRING IDs (`9606.ENSP00000269305`) over gene names.
3. Specify `species` for networks > 10 proteins.
4. Respect rate limits — wait ~1 second between API calls.
5. Pin a version for reproducibility — set `STRING_BASE_URL` to a stable
   subdomain (e.g. `https://version-12-0.string-db.org/api`) before running the
   helpers; see `string_reference.md`.
6. Handle errors gracefully — check for an `"Error:"` prefix in returned strings.
7. Match the confidence threshold to your analysis goals.

## Routing Guidance

- **Need the exact code for one operation (ID mapping, network, image, partners,
  functional enrichment, PPI enrichment, homology, version)?** Read
  `references/operations.md`.
- **Running an end-to-end analysis (protein-list, single-protein, pathway-centric,
  cross-species, or network expansion)?** Read `references/analysis-workflows.md`.
- **Need endpoint specs, output formats (TSV/JSON/XML/PSI-MI), evidence-channel
  details, advanced features, error handling, or tool integration (Cytoscape, R,
  Python)?** Read `references/string_reference.md`.

## References

- `references/operations.md` — The eight `scripts/string_api.py` operations with
  usage, parameters, output columns, and interpretation guidance.
- `references/analysis-workflows.md` — Five composed workflows: protein-list
  analysis, single-protein investigation, pathway-centric analysis, cross-species
  comparison, and network expansion/discovery.
- `references/string_reference.md` — Complete API endpoint specifications, all
  output formats, evidence channels and confidence-score details, advanced
  features (bulk upload, values/ranks enrichment), error handling, tool
  integration, and data license/citation.

## Troubleshooting (Quick)

- **No proteins found** — verify `species` matches identifiers; map first; check
  for typos.
- **Empty network** — lower `required_score`; confirm the proteins interact;
  verify species.
- **Timeout / slow** — reduce input size; use STRING IDs; batch large queries.
- **"Species required" error** — add `species` for networks > 10 proteins.
- **Unexpected results** — check `string_version()`; verify `network_type`;
  review the confidence threshold.

See `references/string_reference.md` for the full troubleshooting section.

## Additional Resources

- Web app (proteome upload, complete network + function prediction):
  https://string-db.org
- Bulk downloads (interactions, annotations, pathway mappings):
  https://string-db.org/cgi/download

## Data License and Citation

STRING data is freely available under **Creative Commons BY 4.0** (free for
academic and commercial use, attribution required). When publishing, cite the
most recent STRING publication — currently Szklarczyk D et al. (2025) "The STRING
database in 2025: protein networks with directionality of regulation", Nucleic
Acids Research 53(D1):D730–D737, doi:10.1093/nar/gkae1113 — and state the STRING
version you queried (list: https://string-db.org/cgi/about).
Files in this package (6)
  • SKILL.md 7 KB
  • evals/evals.json 5 KB
  • references/analysis-workflows.md 4 KB
  • references/operations.md 7 KB
  • references/string_reference.md 14 KB
  • scripts/string_api.py 12 KB

Versions

The database has no other skills named alterlab-string-db.

Database snapshot: 13.11.2026 · package version ff44ca073b69 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100alterlab-kegg
    Provide direct REST API access to KEGG (academic use only) for pathway analysis, gene-to-pathway and compound-to-pathway mapping, metabolic reactions, KEGG Orthology (KO), drug-drug interactions, and ID conversion. Use when querying KEGG pathways, mapping genes/compounds to…
  • 95string-database
    Query the STRING database for protein-protein interactions (PPIs), functional enrichment, and homology. Use when the user asks about interactions between specific proteins, interaction evidence, confidence scores, protein interaction partners, or pathway enrichments.
  • 100string-database
    Query the STRING database for protein-protein interactions (PPIs), functional enrichment, and homology. Use when the user asks about interactions between specific proteins, interaction evidence, confidence scores, protein interaction partners, or pathway enrichments.
  • 95protein_interaction_network
    Protein Interaction Network Analysis - Build protein interaction network: map identifiers with STRING, get PPI network, compute enrichment, and link to KEGG pathways. Use this skill for systems biology tasks involving mapping identifiers get string network interaction get ppi…
  • 95string-database
    Query the STRING database for protein-protein interactions (PPIs), functional enrichment, and homology. Use when the user asks about interactions between specific proteins, interaction evidence, confidence scores, protein interaction partners, or pathway enrichments.
  • 95protein_interaction_network
    Protein Interaction Network Analysis - Build protein interaction network: map identifiers with STRING, get PPI network, compute enrichment, and link to KEGG pathways. Use this skill for systems biology tasks involving mapping identifiers get string network interaction get ppi…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.