Package Sus Detector: npm & PyPI package risk check API
Check a package before you install it. Give Package Sus Detector a list of npm or PyPI packages (or paste a package.json / requirements.txt, or upload a
- Id:
widget_382 - Price: Ƀ 20 a run, plus the Call Price, Ƀ 0.1 an API run. Your first 100 API runs carry no Call Price.
- Widget page: Run it in your browser
- Docs: Call Abyss from your code
Input
Send these Fields as input. A Field not listed here is refused.
packages
Packages to check (one per line; npm: or pypi: prefix to mix; name@1.2.3 or name==1.2.3)
- Type: string
- Required: no
- Length in characters: at most 30000
ecosystem
Default ecosystem (for lines without npm: / pypi:)
- Type: string
- Required: no
- Allowed values:
npm,pypi
packageJson
package.json contents (optional)
- Type: string
- Required: no
- Length in characters: at most 30000
requirementsTxt
requirements.txt contents (optional)
- Type: string
- Required: no
- Length in characters: at most 30000
lockfile
Lockfile (optional): package-lock.json, npm-shrinkwrap.json, yarn.lock, pnpm-lock.yaml, poetry.lock, uv.lock or Pipfile.lock
An https URL or an upload id.
- Type: string
- Required: no
baseLockfile
Base lockfile to diff against (optional): only new or changed packages are checked
An https URL or an upload id.
- Type: string
- Required: no
includeDevDependencies
Include devDependencies (package.json, package-lock.json, Pipfile.lock)
- Type: string
- Required: no
- Allowed values:
yes,no
projectLicenseType
Your project's licence type (unspecified, permissive, proprietary, weak-copyleft, strong-copyleft)
- Type: string
- Required: no
- Allowed values:
unspecified,permissive,proprietary,weak-copyleft,strong-copyleft
maxPackages
Max packages per run
- Type: number
- Required: no
- Value: 1 to 5000
failOn
CI gate: fail on (never = report only)
- Type: string
- Required: no
- Allowed values:
never,caution,suspicious,not_found
failOnRiskScore
CI gate: fail at risk score (optional, 1-100)
- Type: number
- Required: no
- Value: 1 to 100
newPackageDays
'New package' threshold (days)
- Type: number
- Required: no
- Value: 1 to 365
staleDays
'Stale' threshold (days); twice this is 'abandoned'
- Type: number
- Required: no
- Value: 90 to 3650
includeDownloads
Look up download counts (api.npmjs.org / pypistats.org)
- Type: string
- Required: no
- Allowed values:
yes,no
includeVulnerabilities
Look up known vulnerabilities (OSV)
- Type: string
- Required: no
- Allowed values:
yes,no
includeDepsDev
Include deps.dev data
- Type: string
- Required: no
- Allowed values:
yes,no
includeEol
Check end-of-life status (endoflife.date)
- Type: string
- Required: no
- Allowed values:
yes,no
includeScorecard
Include OpenSSF Scorecard summary (one extra request per package)
- Type: string
- Required: no
- Allowed values:
yes,no
includeSummaryItem
Add the summary as the last item of results.json
- Type: string
- Required: no
- Allowed values:
yes,no
concurrency
Concurrency (packages checked in parallel)
- Type: number
- Required: no
- Value: 1 to 16
Run it
One call presses the Widget and answers the run once its status is succeeded or failed, however long it takes. The key is read from ABYSS_API_KEY. Install the library with npm install abysshub or pip install abysshub; cURL sends the Fields as a form.
JavaScript
// index.mjs
import Abyss from "abysshub";
const abyss = new Abyss();
const run = await abyss.run("widget_382", {
packages: "npm:react\nnpm:lodash@4.17.15\npypi:requests\npypi:django==2.2.0\nnpm:express-ai-validator-helper-pro\npypi:flask-super-auth-helper",
ecosystem: "npm",
includeDevDependencies: "yes",
projectLicenseType: "unspecified",
maxPackages: 500,
failOn: "never",
failOnRiskScore: 100,
newPackageDays: 30,
staleDays: 730,
includeDownloads: "yes",
includeVulnerabilities: "yes",
includeDepsDev: "yes",
includeEol: "yes",
includeScorecard: "no",
includeSummaryItem: "yes",
concurrency: 8,
});
console.log(run.result);
for (const path of await run.save("output")) {
console.log(path);
}Python
from abysshub import Abyss
abyss = Abyss()
run = abyss.run("widget_382", {
"packages": "npm:react\nnpm:lodash@4.17.15\npypi:requests\npypi:django==2.2.0\nnpm:express-ai-validator-helper-pro\npypi:flask-super-auth-helper",
"ecosystem": "npm",
"includeDevDependencies": "yes",
"projectLicenseType": "unspecified",
"maxPackages": 500,
"failOn": "never",
"failOnRiskScore": 100,
"newPackageDays": 30,
"staleDays": 730,
"includeDownloads": "yes",
"includeVulnerabilities": "yes",
"includeDepsDev": "yes",
"includeEol": "yes",
"includeScorecard": "no",
"includeSummaryItem": "yes",
"concurrency": 8,
})
print(run.result)
for path in run.save("output"):
print(path)cURL
curl https://api.abysshub.com/v1/widgets/widget_382/runs \
-H "Authorization: Bearer $ABYSS_API_KEY" \
-F 'packages=npm:react
npm:lodash@4.17.15
pypi:requests
pypi:django==2.2.0
npm:express-ai-validator-helper-pro
pypi:flask-super-auth-helper' \
-F ecosystem=npm \
-F includeDevDependencies=yes \
-F projectLicenseType=unspecified \
-F maxPackages=500 \
-F failOn=never \
-F failOnRiskScore=100 \
-F newPackageDays=30 \
-F staleDays=730 \
-F includeDownloads=yes \
-F includeVulnerabilities=yes \
-F includeDepsDev=yes \
-F includeEol=yes \
-F includeScorecard=no \
-F includeSummaryItem=yes \
-F concurrency=8A succeeded run carries its result and its output_files. Their URLs are signed for each read: re-read the run, never store a URL. A run still queued or running in the answer (after an hour, or when the API is busy) is read again at its Location with ?wait=true.
What it answers
The Example Run's result, the JSON the Widget wrote to output/output.json:
{
"summary": {
"recordType": "summary",
"totalChecked": 6,
"verdictCounts": {
"ok": 2,
"caution": 2,
"suspicious": 0,
"not_found": 2,
"error": 0
},
"overall": "not_found",
"averageRiskScore": 37,
"packagesWithKnownVulnerabilities": 2,
"totalKnownVulnerabilities": 48,
"knownMaliciousListed": [],
"worstOffenders": [
{
"ecosystem": "npm",
"name": "express-ai-validator-helper-pro",
"version": null,
"verdict": "not_found",
"riskScore": 75,
"topReasons": [
"not_in_registry",
"plausible_hallucinated_name"
]
},
{
"ecosystem": "pypi",
"name": "flask-super-auth-helper",
"version": null,
"verdict": "not_found",
"riskScore": 75,
"topReasons": [
"not_in_registry",
"plausible_hallucinated_name"
]
},
{
"ecosystem": "pypi",
"name": "django",
"version": "2.2",
"verdict": "caution",
"riskScore": 47,
"topReasons": [
"known_vulnerabilities_critical",
"release_line_end_of_life"
]
},
{
"ecosystem": "npm",
"name": "lodash",
"version": "4.17.15",
"verdict": "caution",
"riskScore": 24,
"topReasons": [
"known_vulnerabilities_high"
]
},
{
"ecosystem": "npm",
"name": "react",
"version": "19.3.1",
"verdict": "ok",
"riskScore": 0,
"topReasons": []
}
],
"chargedPackages": 6,
"notes": [],
"stoppedEarly": false,
"startedAt": "2026-11-18T22:38:03.550Z",
"finishedAt": "2026-11-18T22:38:04.814Z",
"durationSeconds": 1.3,
"httpRequests": 25,
"popularListsGeneratedAt": {
"npm": "2026-10-26T05:10:04.551Z",
"pypi": "2026-10-26T05:10:04.551Z"
},
"disclaimer": "Risk signals only, derived from public registry metadata and advisory databases. A signal is not proof of wrongdoing; verify before acting.",
"gate": {
"failOn": "never",
"failOnRiskScore": 100,
"enabled": true,
"passed": true,
"exitCode": 0,
"failingCount": 0,
"failing": [],
"incomplete": 0,
"complete": true,
"notChecked": 0
},
"markdown": "### Package Sus Detector: PASSED\n6 package(s) checked: 2 ok, 2 caution, 0 suspicious, 2 not found.\nGate: fail on risk score >= 100.\n\n| Package | Verdict | Score | Why |\n| --- | --- | --- | --- |\n| `express-ai-validator-helper-pro` (npm) | not_found | 75 | Not found in the public registry. Treat as a possibly hallucinated or removed package name. |\n| `flask-super-auth-helper` (pypi) | not_found | 75 | Not found in the public registry. Treat as a possibly hallucinated or removed package name. |\n| `django@2.2` (pypi) | caution | 47 | 43 known vulnerabilities affect 2.2 (max severity: critical; fix available in 6.1.1). Release line 2.2 reached end-of-life on 2022-04-11 (endoflife.date). |\n| `lodash@4.17.15` (npm) | caution | 24 | 5 known vulnerabilities affect 4.17.15 (max severity: high; fix available in 4.18.0). |\n\n_Risk signals from public registry and advisory data, not accusations or a guarantee of safety._"
},
"items": [
{
"recordType": "package",
"ecosystem": "npm",
"name": "react",
"requestedVersion": null,
"requestedRange": null,
"verdict": "ok",
"riskScore": 0,
"resolvedVersion": "19.3.1",
"summary": "No notable risk signals found.",
"reasons": [],
"registry": {
"exists": true,
"url": "https://www.npmjs.com/package/react",
"description": "React is a JavaScript library for building user interfaces.",
"firstPublishedAt": "2011-10-26T17:46:22Z",
"ageDays": 5502,
"latestVersion": "19.3.1",
"latestReleaseAt": "2026-10-14T16:47:15Z",
…More
Keys, files, errors and limits: API access.