{"id":30413048,"url":"https://github.com/4trodev/shieldlinks","last_synced_at":"2026-07-14T06:31:57.061Z","repository":{"id":310154074,"uuid":"1038903963","full_name":"4troDev/shieldlinks","owner":"4troDev","description":"A scam/phishing link blocklist with auto-update support.","archived":false,"fork":false,"pushed_at":"2025-08-16T04:10:59.000Z","size":8,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-08T15:43:29.114Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/shieldlinks","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/4troDev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-16T03:48:45.000Z","updated_at":"2025-08-16T04:12:36.000Z","dependencies_parsed_at":"2025-08-16T05:51:05.871Z","dependency_job_id":null,"html_url":"https://github.com/4troDev/shieldlinks","commit_stats":null,"previous_names":["4trodev/shieldlinks"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/4troDev/shieldlinks","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/4troDev%2Fshieldlinks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/4troDev%2Fshieldlinks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/4troDev%2Fshieldlinks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/4troDev%2Fshieldlinks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/4troDev","download_url":"https://codeload.github.com/4troDev/shieldlinks/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/4troDev%2Fshieldlinks/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35450066,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-14T02:00:06.603Z","response_time":114,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-08-22T02:30:49.034Z","updated_at":"2026-07-14T06:31:57.039Z","avatar_url":"https://github.com/4troDev.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🛡️ ShieldLinks\n\n**ShieldLinks** is a scam \u0026 phishing link blocklist for JavaScript projects.  \nIt comes with a **manual list of known scam domains** and supports **auto-updates** from trusted phishing feeds.  \nPerfect for Discord bots, web apps, or any project that needs to block malicious links.\n\n## 🚀 Features\n- ✅ Easy to use – just `isScam(url)` to check links.  \n- ✅ Comes with a **built-in blocklist** of scam domains.  \n- ✅ **Auto-update support** from public phishing feeds (e.g., OpenPhish, Discord phishing lists).  \n- ✅ Works in **Node.js apps, Discord bots, or backend services**.  \n\n---\n\n## 📦 Installation\n```bash\nnpm install shieldlinks\n````\n\n## 🔧 Usage\n\n### Basic Check\n\n```js\nconst { isScam } = require(\"shieldlinks\");\n\nconsole.log(isScam(\"https://free-discordnitro.com\")); \n// true ✅\n\nconsole.log(isScam(\"https://google.com\")); \n// false ❌\n```\n\n### Get Full Scam List\n\n```js\nconst { getScamList } = require(\"shieldlinks\");\n\nconsole.log(getScamList());\n// [\"free-discordnitro.com\", \"discord-giveaway.net\", ...]\n```\n\n### Auto-Update Blocklist\n\n```js\nconst { autoUpdate, getScamList } = require(\"shieldlinks\");\n\n(async () =\u003e {\n  await autoUpdate();\n  console.log(\"Updated scam list size:\", getScamList().length);\n})();\n```\n\n---\n\n## 🗂️ Project Structure\n\n```\nshieldlinks/\n├── data/\n│   └── scam-links.json    # Built-in blocklist (manual updates)\n├── utils/\n│   ├── check.js           # Scam checker functions\n│   └── update.js          # Auto-update logic\n├── index.js               # Main export\n└── README.md              # Documentation\n```\n\n---\n\n## 📖 API Reference\n\n### `isScam(url: string): boolean`\n\nChecks if the given URL or domain is in the blocklist.\n\n* Returns `true` if the URL is flagged as a scam.\n* Returns `false` if it is safe.\n\n---\n\n### `getScamList(): string[]`\n\nReturns the current in-memory list of scam domains.\n\n---\n\n### `autoUpdate(): Promise\u003cvoid\u003e`\n\nFetches phishing domain lists from trusted sources, merges them, and updates `scam-links.json`.\n\n---\n\n## ⚠️ Disclaimer\n\nThis package is intended as a **helper tool**.\nNo blocklist is 100% complete – always combine with other security practices (link previews, user reports, etc.).\n\n---\n\n## 📜 License\n\nMIT License © 2025 – @4trodev\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F4trodev%2Fshieldlinks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F4trodev%2Fshieldlinks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F4trodev%2Fshieldlinks/lists"}