{"id":35654996,"url":"https://github.com/microlinkhq/is-antibot","last_synced_at":"2026-04-02T16:30:28.104Z","repository":{"id":332410943,"uuid":"1125911895","full_name":"microlinkhq/is-antibot","owner":"microlinkhq","description":"Identify if a response is an antibot challenge from CloudFlare, Akamai, DataDome, Vercel, and more.","archived":false,"fork":false,"pushed_at":"2026-01-05T13:22:53.000Z","size":147,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-01-13T19:51:26.846Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://microlink.io/blog/antibot-at-scale","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/microlinkhq.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-31T16:18:06.000Z","updated_at":"2026-01-05T13:25:17.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/microlinkhq/is-antibot","commit_stats":null,"previous_names":["microlinkhq/is-antibot"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/microlinkhq/is-antibot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microlinkhq%2Fis-antibot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microlinkhq%2Fis-antibot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microlinkhq%2Fis-antibot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microlinkhq%2Fis-antibot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/microlinkhq","download_url":"https://codeload.github.com/microlinkhq/is-antibot/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microlinkhq%2Fis-antibot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28550463,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-18T20:59:07.572Z","status":"ssl_error","status_checked_at":"2026-01-18T20:59:02.799Z","response_time":98,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":"2026-01-05T15:13:50.015Z","updated_at":"2026-04-02T16:30:28.079Z","avatar_url":"https://github.com/microlinkhq.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cpicture\u003e\n  \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://github.com/microlinkhq/cdn/raw/master/dist/logo/banner-dark.png\"\u003e\n  \u003cimg alt=\"microlink cdn\" src=\"https://github.com/microlinkhq/cdn/raw/master/dist/logo/banner.png\" align=\"center\"\u003e\n\u003c/picture\u003e\n\n![Last version](https://img.shields.io/github/tag/microlinkhq/is-antibot.svg?style=flat-square)\n[![Coverage Status](https://img.shields.io/coveralls/microlinkhq/is-antibot.svg?style=flat-square)](https://coveralls.io/github/microlinkhq/is-antibot)\n[![NPM Status](https://img.shields.io/npm/dm/is-antibot.svg?style=flat-square)](https://www.npmjs.org/package/is-antibot)\n\n\u003e Identify if a response is an antibot challenge from CloudFlare, Akamai, DataDome, Vercel, and more.\n\n## Supported Providers\n\n### Anti-Bot Systems\n\n- **CloudFlare** - Bot management and challenge pages\n- **Vercel** - Attack mode protection\n- **Akamai** - Bot Manager and Web Application Protector\n- **DataDome** - Bot protection with CAPTCHA challenges\n- **PerimeterX** - Behavioral bot detection\n- **Shape Security** - Enterprise bot management\n- **Kasada** - Advanced bot mitigation\n- **Imperva/Incapsula** - Web application firewall\n- **AWS WAF** - Amazon Web Services Web Application Firewall\n- **Reblaze** - Cloud-based web security platform\n- **Cheq** - Bot detection and prevention\n- **Sucuri** - Website security platform and WAF\n- **ThreatMetrix** - LexisNexis fraud prevention and device fingerprinting\n- **Meetrics** - User authenticity verification\n- **Ocule** - Bot detection with advanced obfuscation\n- **YouTube** - BotGuard attestation and abuse detection\n- **LinkedIn** - Bot filter protection\n- **Reddit** - Network security challenge-page detection\n\n### CAPTCHA Providers\n\n- **reCAPTCHA** - Google's CAPTCHA service (v2 and v3)\n- **hCaptcha** - Privacy-focused CAPTCHA alternative\n- **FunCaptcha** - Arkose Labs interactive challenges\n- **GeeTest** - AI-powered CAPTCHA\n- **Cloudflare Turnstile** - Privacy-preserving CAPTCHA alternative\n- **Friendly Captcha** - GDPR-compliant privacy-first CAPTCHA\n- **Captcha.eu** - European GDPR-compliant CAPTCHA service\n- **QCloud Captcha** - Tencent Cloud CAPTCHA service\n- **AliExpress CAPTCHA** - AliExpress x5sec security challenge\n\n## Why\n\nWebsites receiving massive quantities of traffic throughout the day, like LinkedIn, Reddit, Instagram, or YouTube, have sophisticated antibot systems to prevent automated access.\n\nWhen you try to fetch the HTML of these sites without the right tools, you often hit a 403 Forbidden, 429 Too Many Requests, or a \"Please prove you're human\" challenge, leaving you with a response that contains no useful data.\n\n**is-antibot** is a lightweight, vendor-agnostic JavaScript library that identifies when a response is actually an antibot challenge, helping you understand when and why your request was blocked.\n\n## Install\n\n```bash\n$ npm install is-antibot --save\n```\n\n## Usage\n\nJust pass `headers`, `html`, and `url` from any HTTP response:\n\n```js\nconst isAntibot = require('is-antibot')\n\nconst response = await fetch('https://www.linkedin.com/in/kikobeats/')\nconst html = await response.text()\n\nconst { detected, provider, detection } = isAntibot({\n  headers: response.headers,\n  html,\n  url: response.url\n})\n\nif (detected) {\n  console.log(`Antibot detected: ${provider} via ${detection}`)\n}\n```\n\nIt also works with [got](https://github.com/sindresorhus/got) or any library where `body` is a string:\n\n```js\nconst response = await got('https://www.linkedin.com/in/kikobeats/')\n  .catch(error =\u003e errorresponse)\n\nconst { detected, provider, detection } = isAntibot(response)\n\nif (detected) {\n  console.log(`Antibot detected: ${provider} via ${detection}`)\n}\n```\n\nThe library returns an object with the following properties:\n\n- `detected` (boolean): Whether an antibot challenge was detected\n- `provider` (string|null): The name of the detected provider (e.g., 'cloudflare', 'recaptcha')\n- `detection` (string|null): Where the signal came from: `'headers'`, `'cookies'`, `'html'`, or `'url'`\n\n## License\n\n**is-antibot** © [microlink.io](https://microlink.io), released under the [MIT](https://github.com/microlinkhq/is-antibot/blob/master/LICENSE.md) License.\u003cbr\u003e\nAuthored and maintained by [microlink.io](https://microlink.io) with help from [contributors](https://github.com/microlinkhq/is-antibot/contributors).\n\n\u003e [microlink.io](https://microlink.io) · GitHub [microlink.io](https://github.com/microlinkhq) · X [@microlinkhq](https://x.com/microlinkhq)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicrolinkhq%2Fis-antibot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmicrolinkhq%2Fis-antibot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicrolinkhq%2Fis-antibot/lists"}