S3 Bibliometric
Semantic Similarity Score (S3): a bibliometric method for mapping intellectual structures, packaged as a free Python library and an MCP server that LLM assistants (Claude, and any other MCP client) can call.
Give it a Scopus export. It finds the research communities of the field, their central papers, outliers, and the citation flows between communities. Your AI assistant can then label the communities and write up the intellectual structure.
How S3 works
- Embed each paper's
Title. Abstractwithsentence-transformers/all-mpnet-base-v2 - S3 matrix = cosine similarity between all papers, temporally masked (year_i ≤ year_j)
- Scan thresholds 0.75–0.85: graph of S3 ≥ t → Louvain communities → silhouette
- Keep the threshold with the highest SII = silhouette × clustered papers
- Report communities, eigenvector centrality, outliers (papers with no S3 link), author
keywords, TF-IDF terms and, when
References+EIDare exported, in-corpus citation flows with QI (within-community citations / size) and MI (share of field citations)
Louvain uses a fixed seed (default 42), so results are reproducible.
Use it from Claude (no install, no API key)
You need uv.
Claude Code
claude mcp add s3-bibliometric -- uvx s3-bibliometric
Claude Desktop: add this to claude_desktop_config.json (Settings → Developer → Edit Config):
{
"mcpServers": {
"s3-bibliometric": {
"command": "uvx",
"args": ["s3-bibliometric"]
}
}
}
Then ask, for example:
Run S3 on ~/Downloads/scopus_innovation.csv, label the communities, and write the intellectual-structure report.
You can also use the built-in s3_report prompt. The first run downloads the model
(~420 MB) and PyTorch, so it takes a few minutes. Later runs are fast.
| Tool | What it does |
|---|---|
run_s3_analysis |
Run S3 on a CSV/XLSX (optional year range); returns a run_id and a summary |
list_runs |
Saved runs |
get_threshold_scan |
Silhouette / SII / communities for each threshold |
list_communities |
Community table incl. QI/MI and saved labels |
get_community |
Central papers with abstracts, keywords, TF-IDF terms |
get_outliers |
Unconnected papers + nearest community |
get_citation_structure |
Community × community citation matrix + QI/MI |
search_papers |
Semantic search inside the corpus |
save_community_labels |
Store the labels the assistant proposes |
export_results |
Write CSV outputs |
Runs are saved in ~/s3bib_runs (change it with the S3BIB_HOME environment variable).
Use it from Python
pip install s3-bibliometric
import s3bib
res = s3bib.run_s3("scopus.csv") # or run_s3(df, s3bib.S3Config(start_year=2010))
res.scan # threshold scan
res.communities() # size, citations, years, QI/MI
res.community_papers(0, n=10) # most central papers
res.top_keywords(0); res.top_terms(0)
res.outliers()
res.citation_matrix()
res.search("absorptive capacity")
res.labels = {0: "Open innovation", 1: "M&A"}
res.export("results/") # CSVs
res.save("runs/innovation") # reload with s3bib.S3Result.load(...)
Input
Export from Scopus as CSV with at least Title and Abstract. Also used if present: Year, Cited by, Authors, Author Keywords, Source title, DOI, and References + EID (needed for the citation analysis).
Notes
- On a CPU, embedding 5,000 abstracts takes a few minutes. The silhouette step uses an N×N matrix (~100 MB at N = 5,000).
- A paper counts as citing another if the first 60 characters of the other paper's normalised title appear in its References. This step is O(N²).
examples/make_sample.pycreates a small synthetic dataset for testing.
Citation
If you use this package, please cite the S3 paper: Semantic Similarity Score: A New Bibliometric Method for Mapping Intellectual Structures in Business Research.
License
MIT
Metadata
Release files for s3-bibliometric 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| s3_bibliometric-0.1.0.tar.gz | 19.9 kB | Without provenance | Details for s3_bibliometric-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| s3_bibliometric-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for s3_bibliometric-0.1.0-py3-none-any.whl |
Total release size: 36.0 kB
Release files / s3_bibliometric-0.1.0.tar.gz
| Download URL | s3_bibliometric-0.1.0.tar.gz |
|---|---|
| Size | 19.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f6e811b2e3085cac4839c6fa0863aed32275c5b7526b7d7da6963ae19f4cf38e
|
|
BLAKE2b-256 checksum How to use checksums |
7e7ca38eb237d87083f0b67c0a8d8be7a6992819af79699187a8779a99d20f8a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / s3_bibliometric-0.1.0-py3-none-any.whl
| Download URL | s3_bibliometric-0.1.0-py3-none-any.whl |
|---|---|
| Size | 16.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
7af7a5715b7fcd678dbb80459143649f3881dad7c07829c4a3e66eeb9d9d9d69
|
|
BLAKE2b-256 checksum How to use checksums |
e1577ab332eb984617409dbfde204f18dc01f028aabf5e72b237e9eee7598dc0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for s3-bibliometric 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.