mirror of
https://github.com/getmaxun/maxun.git
synced 2026-10-27 19:27:48 +08:00
feat/mcp-tools
The MCP worker could only list and run existing robots. It now exposes Maxun's core capabilities as one-shot tools, plus run management: - maxun_scrape: scrape one page (markdown, html, text, links, summary, screenshots) with optional smart queries - maxun_crawl: crawl a site with scope, depth, include/exclude paths - maxun_search: web search in discover or scrape mode, with time range - maxun_agent: build an AI-mode extraction robot from a prompt and run it - maxun_cancel_run, maxun_get_run_diff: cancel runs, inspect changes Existing tools are renamed with the maxun_ prefix (get_run_details is now maxun_get_run). One-shot tools reuse a robot when called again with the same arguments, so repeat calls build a run history on one robot. Page content is returned as plain text blocks instead of escaped JSON, API errors now include the server's message, and LLM settings for agent, summary and smart queries are read from MAXUN_LLM_* env variables. The SDK execute endpoint now records runs started with x-run-source: mcp as MCP runs and accepts wait: false to return as soon as the run is queued. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Rx3RjPpi36oz75AQnmUy2N Signed-off-by: Karishma Shukla <karishmashuklaa@gmail.com>
Turn Any Website Into A Structured API
The open-source web data platform for real-time web scraping, crawling, search, monitoring and AI data extraction.
Go To App •
Documentation •
Website •
Discord •
Watch Tutorials
Sponsors
|
|
Webshare 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. Free tier: 10 proxies + 1GB/month · Discount: MAXUN20 - 20% off your first purchase.
|
|
|
Byteful 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.Discount: MAXUN10 - Get 10% off Byteful Residential Proxies.
|
|
|
Thordata – Reliable Proxies for Web Scraping & AI Data Collection offers Residential, Mobile, ISP & Datacenter Proxies · 190+ countries with city-level targeting · Sticky and rotating sessions for flexible workflows · Fast, stable proxy infrastructure for developers. Discount: MAXUN10 - Get 10% off.
|
|
|
Mango Proxy offers Residential, ISP, Datacenter, and Mobile Proxies in 200+ countries with HTTP(S)/SOCKS5 support and flexible IP management. Discount: MAXUN - 8% off Static ISP Proxies.
|
|
|
Nodemaven offers the most efficient proxy provider for Web Scraping and Automation with the Highest Quality IP on the market. Why Nodemaven? · 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! Discounts: MAXUN35 — 35% off Mobile & Residential · MAXUN40 - 40% off ISP (Static)
|
|
|
TestMu AI is the native AI-agentic cloud platform for quality engineering. Test intelligently and ship faster. |
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.
- 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
This project is licensed under AGPLv3.
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!
Languages
TypeScript
93.4%
JavaScript
6.4%