maxun

name	maxun
description	List and run Maxun robots. Use when asked to list robots, run a robot, scrape a website, or get robot results using Maxun.
argument-hint	list | run <robotId> | runs <robotId> | result <robotId> <runId> | get <robotId> | abort <robotId> <runId>
allowed-tools	Bash

Maxun Skill

Maxun is a web scraping platform. The user has robots that scrape websites automatically.

INSTRUCTIONS FOR THE AI MODEL

You have ONE job here: call the Bash tool with the exact command strings below. Do not paraphrase. Do not guess. Copy the command string exactly.

The helper script is at: ${CLAUDE_SKILL_DIR}/scripts/maxun.sh

Before running any command, check that MAXUN_API_KEY is set. If it isn't, tell the user to export it:

export MAXUN_API_KEY="your-api-key-here"

Action: List all robots

When the user says anything like "list my robots", "show robots", "what robots do I have":

Call the Bash tool with this exact command:

bash "${CLAUDE_SKILL_DIR}/scripts/maxun.sh" list

Display the output directly — it IS the robot list. Do not interpret it further.

Action: Run a robot

When the user wants to run or scrape with a specific robot:

Step 1 — List robots first:

bash "${CLAUDE_SKILL_DIR}/scripts/maxun.sh" list

Step 2 — Find the robot ID, then run it:

bash "${CLAUDE_SKILL_DIR}/scripts/maxun.sh" run <robotId>

Action: List past runs

bash "${CLAUDE_SKILL_DIR}/scripts/maxun.sh" runs <robotId>

Action: Get a run result

bash "${CLAUDE_SKILL_DIR}/scripts/maxun.sh" result <robotId> <runId>

Action: Get robot details

bash "${CLAUDE_SKILL_DIR}/scripts/maxun.sh" get <robotId>

Action: Abort a run

bash "${CLAUDE_SKILL_DIR}/scripts/maxun.sh" abort <robotId> <runId>

Error Handling

• No robots found → tell user to create one at https://app.maxun.dev
• Robot still running → poll with result <robotId> <runId>

Setup

Set your Maxun API key:

export MAXUN_API_KEY="your-api-key-here"

For self-hosted Maxun, also set:

export MAXUN_BASE_URL="http://localhost:8080"

Cloud users (app.maxun.dev) do not need MAXUN_BASE_URL — it defaults to the cloud URL. Get your key at: https://app.maxun.dev/settings