v0.0.48

getmaxun/maxunv0.0.48Oct 1, 2026by amhsirak

Upgrading?

AI Summary

This release introduces rebuilt official SDKs for Node.js and Python, designed to simplify and standardize the Maxun experience across languages. It introduces a unified API for creating robots, scraping, extracting data, crawling websites, and parsing various document formats.

Key Highlights

  • New official Node.js (`maxun-sdk`) and Python (`maxun`) SDKs with a unified design.
  • One-call robot creation using methods like `maxun.scrape`, `maxun.extract`, and `maxun.crawl`.
  • Support for multiple output formats including Markdown, HTML, text, links, screenshots, and documents.
  • Improved database migration for tracking changes in robot runs.

New Features

  • Node.js SDK
  • Python SDK
  • Unified API for scraping and crawling
  • Document parsing (PDF, DOCX, XLSX, CSV, etc.)
  • Web search integration

Full Release Notes

## New Maxun SDKs: Node.js and Python
 
Both official SDKs have been rebuilt to make Maxun simpler to use from code. The Node.js SDK (`maxun-sdk`) and the Python SDK (`maxun`) now share the same design, so the same few lines work in either language.
 
```bash
npm install maxun-sdk@0.0.15
pip install maxun==0.0.13
```

> ⚠️ Please upgrade to the latest SDK & Maxun App versions for the best experience.

 
### Everything starts from one object
 
Create a robot with one call: the robot name, then a URL, search query or file, then any options. The name is required, and it is how the robot appears in the Maxun dashboard.
 
**Node.js**
 
```javascript
import { Maxun } from 'maxun-sdk';
 
const maxun = new Maxun({ apiKey: 'your-api-key' });
const robot = await maxun.scrape('Maxun', 'https://maxun.dev', { formats: ['markdown'] });
const result = await robot.run();
console.log(result.markdown);
```
 
**Python**
 
```python
from maxun import Maxun
 
async with Maxun(api_key="your-api-key") as maxun:
    robot = await maxun.scrape("Maxun", "https://maxun.dev'", formats=["markdown"])
    result = await robot.run()
    print(result.markdown)
```
 
Every robot type in Maxun is available the same way:
 
- `maxun.scrape(...)`: turn a page into Markdown, HTML, text, links, a summary or screenshots
- `maxun.extract(...)`: extract data with a plain-English prompt, or with selectors
- `maxun.crawl(...)`: collect content from a whole website
- `maxun.search(...)`: search the web, and optionally scrape the results
- `maxun.documents.extract(...)` / `.parse(...)`: read PDF, DOCX, XLSX, CSV, JPG and PNG files
- `maxun.robots`: list, find and delete any robot on your account

### Learn more
 
- [Node.js SDK docs](https://docs.maxun.dev/category/node-sdk) · [GitHub](https://github.com/getmaxun/node-sdk)
- [Python SDK docs](https://docs.maxun.dev/category/python-sdk) · [GitHub](https://github.com/getmaxun/python-sdk)


## What's Changed
* chore: sync new logo by @amhsirak in https://github.com/getmaxun/maxun/pull/1225
* fix(db): add migration for run.hasChanges by @mrhard9090 in https://github.com/getmaxun/maxun/pull/1224
* feat: show test proxy state & !show proxy fetch toast on page load by @amhsirak in https://github.com/getmaxun/maxun/pull/1229
* fix(run): escape quotes in captured-text CSV downloads by @breken-ai in https://github.com/getmaxun/maxun/pull/1226
* fix: recorder discard flow for chrome web data errors by @amhsirak in https://github.com/getmaxun/maxun/pull/1230
* fix: align recorder action box with browser window by @amhsirak in https://github.com/getmaxun/maxun/pull/1231
* fix(gsheet): write one row per screenshot in the Screenshot sheet by @breken-ai in https://github.com/getmaxun/maxun/pull/1227
* chore: pre-release v0.0.48 by @amhsirak in https://github.com/getmaxun/maxun/pull/1232

## New Contributors
* @mrhard9090 made their first contribution in https://github.com/getmaxun/maxun/pull/1224
* @breken-ai made their first contribution in https://github.com/getmaxun/maxun/pull/1226

**Full Changelog**: https://github.com/getmaxun/maxun/compare/v0.0.47...v0.0.48

Related Repositories