Maxun AI Agent

<h3 align="center"> <div> <a href="https://www.maxun.dev/?ref=ghread"> <img src="https://github.com/user-attachments/assets/82cfc163-7772-41d7-b090-6dbf4d6dd5a1" width="100" /> <br> Maxun </a> </div> Turn Any Website Into A Structured API </h3> <p align="center"><b>English</b> | <a href="./README.zh-CN.md">简体中文</a></p> <p align="center"> The open-source web data platform for real-time web scraping, crawling, search, monitoring and AI data extraction. <p align="center"> <a href="https://app.maxun.dev/?ref=ghread"><b>Go To App</b></a> • <a href="https://docs.maxun.dev/?ref=ghread"><b>Documentation</b></a> • <a href="https://www.maxun.dev/?ref=ghread"><b>Website</b></a> • <a href="https://discord.gg/5GbPjBUkws"><b>Discord</b></a> • <a href="https://www.youtube.com/@MaxunOSS?ref=ghread"><b>Watch Tutorials</b></a> <br /> <br /> <a href="https://trendshift.io/repositories/12113" target="_blank"><img src="https://trendshift.io/api/badge/repositories/12113" alt="getmaxun%2Fmaxun | Trendshift" style="width: 200px; height: 40px; margin-top: 5px;" width="200" height="40"/></a> </p>

Sponsors

<table> <tr> <td width="20%" align="center" valign="middle"> <a href="https://www.webshare.io/?referral_code=wwhk524ynls2"> <img src="https://github.com/user-attachments/assets/c3a60969-a8f8-4d2c-acef-22bee80c2484" alt="Webshare" width="240" height="130"> </a> </td> <td width="80%" valign="middle"> <a href="https://www.webshare.io/?referral_code=wwhk524ynls2"><strong>Webshare</strong></a> gives you instant access to a proxy pool of 80M+ ethically-sourced IPs across 195+ countries, with rotating residential, static ISP, and datacenter options plus a full API. It includes a 100+ Gbps backbone, country/city/state/ZIP/ASN-level targeting, and requires no credit card to start. <strong>Free tier:</strong> 10 proxies + 1GB/month · <strong>Discount:</strong> <code>MAXUN20</code> - 20% off your first purchase. </td> </tr> <tr> <td width="20%" align="center" valign="middle"> <a href="https://www.swiftproxy.net/?ref=maxun"> <img src="https://github.com/user-attachments/assets/a1d2309b-d3bd-45e6-8760-ce1f8dcd18b9" alt="Swiftproxy" width="240" height="130"> </a> </td> <td width="80%" valign="middle"> <a href="https://www.swiftproxy.net/?ref=maxun"><strong>Swiftproxy</strong></a> provides 90M+ residential IPs across 220+ locations worldwide, helping Maxun users scrape websites, access geo-restricted content, and collect web data across different regions. Supports rotating and static residential proxies, HTTP(S), and SOCKS5. <strong>Free testing available. </strong><strong>Discount:</strong> <code>PROXY90</code> - 10% off. </td> </tr> <tr> <td width="20%" align="center" valign="middle"> <a href="https://proxy-seller.com/?partner=224ED2B5F5D24719"> <img src="https://github.com/user-attachments/assets/ac862778-464d-49ae-af7e-69712d9b74a4" alt="Proxy-Seller" width="300" height="150"> </a> </td> <td width="80%" valign="middle"> <a href="https://proxy-seller.com/?partner=224ED2B5F5D24719"><strong>Proxy-Seller</strong></a> gives you reliable proxy infrastructure for any workflow: private residential, mobile (4G/5G/LTE), ISP, and datacenter IPv4/IPv6 proxies, all with HTTP(S) and SOCKS5 support. Tap into 47M+ residential IPs across 220+ locations, target exactly the country, city, or ISP you need, and count on 99.7% uptime backed by 24/7 support. <strong>Discount:</strong> <code>MAXUNDEV</code> - Get 15% off. </td> </tr> <tr> <td width="20%" align="center" valign="middle"> <a href="https://byteful.com/?utm_source=github&utm_medium=github-sponsor&utm_campaign=maxun_github_sponsorship"> <img src="https://github.com/user-attachments/assets/f3f7ea4a-a965-4ff9-aab6-8d257da3b18c" alt="Byteful" width="280" height="130"> </a> </td> <td width="80%" valign="middle"> <a href="https://byteful.com/?utm_source=github&utm_medium=github-sponsor&utm_campaign=maxun_github_sponsorship"><strong>Byteful</strong></a> is a UK-based web data infrastructure platform providing ethically sourced residential, mobile, static residential (ISP) and datacenter proxies alongside API-first tools for web scraping, data collection, and AI-driven automation, processing tens of billions of requests per month. <strong>Discount:</strong> <code>MAXUN10</code> - Get 10% off Byteful Residential Proxies. </td> </tr> <tr> <td width="20%" align="center" valign="middle"> <a href="https://mangoproxy.com/?utm_source=github&utm_medium=partner&utm_campaign=getmaxun"> <img src="https://github.com/user-attachments/assets/326b5b8f-6a2c-4aa2-94c8-6a29ae23f2ac" alt="Mango Proxy" width="250" height="130"> </a> </td> <td width="80%" valign="middle"> <a href="https://mangoproxy.com/?utm_source=github&utm_medium=partner&utm_campaign=getmaxun"><strong>Mango Proxy</strong></a> offers Residential, ISP, Datacenter, and Mobile Proxies in 200+ countries with HTTP(S)/SOCKS5 support and flexible IP management. <strong>Discount:</strong> <code>MAXUN</code> - 8% off Static ISP Proxies. </td> </tr> <tr> <td width="20%" align="center" valign="middle"> <a href="https://go.nodemaven.com/maxunreadmeoct"> <img src="https://github.com/user-attachments/assets/de295d94-61f4-4c97-88f8-cd45cbf3af84" alt="Nodemaven" width="420" height="130"> </a> </td> <td width="80%" valign="middle"> <a href="https://go.nodemaven.com/maxunreadmeoct"><strong>Nodemaven</strong></a> offers the most efficient proxy provider for Web Scraping and Automation with the Highest Quality IP on the market. Why <a href="https://go.nodemaven.com/maxunreadmeoct">Nodemaven</a>? · ZIP targeting · 99.9% uptime · IP filtering: all proxies have fraud score <97% · No KYC required · Unique free tools: Proxy Bandwidth Checker, Meta Tag Checker, IP Lookup and others! <strong>Discounts:</strong> <code>MAXUN2X</code> — 2X traffic for Black Friday · <code>MAXUN35</code> — 35% off Mobile & Residential · <code>MAXUN40</code> - 40% off ISP (Static) </td> </tr> <tr> <td width="20%" align="center" valign="middle"> <a href="https://www.testmuai.com/?utm_medium=sponsor&utm_source=maxun"> <img src="https://github.com/user-attachments/assets/6c96005b-85df-43e0-9b63-96aaca676c11" alt="TestMu AI" width="250" height="130"> </a> </td> <td width="80%" valign="middle"> <a href="https://www.testmuai.com/?utm_medium=sponsor&utm_source=maxun"><strong>TestMu AI</strong></a> is the native AI-agentic cloud platform for quality engineering. Test intelligently and ship faster. </td> </tr> </table>

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

1. Setup with Docker Compose
2. Setup without Docker
3. Environment Variables
4. SDK

Upgrading & Self Hosting

1. Self Host Maxun With Docker
2. Upgrade Maxun With Docker Compose Setup
3. Upgrade Maxun Without Docker Compose Setup

License

<p> This project is licensed under <a href="./LICENSE">AGPLv3</a>. </p>

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! <a href="https://github.com/getmaxun/maxun/graphs/contributors"> <img src="https://contrib.rocks/image?repo=getmaxun/maxun" /> </a>