{"_id":"@antybrowser/sdk","_rev":"4-0590926874782db30e31fa8c94167bc9","name":"@antybrowser/sdk","dist-tags":{"latest":"1.0.3"},"versions":{"1.0.0":{"name":"@antybrowser/sdk","version":"1.0.0","keywords":["antybrowser","anti-detect","browser-automation","fingerprint","multi-accounting","proxy","selenium","puppeteer","undetected-browser"],"author":{"name":"AntyBrowser Team"},"license":"MIT","_id":"@antybrowser/sdk@1.0.0","maintainers":[{"name":"antybrowser","email":"support@antybrowser.com"}],"homepage":"https://antybrowser.com","bugs":{"url":"https://github.com/AntyBrowser/AntyBrowser.SDK/issues"},"dist":{"shasum":"dcf963af8c7355b2c960abc775b7a54e9a369db2","tarball":"https://registry.npmjs.org/@antybrowser/sdk/-/sdk-1.0.0.tgz","fileCount":18,"integrity":"sha512-uojrMGHN7rSLyBHP5meue+1O4LEtIdtA0dKTmbNOHW+/NFpKlEHlT2jb8NJ48ZHatWqpdwEklVLd41oAdHSPsQ==","signatures":[{"sig":"MEYCIQCSTBdye7dgmPC37b+7f/CNsWFTPO0a7JRTUURr86TIeAIhAOOzos+zqBOnoCvMpS4VsVxyfOJLnX7pIFglQgHpgafX","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":38898},"main":"dist/index.js","types":"dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.js"}},"gitHead":"f6d9cdba2f5f6ec991e43cc88556afa529992d45","scripts":{"build":"tsc -p tsconfig.build.json","prepublishOnly":"npm run build"},"_npmUser":{"name":"antybrowser","email":"support@antybrowser.com"},"repository":{"url":"git+https://github.com/AntyBrowser/AntyBrowser.SDK.git","type":"git"},"_npmVersion":"11.16.0","description":"Official AntyBrowser SDK — TypeScript client for the AntyBrowser Local API. Manage profiles, proxies, automations, groups, and extensions programmatically.","directories":{},"_nodeVersion":"24.18.0","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.0"},"_npmOperationalInternal":{"tmp":"tmp/sdk_1.0.0_1788698599359_0.6712252229636497","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@antybrowser/sdk","version":"1.0.1","keywords":["antybrowser","anti-detect","browser-automation","fingerprint","multi-accounting","proxy","selenium","puppeteer","undetected-browser"],"author":{"name":"AntyBrowser Team"},"license":"MIT","_id":"@antybrowser/sdk@1.0.1","maintainers":[{"name":"antybrowser","email":"support@antybrowser.com"}],"homepage":"https://antybrowser.com","bugs":{"url":"https://github.com/AntyBrowser/AntyBrowser.SDK/issues"},"dist":{"shasum":"4331def0cfdd4217769a70931ce70eba9ffe80b7","tarball":"https://registry.npmjs.org/@antybrowser/sdk/-/sdk-1.0.1.tgz","fileCount":18,"integrity":"sha512-ciCCVFfplzo0FqH7CeNtn3HtPoNotvLziRdZPvnyTKPsx3l7CZy7avMTwlJ11PX4A3v66bFWfx7+TV/KFTy95Q==","signatures":[{"sig":"MEUCIQDuObaJAdvRrz4vA4uAolPXYuoipq3N8ER2mJuzbcC2hgIgLnm5tGvtvrISsaYfOoS8Yl98Ua7ns3cz2ebi+onW1ag=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQClOhuWBVjdYdHjdWL4NMa1nBQ09TDmMHAkvL2Pj1LV9QIgO1UcOVpTgMFuMpyV+hfmmlzyLG4smT0qTko0uUwztcA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":38898},"main":"dist/index.js","types":"dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.js"}},"gitHead":"f6d9cdba2f5f6ec991e43cc88556afa529992d45","scripts":{"build":"tsc -p tsconfig.build.json","prepublishOnly":"npm run build"},"_npmUser":{"name":"antybrowser","email":"support@antybrowser.com"},"repository":{"url":"git+https://github.com/AntyBrowser/AntyBrowser.SDK.git","type":"git"},"_npmVersion":"11.16.0","description":"Official AntyBrowser SDK — TypeScript client for the AntyBrowser Local API. Manage profiles, proxies, automations, groups, and extensions programmatically.","directories":{},"_nodeVersion":"24.18.0","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.0"},"_npmOperationalInternal":{"tmp":"tmp/sdk_1.0.1_1788701915781_0.7390343281754719","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@antybrowser/sdk","version":"1.0.2","keywords":["antybrowser","anti-detect","browser-automation","fingerprint","multi-accounting","proxy","selenium","puppeteer","undetected-browser"],"author":{"name":"Antybrowser Team"},"license":"MIT","_id":"@antybrowser/sdk@1.0.2","maintainers":[{"name":"antybrowser","email":"support@antybrowser.com"}],"homepage":"https://antybrowser.com","bugs":{"url":"https://github.com/antybrowser/Antybrowser.SDK/issues"},"dist":{"shasum":"7c41804b1fe4680a96a46b9b58a56ef3b5c6d83a","tarball":"https://registry.npmjs.org/@antybrowser/sdk/-/sdk-1.0.2.tgz","fileCount":18,"integrity":"sha512-fhCqaCeWlT/giX+uVqDHnpp5dcxHscRrNpycoMOZNPvMvqdI4ZUGK4DznZMJzfTql5BaZYqyDlwfNsrn7TDwDg==","signatures":[{"sig":"MEUCIQCARZhrKttTR4kH8S3wyfogU0ULnWdXc6v9N2k5UPAV4AIgaEVFpa7hhxkj0dZxk+HjNRk+m/IUrGqCK1vjcY2hLAA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQCfO+OgWtbLfhKZ1xqxlaX+Oi5F+u+dWxh9esF5H6Qz/wIgWpqm379ibI/YqcR302TRNcyu1dUwOewjtWMX6K7ZQrc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":38886},"main":"dist/index.js","types":"dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.js"}},"gitHead":"a1035e6cefa0dae4c335222bf327a507283cec59","scripts":{"build":"tsc -p tsconfig.build.json","prepublishOnly":"npm run build"},"_npmUser":{"name":"antybrowser","email":"support@antybrowser.com"},"repository":{"url":"git+https://github.com/antybrowser/Antybrowser.SDK.git","type":"git"},"_npmVersion":"11.16.0","description":"Official Antybrowser SDK — TypeScript client for the Antybrowser Local API. Manage profiles, proxies, automations, groups, and extensions programmatically.","directories":{},"_nodeVersion":"24.18.0","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.0"},"_npmOperationalInternal":{"tmp":"tmp/sdk_1.0.2_1788713619714_0.4438338657731631","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"_id":"@antybrowser/sdk@1.0.3","bugs":{"url":"https://github.com/antybrowser/SDK/issues"},"dist":{"shasum":"7fb095f53db298f903f5a7df7040c98dd1e92c3f","tarball":"https://registry.npmjs.org/@antybrowser/sdk/-/sdk-1.0.3.tgz","fileCount":18,"integrity":"sha512-7h3bmoTY5BYUOsQfxkpOLbw2Dmum3UloSJ6pDh2YqWbZGCNqxARWzQL7syZ3TVuN6qZzPAzb3wN1OfAnMYedBQ==","signatures":[{"sig":"MEQCIF+m4okLwQ47NqdJfrYD5qafvsho6HP+pmY9DCR1TIRbAiA8jl3qNFaa3SCMQf7PDld5z174LhNxJFAelgFvV4RXew==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCrIVmhemt4dmVOdQC/QRnwdYp272YPatqYJIvFrnOSPQIhAM/P+stVNl/iHqwB8DcBZoOF86P8gGMwVGx3uryIo2u2"}],"unpackedSize":38873},"main":"dist/index.js","name":"@antybrowser/sdk","types":"dist/index.d.ts","author":{"name":"Antybrowser.com"},"engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.js"}},"gitHead":"da081f024edab868261e8a462c027f0c5246024d","license":"MIT","scripts":{"build":"tsc -p tsconfig.build.json","prepublishOnly":"npm run build"},"version":"1.0.3","_npmUser":{"name":"antybrowser","email":"support@antybrowser.com"},"homepage":"https://antybrowser.com","keywords":["antybrowser","anti-detect","browser-automation","fingerprint","multi-accounting","proxy","selenium","puppeteer","undetected-browser"],"repository":{"url":"git+https://github.com/antybrowser/SDK.git","type":"git"},"_npmVersion":"11.16.0","description":"Official Antybrowser SDK — TypeScript client for the Antybrowser Local API. Manage profiles, proxies, automations, groups, and extensions programmatically.","directories":{},"maintainers":[{"name":"antybrowser","email":"support@antybrowser.com"}],"_nodeVersion":"24.18.0","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.0"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sdk_1.0.3_1788751821698_0.9902695438707805"}}},"time":{"created":"2026-09-06T12:43:19.229Z","modified":"2026-09-07T03:30:22.009Z","1.0.0":"2026-09-06T12:43:19.488Z","1.0.1":"2026-09-06T13:38:35.875Z","1.0.2":"2026-09-06T16:53:39.792Z","1.0.3":"2026-09-07T03:30:21.782Z"},"bugs":{"url":"https://github.com/antybrowser/SDK/issues"},"author":{"name":"Antybrowser.com"},"license":"MIT","homepage":"https://antybrowser.com","keywords":["antybrowser","anti-detect","browser-automation","fingerprint","multi-accounting","proxy","selenium","puppeteer","undetected-browser"],"repository":{"url":"git+https://github.com/antybrowser/SDK.git","type":"git"},"description":"Official Antybrowser SDK — TypeScript client for the Antybrowser Local API. Manage profiles, proxies, automations, groups, and extensions programmatically.","maintainers":[{"name":"antybrowser","email":"support@antybrowser.com"}],"readme":"# @antybrowser/sdk\n\nOfficial Antybrowser TypeScript/JavaScript SDK for the Local API. Manage browser profiles, proxies, automations, groups, and extensions programmatically.\n\n[![npm version](https://img.shields.io/npm/v/@antybrowser/sdk.svg)](https://www.npmjs.com/package/@antybrowser/sdk)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n## Prerequisites\n\n- **Antybrowser** desktop app running with the Local API enabled\n- **Node.js >= 18** (uses native `fetch`)\n\n## Installation\n\n```bash\nnpm install @antybrowser/sdk\n```\n\n## Quick Start\n\n```typescript\nimport { AntybrowserClient } from \"@antybrowser/sdk\";\n\n// Connect to the local API (default port 5173)\nconst client = new AntybrowserClient(\"your_api_key_here\");\n\n// Or specify a custom port\nconst client = new AntybrowserClient({ apiKey: \"your_key\", port: 5174 });\n\n// List all profiles\nconst profiles = await client.getProfiles();\nconsole.log(profiles);\n\n// Start a profile and get the debug port for Selenium/Puppeteer\nconst result = await client.startProfile(123);\nconsole.log(`Debug port: ${result.data.debugPort}`);\n```\n\n## Configuration\n\n```typescript\n// Simple — API key only (uses default port 5173)\nconst client = new AntybrowserClient(\"my_api_key\");\n\n// Full options\nconst client = new AntybrowserClient({\n  apiKey: \"my_api_key\",\n  port: 5174,           // custom port (default: 5173)\n  timeout: 60_000,      // request timeout in ms (default: 30000)\n});\n```\n\n## API Reference\n\n### System\n\n| Method | Description |\n|--------|-------------|\n| `getStatus()` | Check API connection status |\n| `getSettings()` | Get current settings |\n| `getSyncStatus()` | Get sync queue status |\n| `refreshSync(profileId?)` | Trigger a sync refresh |\n\n### Profiles\n\n| Method | Description |\n|--------|-------------|\n| `getProfiles()` | List all profiles |\n| `createProfile(data)` | Create a new profile |\n| `updateProfile(id, data)` | Update a profile |\n| `deleteProfile(id)` | Delete a profile |\n| `startProfile(id)` | Start a profile (returns debug port) |\n| `stopProfile(id)` | Stop a running profile |\n| `duplicateProfile(id, opts?)` | Duplicate a profile |\n\n### Automations\n\n| Method | Description |\n|--------|-------------|\n| `getAutomations()` | List all automations |\n| `runAutomation(id, data)` | Run an automation on a profile |\n\n### Groups\n\n| Method | Description |\n|--------|-------------|\n| `getGroups()` | List all groups |\n| `createGroup(data)` | Create a group |\n| `updateGroup(id, data)` | Update a group |\n| `deleteGroup(id)` | Delete a group |\n\n### Proxies\n\n| Method | Description |\n|--------|-------------|\n| `getProxies()` | List all proxies |\n| `createProxy(data)` | Add a proxy (validates connection) |\n| `checkProxy(data)` | Check a single proxy |\n| `checkProxiesBulk(proxies)` | Check multiple proxies |\n| `deleteProxy(id)` | Delete a proxy |\n\n### Extensions\n\n| Method | Description |\n|--------|-------------|\n| `getExtensions()` | List all extensions |\n| `deleteExtension(id)` | Delete an extension |\n| `getProfileExtensions(profileId)` | Get extensions for a profile |\n| `setProfileExtensions(profileId, ids)` | Set extensions for a profile |\n\n## Examples\n\n### Create and launch a profile\n\n```typescript\nimport { AntybrowserClient } from \"@antybrowser/sdk\";\n\nconst client = new AntybrowserClient(\"your_api_key\");\n\n// Create a profile\nconst profile = await client.createProfile({\n  name: \"My Profile\",\n  browserType: \"Chrome\",\n  osFingerprint: \"Windows\",\n  language: \"en-US\",\n  useFingerprint: true,\n});\n\n// Start it\nconst result = await client.startProfile(profile.id);\nconsole.log(`Connect via CDP at 127.0.0.1:${result.data.debugPort}`);\n```\n\n### Bulk proxy check\n\n```typescript\nconst results = await client.checkProxiesBulk([\n  \"user:pass:1.2.3.4:8080\",\n  { host: \"5.6.7.8\", port: 3128, type: \"socks5\" },\n]);\n\nresults.forEach((r, i) => {\n  console.log(`Proxy ${i + 1}: ${r.success ? r.details?.country : r.errorMessage}`);\n});\n```\n\n### Run an automation\n\n```typescript\nconst result = await client.runAutomation(42, {\n  profileId: 123,\n  variables: { TARGET_URL: \"https://example.com\" },\n});\n\nconsole.log(result.message); // \"Automation completed\"\n```\n\n## Error Handling\n\n```typescript\nimport { AntybrowserError } from \"@antybrowser/sdk\";\n\ntry {\n  await client.getProfiles();\n} catch (error) {\n  if (error instanceof AntybrowserError) {\n    console.error(`Status: ${error.statusCode}`);\n    console.error(`Body: ${error.responseBody}`);\n  }\n}\n```\n\n## Links\n\n- [Antybrowser Website](https://antybrowser.com)\n- [GitHub Repository](https://github.com/antybrowser/SDK)\n\n## License\n\nMIT\n","readmeFilename":"README.md"}