README 未给出具体命令,需按官方文档的 Docker Compose 或本地安装步骤操作;自托管需自行配置环境变量,参见 environment_variables 文档;项目采用 AGPLv3,商业使用需注意许可证义务
maxun
getmaxunAGPL-3.0活跃维护把任意网站变成结构化 API,无需写代码就能抓取、自动化、搜索和监控网页数据,适合做数据采集和 RPA 场景。
Turn any website into a structured API. Extract, automate, search and monitor the web.
docker compose up(详见 https://docs.maxun.dev/installation/docker)README 未说明
开源网页数据平台,把任意网站变成结构化 API,支持抓取、爬取、搜索与监控
把任意网站变成结构化 API,无需写代码就能抓取、自动化、搜索和监控网页数据,适合做数据采集和 RPA 场景。
核心能力
- 录制浏览器操作生成可复用的提取机器人
- 用自然语言描述需求由 AI 完成数据提取
- 将整页转为 Markdown、HTML 并截图
- 整站爬取并跨页面提取内容
- 持续监控网页变化并在变动时通知
容易踩的坑
- v0.1.0最新正式版2026-10-25 · 2026-10-25 01:45 UTC
We're moving beyond
0.0.xand into0.1.0!This release brings major improvements across scraping, crawling, AI-powered data extraction, document processing, and MCP. We've also rebuilt parts of the experience to make Maxun more capable, reliable, and useful as an open-source web data platform.
Here's what's new.
⚡ Faster scraping, better results
Scraping is now 4× faster, dropping from 2.5 seconds to 0.63 seconds in our local benchmark covering text, links, Markdown, HTML, and screenshots.
We've also improved the quality of extracted content across 91 real-world pages:
- 26% higher precision - less irrelevant content in the output.
- 12% higher F1 score - a better balance between precision and completeness.
- 20% smaller output - less data to process downstream.
- 99% recall maintained - virtually all expected content is still captured, with no page losing recall in our benchmark.
The result: faster scraping, cleaner output, and less unnecessary data.
Content extraction is more precise, output is smaller, and no page lost recall in the benchmark.
🤖 A new AI Mode
AI Mode has been rebuilt to make natural-language data extraction more useful and reliable.
Previously, AI Mode relied on captured lists (based on recorder mode) from the page. It now builds an extraction robot based on your prompt and the data available on the specified page.
Describe the data you want and Maxun builds a reusable robot to extract it.
Once created, the robot can be run repeatedly without making LLM calls on every run, keeping subsequent extractions fast and cost-efficient.
Want more autonomy? Maxun Cloud also offers Agent, which can discover relevant pages and configure websites to find the data you need. We'll continue improving both AI-powered workflows in upcoming releases.
Learn more here: https://docs.maxun.dev/robot/extract/llm-extraction, https://docs.maxun.dev/robot/agent
🕷️ Crawling is faster and cleaner
Crawling is now 77% faster, with our benchmark dropping from 411 seconds to 96 seconds.
We've also reduced duplicate and irrelevant data, so crawls return cleaner, more useful results:
- 100% fewer duplicate links in the output, down from 28% to zero.
- 50% smaller HTML output per page, from 280 KB to 139 KB.
- 16% higher Markdown precision, reducing irrelevant content in extracted pages.
- No duplicate articles in the benchmark, down from 23.
The result: faster crawls, less redundant data, and cleaner output for downstream processing.
📄 Better document extraction
Document Robots are now better at extracting structured data from large and complex files, including PDFs, spreadsheets, CSVs, and DOCX documents.
- More complete results: Preserve document metadata alongside line items and other records.
- Better large-file handling: Recover from truncated model responses and process document chunks in parallel.
- Improved table parsing: Preserve table structure, headers, and row order across file formats.
- More accurate data: Better handling of dates, international number formats, and duplicate records.
In tests with simulated model responses and realistic output limits:
- Invoices: Recovered all 4 header fields and all 60 line items.
- Bank statements: Extracted all 300 transactions, up from 25.
- CSV files: Extracted all 1,500 orders, up from 5 rows.
Document Robots are now substantially more reliable when processing large files and datasets.
🔌 A new MCP server
The previous MCP implementation has been replaced with a new, more capable server that exposes Maxun's core functionality directly to AI assistants and MCP clients.
New one-shot tools include:
maxun_scrape- Scrape a page as Markdown, HTML, text, links, a summary, or screenshots, with optional Smart Queries.maxun_crawl- Crawl a website with configurable scope, depth, and include/exclu
- v0.0.482026-10-01 · 2026-10-01 17:37 UTC
查看更新说明
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.npm install [email protected] 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
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
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 screenshotsmaxun.extract(...): extract data with a plain-English prompt, or with selectorsmaxun.crawl(...): collect content from a whole websitemaxun.search(...): search the web, and optionally scrape the resultsmaxun.documents.extract(...)/.parse(...): read PDF, DOCX, XLSX, CSV, JPG and PNG filesmaxun.robots: list, find and delete any robot on your account
Learn more
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
- v0.0.47v0.0.47 | Website Monitoring 🔥 2026-09-16 · 2026-09-16 22:04 UTC
查看更新说明
🔍 Monitoring
Maxun can now monitor websites in just a few clicks! Track a website over time and get notified when it changes. You can monitor an entire website, or just a specific part of it. It works with Extract, Scrape, and Crawl robots, and is available through the no-code dashboard, the SDK, the CLI, and the API.
Note: Monitoring is opt-in and must be explicitly enabled - existing robots are unaffected.
Learn more here: https://docs.maxun.dev/monitoring
🖼️ JPG & PNG support for document extraction & parsing
Document extract and parse now accept JPG and PNG images as input, in addition to existing supported formats.
What's Changed
- refactor: move nested DisplaySettings component so React does not remount it and lose state on every render by @amhsirak in https://github.com/getmaxun/maxun/pull/1205
- feat: run comparison for Scrape robots (text content) by @jceychen in https://github.com/getmaxun/maxun/pull/1181
- fix: match chip sizes for run status by @amhsirak in https://github.com/getmaxun/maxun/pull/1207
- Fix for Issue1182 by @mbajji in https://github.com/getmaxun/maxun/pull/1203
- Feature - Add JPG/PNG image support with OCR to document robots, Issue #1110 by @joshjyu in https://github.com/getmaxun/maxun/pull/1202
- fix(runs): display current robot names in group headings by @be-student in https://github.com/getmaxun/maxun/pull/1206
- fix(server): authenticate the sockets the backend opens to itself by @VyomVirani in https://github.com/getmaxun/maxun/pull/1211
- fix: centralize run queuing logic by @RohitR311 in https://github.com/getmaxun/maxun/pull/1213
- fix: empty data run due to page navigation by @RohitR311 in https://github.com/getmaxun/maxun/pull/1214
- feat(ui): disable tab ripple globally by @amhsirak in https://github.com/getmaxun/maxun/pull/1216
- fix(ui): improve design consistency across components by @amhsirak in https://github.com/getmaxun/maxun/pull/1209
- feat: monitoring by @amhsirak in https://github.com/getmaxun/maxun/pull/1210
- fix: tabular list highlight and capture by @RohitR311 in https://github.com/getmaxun/maxun/pull/1218
- fix: set
all timeas default search range by @amhsirak in https://github.com/getmaxun/maxun/pull/1219 - fix: use
DEFAULT_OUTPUT_FORMATSas default document parse state by @amhsirak in https://github.com/getmaxun/maxun/pull/1220 - fix: diff display cli monitoring by @RohitR311 in https://github.com/getmaxun/maxun/pull/1221
- feat(i18n): add Azerbaijani (az) translation by @jamalkamaladdin in https://github.com/getmaxun/maxun/pull/1208
- chore: pre-release v0.0.47 by @amhsirak in https://github.com/getmaxun/maxun/pull/1222
New Contributors
- @joshjyu made their first contribution in https://github.com/getmaxun/maxun/pull/1202
- @be-student made their first contribution in https://github.com/getmaxun/maxun/pull/1206
- @VyomVirani made their first contribution in https://github.com/getmaxun/maxun/pull/1211
- @jamalkamaladdin made their first contribution in https://github.com/getmaxun/maxun/pull/1208
Full Changelog: https://github.com/getmaxun/maxun/compare/v0.0.46...v0.0.47
- v0.0.462026-08-25 · 2026-08-25 08:37 UTC
查看更新说明
DOCX Support
Document parsing and extraction now supports DOCX files.
Supported document formats are now: PDF, CSV, XLSX, and DOCX.
Hebrew Language
Maxun can now be used in Hebrew, making it more accessible to Hebrew-speaking users.
What's Changed
- fix: add summary format field doc by @RohitR311 in https://github.com/getmaxun/maxun/pull/1180
- Feat(documents): add DOCX upload and parsing support to document robots by @chunkys0up in https://github.com/getmaxun/maxun/pull/1160
- fix: Proxy Test endpoint reports success even when configured proxy is invalid by @audreydng in https://github.com/getmaxun/maxun/pull/1177
- Fix schedule run state transition by @audreydng in https://github.com/getmaxun/maxun/pull/1186
- fix: validate all webhook urls by @RohitR311 in https://github.com/getmaxun/maxun/pull/1188
- fix: add socket auth by @RohitR311 in https://github.com/getmaxun/maxun/pull/1192
- fix: llm api key url validation by @RohitR311 in https://github.com/getmaxun/maxun/pull/1191
- feat: add Hebrew language support by @vinaypokharkar in https://github.com/getmaxun/maxun/pull/1185
- fix(maxun-core): prevent orphaned crawl loops after timeout (#1183) by @Santosh-Prasad-Verma in https://github.com/getmaxun/maxun/pull/1190
- feat: use carousel instead of scrollbar for search & crawl results by @amhsirak in https://github.com/getmaxun/maxun/pull/1197
- refactor(workflowEnricher): force tool_choice for Anthropic calls by @hmhngx in https://github.com/getmaxun/maxun/pull/1189
- Feat/sdk targeted list limits (list-limits part of issue #1107) by @mbajji in https://github.com/getmaxun/maxun/pull/1176
- Refactor shared robot update helpers for storage and SDK routes by @Reemal786 in https://github.com/getmaxun/maxun/pull/1193
- fix: cleaner run content format by @amhsirak in https://github.com/getmaxun/maxun/pull/1196
- chore: pre-release v0.0.46 by @amhsirak in https://github.com/getmaxun/maxun/pull/1200
New Contributors
- @chunkys0up made their first contribution in https://github.com/getmaxun/maxun/pull/1160
- @Santosh-Prasad-Verma made their first contribution in https://github.com/getmaxun/maxun/pull/1190
- @mbajji made their first contribution in https://github.com/getmaxun/maxun/pull/1176
- @Reemal786 made their first contribution in https://github.com/getmaxun/maxun/pull/1193
Full Changelog: https://github.com/getmaxun/maxun/compare/v0.0.45...v0.0.46
- v0.0.45v0.0.45 2026-08-03 · 2026-08-03 17:28 UTC
查看更新说明
📊 CSV & XLSX Support for Document Parsing
Document Parse and Document Extract now support CSV and XLSX files in addition to PDFs. You can upload spreadsheets directly without needing to convert them to PDFs first.
✨ Document Summaries
Generate AI-powered summaries for PDF, CSV, and XLSX documents, making it easier to quickly understand the contents of large files before extracting structured data.
Learn more: https://docs.maxun.dev/robot/document
What's Changed
- fix: override default MUI icon styles & remove redundant font size overrides by @amhsirak in https://github.com/getmaxun/maxun/pull/1153
- feat: add CSV and XLSX support to document parsing by @jceychen in https://github.com/getmaxun/maxun/pull/1147
- chore(deps): upgrade
sharpto 0.35.3 by @amhsirak in https://github.com/getmaxun/maxun/pull/1156 - feat(byop): move auth proxy setup instructions to docs by @amhsirak in https://github.com/getmaxun/maxun/pull/1154
- chore(deps): externalize
xlsxto cdn by @amhsirak in https://github.com/getmaxun/maxun/pull/1159 - Add API routes to schedule robot runs by @vinaypokharkar in https://github.com/getmaxun/maxun/pull/1150
- feat: link docs proxy status endpoint to byop by @amhsirak in https://github.com/getmaxun/maxun/pull/1164
- Fix: Server and client crash when multiple recordings are discarded in rapid succession by @audreydng in https://github.com/getmaxun/maxun/pull/1162
- fix: enhance document llm post processing by @RohitR311 in https://github.com/getmaxun/maxun/pull/1157
- feat: add summary output format to document parsing (#1106) by @RRRG3 in https://github.com/getmaxun/maxun/pull/1149
- chore: fix deps inconsistency by @RohitR311 in https://github.com/getmaxun/maxun/pull/1161
- fix: validate llm config and centralize model defaults by @RohitR311 in https://github.com/getmaxun/maxun/pull/1166
- fix: clock icon invisible in dark mode by @vinaypokharkar in https://github.com/getmaxun/maxun/pull/1172
- chore: pre-release v0.0.45 by @amhsirak in https://github.com/getmaxun/maxun/pull/1175
New Contributors
- @jceychen made their first contribution in https://github.com/getmaxun/maxun/pull/1147
- @vinaypokharkar made their first contribution in https://github.com/getmaxun/maxun/pull/1150
- @audreydng made their first contribution in https://github.com/getmaxun/maxun/pull/1162
- @RRRG3 made their first contribution in https://github.com/getmaxun/maxun/pull/1149
Full Changelog: https://github.com/getmaxun/maxun/compare/v0.0.44...v0.0.45
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。
Sponsors
What Maxun Does
- Extract – Extract structured data from any website by emulating real user behavior.
- Recorder Mode – Record browser actions and turn them into reusable extraction robots.
- AI Mode – Describe what you need in natural language and extract it with AI.
- Scrape – Convert full webpages into Markdown, HTML and capture screenshots.
- Crawl – Crawl entire websites and extract content across pages.
- Agent – Extract data from websites with AI that autonomously discovers where the data lives.
- Search – Search the web and extract results with time-based filters.
- Monitoring – Track websites over time, detect changes, and get notified when they occur.
- Document Extraction & Parsing – Extract and parse structured data from documents.
How To Use Maxun
- Dashboard – Build, run, and manage robots through Maxun's visual interface.
- API – Integrate Maxun's scraping and extraction capabilities into your applications.
- SDK – Use Maxun programmatically for scraping, extraction, automation and more.
- CLI – Create robots, trigger runs, and retrieve data from your terminal.
- MCP – Connect Maxun to AI agents through the Model Context Protocol.
Quick Start
Getting Started
The simplest & fastest way to get started is to use the hosted version: https://app.maxun.dev.
Installation
Maxun can run locally with or without Docker
Upgrading & Self Hosting
- Self Host Maxun With Docker
- Upgrade Maxun With Docker Compose Setup
- Upgrade Maxun Without Docker Compose Setup
License
Project Values
We believe in fair and responsible use of open source. If you rely on this project commercially, please consider contributing back or supporting its development.
Support Us
Star the repository, contribute to the codebase, or sponsor us.
Contributors
Thank you to the combined efforts of everyone who contributes!